zedclaw-skill-authoring

What problem does it solve?

Guides contributors to create or update valid ZedClaw Skill units by writing correct SKILL.md files with the required YAML frontmatter and repository structure.

Core Features & Use Cases

• Validator-aligned SKILL.md authoring: Ensures the frontmatter starts and closes exactly as required and includes mandatory name/description fields.
• Peer-matched structure templates: Recommends a consistent section layout (Overview, When to Use, Pitfalls, Verification Checklist) that fits existing skills.
• Correct in-repo placement workflow: Clarifies where committed skills live under skills/<category>/<name>/SKILL.md versus user-local skills under ~/.zedclaw/skills/, and when to use write_file vs skill_manage.
• Quality and size guardrails: Enforces description limits and keeps skills within practical size ranges, suggesting references/ for long content.

Quick Start

Use this skill guide to add a new in-repo skill by creating skills/<category>/<name>/SKILL.md with compliant frontmatter, then validate its YAML and section requirements before committing.