ClawHub

Improve Doc

v1.0.0

Analyze and improve existing documentation using Diataxis principles

⭐ 0· 60·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
high confidence
✓
Purpose & Capability
The skill's name/description (improve markdown docs using Diataxis) aligns with its runtime instructions: it reads a target markdown file, classifies sections, identifies issues, and proposes edits. Requiring or installing nothing else is proportionate.
ℹ
Instruction Scope
The instructions explicitly read a user-supplied file path and parse the document — which is necessary for the stated purpose. They also instruct the agent to 'load' related beagle-docs skills (docs-style, tutorial-docs, etc.) for refinement; this is coherent for modular editing but means those other skills will be invoked at runtime and should be reviewed separately. The SKILL.md contains example shell snippets (git clone, npm install) as proposed doc content, not as actions the skill itself runs.
✓
Install Mechanism
Instruction-only skill with no install spec and no code files; nothing is written to disk by the skill itself during install.
✓
Credentials
The skill declares no required environment variables, credentials, or config paths. Its file access is limited to the markdown path supplied by the user, which is appropriate for the task.
✓
Persistence & Privilege
The skill is not always-enabled and explicitly sets disable-model-invocation: true (no autonomous invocation), reducing risk. It does not request persistent system-wide changes or access to other skills' configuration.
Assessment
This skill appears to do what it claims: read a markdown file you point it at and propose Diataxis-style improvements. Before using it, consider: (1) run it on a copy of your document if you are worried about accidental edits; (2) the skill will attempt to load other beagle-docs skills at refinement time — review those skills separately because they may request their own permissions or capabilities; (3) example shell commands shown in the proposed edits are for inclusion in the document, not commands the skill will execute. The disable-model-invocation flag reduces autonomous risk.

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

latestvk973qfzm9abpq4ghaeex3k79jh84jt05

License

MIT-0
Free to use, modify, and redistribute. No attribution required.
Termshttps://spdx.org/licenses/MIT-0.html

Comments