Draft Docs

v1.0.0

Generate first-draft technical documentation from code analysis

0· 63·1 current·1 all-time
byKevin Anderson@anderskev
MIT-0
Download zip
LicenseMIT-0 · Free to use, modify, and redistribute. No attribution required.
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
medium confidence
Purpose & Capability
The name and description (generate first-draft docs from code) align with the actions the skill instructs: scanning repository files, extracting symbols, creating markdown drafts, and moving them into docs. It does not request unrelated binaries, environment variables, or external credentials.
Instruction Scope
The runtime instructions perform file-system and git operations (ls, mkdir, mv, git diff, reading/writing docs/navigation.json) which are expected for a documentation-generation tool. One notable point: the skill instructs the agent to "Always load" other skills (beagle-docs:docs-style, reference-docs, howto-docs); loading other skills can broaden runtime behavior depending on those skills' instructions/privileges. Also, it will read lots of repository files (including recent changes) which is appropriate for the task but could surface sensitive code snippets if present.
Install Mechanism
This is an instruction-only skill with no install spec and no downloads — minimal install risk. No archives, external URLs, or package installs are requested.
Credentials
The skill requests no environment variables, credentials, or config paths. Its file and git access is proportionate to generating documentation and publishing it inside the repository.
Persistence & Privilege
always:false (default) and disable-model-invocation:true reduce autonomous or background privileges. The skill does instruct modifying repository files (creating drafts, moving files, and updating navigation.json) which is reasonable for its purpose but means it will write to the repo; users should ensure they are comfortable with that level of file modification.
Assessment
This skill appears to do what it says: it scans the repository, creates draft markdown files in docs/drafts/, and can move them into your docs and update navigation.json. Before installing or running it, consider: 1) It will read many files and git history in your repo — review generated drafts before publishing to avoid accidental disclosure of sensitive code or internal notes. 2) The skill loads other beagle-docs skills (docs-style, reference-docs, howto-docs); verify you trust those skills too because they will affect output and behavior. 3) It will modify files (create/move and edit navigation.json); run it in a safe branch or ensure you have commits/backups so you can review and revert changes. 4) Note disable-model-invocation is set; if outputs seem missing or truncated, that flag may affect how the agent composes drafts — verify behavior in a test run. If you want higher assurance, inspect a sample run in a disposable branch and confirm the referenced helper skills are trustworthy.

Like a lobster shell, security has layers — review code before you run it.

latestvk97dwavy3e36t48vn9fy9jtsk184ktwb

License

MIT-0
Free to use, modify, and redistribute. No attribution required.

Comments