skills.rest
dmuhoro
dmuhoroCOMMUNITY
Explore all skills by this author →
GitHub

Skill Builder

Create Claude Code Skills with YAML frontmatter and progressive disclosure structure.

Updated Mar 25, 2026
Search Tags:#templates#claude code#skill creation#ai agents#progressive disclosure#skill.md#yaml frontmatter
One-click install
npx skills add https://github.com/dmuhoro/EasyTutor --skill skill-builder-dmuhoro
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Skill Builder
Source: https://github.com/dmuhoro/EasyTutor/tree/main/archive/.claude/skills/skill-builder
Command: npx skills add https://github.com/dmuhoro/EasyTutor --skill skill-builder-dmuhoro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building custom Claude Code Skills requires knowing the exact SKILL.md format, YAML frontmatter rules, and directory conventions, and mistakes in any of these prevent Claude from discovering or loading the skill. ## Core Features & Use Cases - Specification Reference: Documents the required name and description frontmatter fields, character limits, and formatting rules for valid SKILL.md files. - Progressive Disclosure Guidance: Explains the 3-level loading architecture (metadata, SKILL.md body, referenced files) so skills scale without context bloat. - Ready-to-Use Templates: Provides basic, intermediate, and advanced skill templates plus real-world examples for documentation and code generation skills. - Use Case: You want to build a custom skill that generates API documentation for your team. Use this Skill to scaffold the directory, write a compliant SKILL.md with proper frontmatter, and organize scripts and resources correctly. ## Quick Start Ask Claude to create a new skill called 'api-docs-generator' with proper frontmatter and directory structure using the skill-builder guidelines.

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 Code Skill?▼

Create a directory directly under ~/.claude/skills/ or .claude/skills/ in your project, then add a SKILL.md file with YAML frontmatter containing name and description fields. The markdown body below the frontmatter holds the instructions Claude loads when the skill triggers.

What fields are required in SKILL.md frontmatter?▼

Only two fields are required: name (maximum 64 characters) and description (maximum 1024 characters). The description should state both what the skill does and when Claude should use it. Additional fields are ignored by Claude.

Where should Claude skills be placed in a project?▼

Skills must sit directly under ~/.claude/skills/ for personal use or .claude/skills/ at the project root for team-shared skills. Nested subdirectories or namespaces are not supported, so each skill directory must be top-level.

Why is my Claude skill not being detected?▼

Detection usually fails because the SKILL.md is missing, the YAML frontmatter has syntax errors such as unquoted special characters, or the directory is nested instead of top-level. Restart Claude Code after fixing these issues.

What is progressive disclosure in Claude skills?▼

Progressive disclosure is a 3-level loading system: name and description load at startup, the SKILL.md body loads when the skill triggers, and referenced files load only on demand. This lets you install many skills with minimal context usage.

Related Skills

Explore More Software Engineering Skills→
astrovilleastroville

convention-writing

Analyzes codebases for recurring patterns and writes standardized convention specs.

Official
Intermediate
mahidalhanmahidalhan
34

publish-skill

Publish and port skills to a claude-hacks marketplace repository.

Community
Intermediate
TorchedHatTorchedHat
6

run-inside-test

Executes a bundled test script and reports its exact output.

Official
Basic
carlo-spadacarlo-spada

claude-code-features

Explain Claude Code extensibility features including skills, slash commands, hooks, MCP servers, and CLAUDE.md.

Community
Basic