skill-builder

Create a Claude Skill by following a structured workflow: gather requirements, craft a discoverable description using proven formulas, validate naming conventions (lowercase, hyphens, max 64 chars), plan your file structure, implement with proper YAML frontmatter, and test activation triggers. This ensures your skill activates precisely when users search for it.

Write skill descriptions under 1024 characters following a clear pattern: state what the skill does, when to use it, and trigger terms users would search for. This formula ensures Claude activates your skill at the right moment and makes it discoverable through natural language queries.

Claude Skills require lowercase names with hyphens only (max 64 characters), proper YAML frontmatter with opening/closing delimiters and no trailing spaces, optional tool restrictions for security, and organized multi-file structures. These constraints ensure skills activate reliably and follow best practices.

Yes. Validate your YAML frontmatter syntax, check naming constraints (lowercase, hyphens, length), review your description for clear trigger terms and when-to-use patterns, and test against Claude's activation logic. Following the phase-driven validation workflow identifies and resolves activation failures.

Plan your skill structure by defining components upfront, organizing related logic into separate files, applying tool restrictions where needed for security, and documenting each file's role. This approach keeps complex skills maintainable and prevents common design pitfalls.