Create, edit, and validate Skills documentation with YAML frontmatter.
npx skills add https://github.com/lightxue/dotfiles --skill writing-skills-lightxue
Please help me install this Agent Skill. Skill: writing-skills Source: https://github.com/lightxue/dotfiles/tree/main/agent/skills/writing-skills Command: npx skills add https://github.com/lightxue/dotfiles --skill writing-skills-lightxue
Skill authors face inconsistent guidance and untested documentation when creating or updating Skills. This section provides a concise, frontmatter-driven blueprint to ensure every Skill is discoverable, well-structured, and verifiable before deployment.
Create a new SKILL.md with a name and a description that starts with Use when..., then implement a minimal example to verify the workflow.
High-intent search queries and answers about installing and using this skill.
Create and validate Skills by drafting a SKILL.md file with required YAML frontmatter, then applying a RED-GREEN-REFACTOR testing workflow to verify behavior under realistic trigger scenarios before deployment.
Structure YAML frontmatter by including required name and description fields, keeping the description under 1024 characters and starting with Use when... to ensure concise, trigger-focused content for optimal Skill discovery.
Writing Skills requires no external dependencies or frameworks, only a SKILL.md file with valid YAML frontmatter and optional references, assets, or scripts added progressively as needed for validation.
The RED-GREEN-REFACTOR approach validates Skill behavior by first writing a failing test for a trigger scenario, implementing the minimal Skill logic to pass it, then refactoring the documentation for clarity and discoverability.
You can add optional references, assets, and scripts to a SKILL.md file as needed, keeping core guidance lightweight through progressive disclosure while linking to heavy external resources for validation.
Skill discovery fails when the YAML frontmatter lacks a concise, trigger-focused description starting with Use when..., or when the description exceeds the 1024 character limit required for consistent indexing.
troykellyGuide creation of Claude Code plugin skills with SKILL.md structure.
githubAutomate iterative evaluation and refinement of AI agent outputs with JSON feedback.
jwintzSanitize Obsidian vault frontmatter by fixing unescaped quotes and malformed YAML.
AlphaLab-USTCCreate, edit, and verify SKILL.md documentation with RED-GREEN-REFACTOR validation.
