What problem does it solve? Creating a new skill inside the fan-agent repository requires matching strict validator constraints and peer conventions, and mistakes like wrong frontmatter placement or using the wrong creation tool silently produce invalid or misplaced skills. ## Core Features & Use Cases - Validator Rules Reference: Documents the exact frontmatter requirements enforced by tools/skill_manager_tool.py, including the 1024-character description limit and 100,000-character file cap. - Peer-Matched Structure: Provides the standard section layout (Overview, When to Use, Common Pitfalls, Verification Checklist) used by every skill under skills/software-development/. - Workflow Guidance: Covers surveying peer skills, drafting with write_file, local YAML validation, and committing to git, plus pitfalls like the session skill-loader cache. - Use Case: When asked to add a reusable workflow skill to the fan-agent repo on a branch, follow this skill to place the file at skills/<category>/<name>/SKILL.md, validate it locally, and commit it correctly. ## Quick Start Create a new in-repo skill for the fan-agent repository following the authoring conventions and validator rules.