Skill Best Practices

Enforce YAML frontmatter and lean SKILL.md structure for Claude Code skills.

Updated Aug 27, 2026

Search Tags:#documentation #quality #best-practices #skill-development #SKILL.md #frontmatter #trigger-phrases

Ready to run

npx skills add https://github.com/Within-7/minto-plugin-tools --skill skill-best-practices

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: Skill Best Practices
Source: https://github.com/Within-7/minto-plugin-tools/tree/main/skill-optimizer/skills/skill-best-practices
Command: npx skills add https://github.com/Within-7/minto-plugin-tools --skill skill-best-practices

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill provides a prescriptive blueprint for creating high-quality Claude Code skills, ensuring consistent structure, triggers, and documentation across projects.

Core Features & Use Cases

Enforces YAML frontmatter with required fields (name, description) and optional version.
Promotes progressive disclosure: lean SKILL.md body with additional details in references/ for deeper topics.
Establishes robust trigger phrase patterns and domain-aware guidance for reliable skill activation.
Provides templates and quality guidelines to accelerate skill development and maintenance.

Quick Start

Create a new skill folder with SKILL.md and references/; fill the body with core guidance and link to references for deeper topics.

Frequently Asked Questions about Skill Best Practices

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I structure a SKILL.md file for Claude Code skill development?▼

Structure SKILL.md by starting with YAML frontmatter containing required name and description fields, followed by a lean body that links to references for deeper topics to enforce progressive disclosure.

What are best practices for writing trigger phrases in Claude Code skills?▼

Trigger phrases should use robust patterns and domain-aware guidance to ensure reliable skill activation, matching specific domain vocabulary to consistently trigger the intended automation workflows.

How do I organize documentation to maintain quality when building Claude Code skills?▼

Organize documentation by keeping the SKILL.md body lean and moving detailed content into a linked references directory, enforcing progressive disclosure for consistent structure and maintainability.

What validation checks should I apply to standardize skill creation?▼

Apply validation checks to ensure YAML frontmatter includes required fields, trigger phrases follow established patterns, and linked references are consistently implemented across the skill folder.

Can I use progressive disclosure to manage large skill documentation?▼

Progressive disclosure manages large documentation by keeping the SKILL.md body lean and routing deeper technical topics to a references directory, ensuring the core trigger logic remains maintainable.

What is the best way to create a new Claude Code skill from scratch?▼

Create a new skill folder containing SKILL.md and a references directory, fill the frontmatter with required fields, and populate the body with core guidance linked to reference files.