authoring-skills

Create a Skill by writing a SKILL.md file at the root using gerund naming (e.g., authoring-skills), lowercase-hyphen formatting, and third-person narration. Include a short name, description, trigger conditions, and organize supporting files like REFERENCE/ and EXAMPLES/ for progressive disclosure and discoverability.

Use gerund form (verb-ing) in lowercase with hyphens, avoid reserved words, and ensure names are descriptive of the action performed. This standardized approach improves discoverability and makes Skills easier to find and understand across the platform.

Organize your Skill with a SKILL.md file containing core metadata, optional REFERENCE/ and EXAMPLES/ subdirectories, and progressive disclosure—layering simple overviews with detailed guidance. This modular structure helps users find what they need without friction.

A SKILL.md includes the Skill name, concise description, explicit trigger conditions, validation templates, and guidance on file organization. These elements ensure consistent, high-quality artifacts that are both discoverable and usable for Claude Agent workflows.

Use the Skill's quality check templates to verify gerund naming, lowercase-hyphen formatting, third-person narration, explicit trigger definitions, and modular file structure. Validation ensures your Skill meets standardized guidelines for discoverability and consistency.

Yes, the Skill addresses refining existing Skills by applying naming conventions, restructuring documentation with progressive disclosure, validating trigger conditions, and reorganizing files into a modular format to improve clarity and usability.