← Back to Skills Marketplace
brad-sl

Reference Maintainer

by brad-sl · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
67
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install reference-maintainer
Description
Automation skill for Reference Maintainer.
Usage Guidance
This skill appears to be what it says: a documentation generator that parses source files and writes docs. Before installing or running it, review the included scripts (noted issues: reference_updater.py has a hard-coded default target 'sentiment_decay_model.py' and an indentation bug that may break execution). Important cautions: 1) Run it only on copies or non-sensitive repositories — the tool will read source files and persist extracted configuration (which can include secrets) into references/ and a log file. 2) Limit the paths you pass to the tool and inspect generated output before sharing. 3) If you plan to let an agent invoke this skill autonomously, restrict its file-system access to safe directories. If you want, I can point out the exact lines to change to avoid the hard-coded default and to inspect/escape potential secret-like values before writing them.
Capability Analysis
Type: OpenClaw Skill Name: reference-maintainer Version: 1.0.0 The skill bundle is designed as a system documentation generator but explicitly instructs the AI agent to extract and include 'credentials' in the generated reference docs (SKILL.md and references/templates/schema.yaml). While the Python scripts (scripts/universal_doc_generator.py) use standard AST parsing to extract configurations, the directive to harvest secrets and store them in 'living reference docs' for session persistence is a high-risk behavior that facilitates credential harvesting. No explicit exfiltration logic or remote endpoints were identified, suggesting this may be a misguided 'expert memory' feature rather than a targeted attack, but it remains highly irregular and dangerous.
Capability Assessment
Purpose & Capability
Name/description match the included Python scripts and templates. The code implements AST/JSON/YAML extraction and generates Markdown/YAML/JSON documentation as advertised. There are no extraneous credentials, binaries, or network calls that contradict the stated purpose.
Instruction Scope
SKILL.md and the scripts instruct the agent to parse source files and generate documentation. That is in-scope for a documentation generator, but the code will read arbitrary files you point it at (or the default target in reference_updater.py) and persist extracted config data (including anything that looks like credentials) into references/ and doc_generator.log. Review and restrict the files/paths you allow the skill to access to avoid accidental collection/persistence of secrets.
Install Mechanism
No install spec — instruction-only plus included scripts. No packages are downloaded or executed from remote URLs. This minimizes install-time risk.
Credentials
The skill declares no required environment variables, credentials, or config paths. The code also does not read environment variables or request external credentials. However, it can extract and persist data from any file it is pointed at, so secrets in source files could be collected as part of normal operation.
Persistence & Privilege
The skill writes output files under references/ and creates a local log file (doc_generator.log) in the working directory. It does not request persistent agent-level privileges or modify other skills. Consider filesystem write implications before running in sensitive directories.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install reference-maintainer
  3. After installation, invoke the skill by name or use /reference-maintainer
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Universal doc generator prevents AI 'new hire syndrome' via auto-updating refs/schemas. Works on any code/system.
Metadata
Slug reference-maintainer
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Reference Maintainer?

Automation skill for Reference Maintainer. It is an AI Agent Skill for Claude Code / OpenClaw, with 67 downloads so far.

How do I install Reference Maintainer?

Run "/install reference-maintainer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Reference Maintainer free?

Yes, Reference Maintainer is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Reference Maintainer support?

Reference Maintainer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Reference Maintainer?

It is built and maintained by brad-sl (@brad-sl); the current version is v1.0.0.

💬 Comments