guid-skill-creation

Create a Claude Code skill by starting with YAML frontmatter containing name, description, and model fields at the top of your SKILL.md file. Follow the official format under guideline/shipped-skills, then add progressive loading levels: Level 1 metadata, Level 2 core patterns, and optional Level 3 resources.

Progressive loading structures skills in three levels: Level 1 provides metadata for discovery, Level 2 contains main patterns and workflows, and Level 3 offers optional resources like references and examples. This enables efficient skill consumption and scaling across teams.

Document patterns as Claude Code skills when you have reusable workflows, library conventions, or project-specific approaches worth sharing across codebases and teams. The skill format with Guild system integration makes them discoverable and standardized for consistent adoption.

Use Guild naming conventions with guid- prefixed skill identifiers to ensure consistent organization and reuse. Structure your skill directory under guideline/shipped-skills with metadata-driven filenames like SKILL.md, DOCS.md, REFERENCE.md, and EXAMPLES.md as appropriate.

Yes, Claude Code skills are designed for team-wide pattern documentation with metadata-driven discovery via YAML frontmatter. The standardized structure and Guild system integration enable consistent sharing of reusable workflows and conventions across your organization's codebases.

Start with SKILL.md containing mandatory YAML frontmatter (name, description, model) and core content. Optionally add DOCS.md for extended documentation, REFERENCE.md for detailed specifications, and EXAMPLES.md for use cases. Progressive loading allows you to add resources incrementally.