skill-writer

Writing a valid SKILL.md file requires matching the folder name to the name field and including a description with clear trigger phrases and a “Use when…” clause to ensure proper discovery and validation.

Skills fail to trigger when the directory name and YAML name field mismatch or lack trigger specificity. Troubleshoot by verifying directory formatting and improving description trigger phrases for successful skill discovery.

The correct format requires a name field matching the folder name and a description within limits that includes both what it does and when to use it. This structure ensures discovery readiness.

Yes, you can convert existing workflows into structured Claude Code skills by authoring a SKILL.md file with actionable step-by-step operational instructions and valid YAML frontmatter for personal or project use.

To avoid creating an overly broad mega-skill, define one specific capability per skill during the skill scope design phase. This ensures focused operational instructions and reliable trigger behavior.

No specific components or dependencies are required. You only need to write a SKILL.md file adhering to structural constraints and YAML frontmatter validation rules for successful skill creation.