skills.rest
Cornjebus
CornjebusCOMMUNITY
Explore all skills by this author →
GitHub

Skill Builder

Create Claude Code Skills with YAML frontmatter and directory structure.

1|Updated Nov 13, 2025
Search Tags:#skill development#claude skills#tooling#metadata#skill template#progressive disclosure#skill builder
One-click install
npx skills add https://github.com/Cornjebus/amair --skill skill-builder-cornjebus
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Skill Builder
Source: https://github.com/Cornjebus/amair/tree/main/.claude/skills/skill-builder
Command: npx skills add https://github.com/Cornjebus/amair --skill skill-builder-cornjebus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill simplifies the process of creating new Claude Code Skills, ensuring they adhere to the official specification for proper discovery, progressive disclosure, and optimal performance without context penalties. It empowers users to build custom, high-quality AI tools.

Core Features & Use Cases

  • YAML Frontmatter Guidance: Ensures correct name (max 64 chars) and description (max 1024 chars) with "what" and "when" clauses for autonomous skill matching.
  • Directory Structure Enforcement: Guides on creating the correct top-level skill directory structure for personal and project-specific skills.
  • Progressive Disclosure Architecture: Explains the 3-level system (metadata, SKILL.md body, referenced files) to manage context efficiently for 100+ skills.
  • Content Best Practices: Provides guidelines for writing effective descriptions, structuring SKILL.md, and using scripts/resources.
  • Validation Checklist: Offers a comprehensive checklist to verify YAML, file structure, content quality, and progressive disclosure before publishing.
  • Use Case: A developer wants to create a custom skill to automate their specific code generation workflow. They use Skill Builder to structure their SKILL.md, define its metadata, and organize supporting scripts and templates, ensuring Claude can discover and use it effectively.

Quick Start

Create your skill directory (e.g., at ~/.claude/skills/my-first-skill): mkdir -p ~/.claude/skills/my-first-skill Create SKILL.md with the required YAML frontmatter: cat > ~/.claude/skills/my-first-skill/SKILL.md << 'EOF'

name: "My First Skill" description: "Brief description of what this skill does and when Claude should use it."

My First Skill

What This Skill Does

[Your instructions here] EOF

Frequently Asked Questions about Skill Builder

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

FAQPage Schema
How do I create a Claude Skill with proper YAML frontmatter?▼

Create a SKILL.md file in your skill directory with YAML frontmatter containing exactly two required fields: `name` (max 64 characters) and `description` (max 1024 characters). The description should include both what the skill does and when Claude should use it for autonomous discovery.

What directory structure do I need for a Claude Skill?▼

Place your skill at the top level under ~/.claude/skills/[skill-name]. Include SKILL.md with frontmatter at the root, then optionally add subdirectories for docs, scripts, resources, and tests to organize supporting files and maintain progressive disclosure.

What is progressive disclosure in Claude Skills?▼

Progressive disclosure is a 3-level architecture that manages context efficiently: metadata in YAML frontmatter (level 1), core content in SKILL.md body (level 2), and detailed information in referenced files (level 3). This design lets Claude handle 100+ skills without context penalties.

How do I ensure my custom skill meets Claude's specification?▼

Follow the validation checklist: verify YAML syntax and required fields, confirm top-level directory placement under ~/.claude/skills, check SKILL.md structure matches guidelines, validate description clarity and scope, and confirm progressive disclosure principles across metadata, body, and referenced files.

Can I use scripts and templates within a Claude Skill?▼

Yes. Organize supporting scripts, templates, and resources in subdirectories within your skill folder. Reference them in SKILL.md using progressive disclosure—only load or mention them when needed—so Claude discovers and uses them efficiently without loading unnecessary content.

Why should I structure skills for autonomous discovery?▼

Proper YAML metadata with clear "what" and "when" clauses enables Claude to automatically match your custom skill to user requests across Claude surfaces. Correct structure and progressive disclosure ensure the skill performs optimally without consuming excess context budget.

Related Skills

Explore More Software Engineering Skills→
praburajasekaranpraburajasekaran

create-agent-skills

Create Claude Code skills and slash commands with YAML frontmatter and markdown content.

Community
Advanced
Delqhi-ProjectsDelqhi-Projects
3

Skill Development

Creates structured SKILL.md files with frontmatter and bundled resources for Claude Code plugins.

Official
Advanced
mikersaysmikersays

plan-init

Create a project planning directory with YAML frontmatter and markdown files.

Community
Basic
sauvalasauvala

skill-development

Create Claude Code plugin skills with structured metadata and progressive disclosure.

Community
Advanced