Skill Builder

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

Updated Jul 16, 2026
One-click install
npx skills add https://github.com/optimaxin/Tredev_Gems --skill skill-builder-optimaxin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Skill Builder
Source: https://github.com/optimaxin/Tredev_Gems/tree/main/.claude/skills/skill-builder
Command: npx skills add https://github.com/optimaxin/Tredev_Gems --skill skill-builder-optimaxin

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 your skill. ## Core Features & Use Cases - Specification Reference: Provides the complete SKILL.md specification including required name and description fields, character limits, and YAML formatting rules. - Progressive Disclosure Guidance: Explains the 3-level architecture (metadata, SKILL.md body, referenced files) so skills scale without context bloat. - Ready-to-Use Templates: Includes 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 validate it against the checklist before publishing. ## Quick Start Ask Claude to create a new skill called 'api-docs-generator' with proper frontmatter and a quick start section using the Skill Builder templates.

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 custom 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 activates.

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 invoke it. Additional fields are ignored by Claude.

Can Claude Code skills be nested in subdirectories?

No, Claude Code does not support nested skill directories or namespaces. Each skill must sit directly under ~/.claude/skills/[skill-name]/ for personal skills or .claude/skills/[skill-name]/ for project skills.

What is progressive disclosure in Claude Skills?

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

Why is my Claude skill not being detected?

Common causes include missing or malformed YAML frontmatter, placing the skill in a nested subdirectory instead of directly under the skills folder, or YAML parse errors from unquoted special characters like colons in the name field.