Polish a skill's SKILL.md for ClawHub readability without sacrificing LLM effectiveness. Use when improving a skill's listing, making a skill look better on ClawHub, or preparing a skill for publish. Rewrites SKILL.md with better formatting, then audits the changes to ensure nothing the LLM needs was lost. Moved content goes to references/ — never deleted.
Improve a skill's SKILL.md for ClawHub readability. Run after the skill is built and tested — never before.
Readability supports these goals. Never sacrifice clarity for aesthetics.
1. Read the existing SKILL.md
2. Rewrite for readability (apply rules from references/)
3. Audit the rewrite against the original
4. Output: polished SKILL.md + audit report + any new reference files
Ensure the skill is:
quick_validate.pyIf any of these fail, fix them first. Don't polish a broken skill.
Read references/rules.md for the full set of formatting rules.
Key principles:
Content that's valuable but doesn't belong in the storefront:
Rule: Content is moved, never deleted. Every reference file must be valid and useful.
After rewriting, compare the original against the polished version. Flag:
⚠ Potentially risky changes:
• Security notes removed
• Credential instructions lost
• Implementation details dropped without a reference file
• Trigger phrases removed from description
• Reference files created but empty or incomplete
See references/audit-guide.md for the full audit checklist.
Present three things to the user:
Wait for user approval before overwriting the original.
This skill polishes existing skills. Use the built-in skill-creator to build skills from scratch. Polish after building, not during.