skill-publisher-claw-skill

A Claw skill and toolkit for preparing skills for public release.

Tools

Quick Start

Check a skill before publishing

./audit.sh /path/to/skill

Fix common issues automatically

./fix.sh /path/to/skill        # Interactive
./fix.sh /path/to/skill --auto # Automatic

Create a new skill

./scaffold.sh my-new-skill

Publish in one command

./publish.sh /path/to/skill

Get quality score

./score.sh /path/to/skill

The Checklist

Every skill is checked against:

1. STRUCTURE — Required files, logical organization
2. SECURITY — No secrets, keys, PII
3. PORTABILITY — No hardcoded paths
4. QUALITY — No debug code, clean formatting
5. DOCS — README, SKILL.md, examples
6. TESTING — Verified functionality
7. GIT — Clean history, .gitignore
8. METADATA — License, description

Templates

templates/
├── SKILL.template.md      # Skill entry point template
├── README.template.md     # GitHub readme template
├── LICENSE.template       # MIT license
├── gitignore.template     # Standard .gitignore
├── pre-commit-hook        # Git hook for security
└── github-actions/
    └── skill-audit.yml    # CI workflow

Install pre-commit hook

cp templates/pre-commit-hook /path/to/skill/.git/hooks/pre-commit
chmod +x /path/to/skill/.git/hooks/pre-commit

Add CI to your skill

mkdir -p /path/to/skill/.github/workflows
cp templates/github-actions/skill-audit.yml /path/to/skill/.github/workflows/

Documentation

• docs/versioning.md — Semantic versioning guide
• docs/deprecation.md — How to sunset a skill

Quality Grades

Example Workflow

# 1. Create new skill
./scaffold.sh my-awesome-skill
cd my-awesome-skill
 
# 2. Edit content
vim SKILL.md
vim README.md
 
# 3. Check quality
../score.sh .
 
# 4. Fix any issues
../fix.sh .
 
# 5. Validate links
../validate-links.sh .
 
# 6. Publish
../publish.sh .

License

MIT

Resources

• ClawdHub - Skill marketplace
• Claw Docs - Main documentation
• GitHub Issues - Report bugs