Skill Builder

Create Claude Code Skills with YAML frontmatter and directory structure.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill simplifies the creation of new Claude Code Skills by guiding users through the proper structure, YAML frontmatter, and progressive disclosure architecture. It eliminates the guesswork in skill development, ensuring that custom skills are correctly formatted for autonomous discovery and use by Claude, saving development time.

Core Features & Use Cases

  • YAML Frontmatter Validation: Ensures correct name and description for optimal skill matching.
  • Progressive Disclosure Architecture: Structures skills for efficient context loading, preventing context penalties.
  • Directory Organization: Guides on setting up scripts/, resources/, and docs/ for full-featured skills.
  • Use Case: Quickly generate a new skill template for a "README Generator" that includes a scripts/ directory for execution and resources/templates/ for customizable sections, ensuring it's discoverable and usable by Claude.

Quick Start

Create a new skill directory and SKILL.md file: mkdir -p ~/.claude/skills/my-first-skill 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. Maximum 1024 characters."

My First Skill

What This Skill Does

[Your instructions here]

Quick Start

[Basic usage] 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 and directory structure?

Create a Claude Skill by setting up a directory under ~/.claude/skills with a SKILL.md file containing required YAML frontmatter (name and description fields), then organize supporting files into scripts/, resources/, and docs/ folders. This structure ensures Claude discovers and loads your skill efficiently.

What's the correct format for YAML frontmatter in a Claude Skill?

YAML frontmatter requires two fields: name (skill identifier) and description (maximum 1024 characters explaining when Claude should use it). Place frontmatter between --- delimiters at the top of SKILL.md, followed by markdown documentation.

How does progressive disclosure architecture prevent context penalties in custom skills?

Progressive disclosure structures skills so Claude loads only necessary information initially, deferring detailed content to secondary sections. This reduces context token consumption and prevents performance degradation when Claude retrieves and executes your skill.

Can I use templates and validation when building reusable Claude Skills?

Yes, Skill Builder automates template scaffolding and validates YAML compliance, enabling teams to generate production-ready skills quickly with consistent formatting across multiple skill projects.

What directory layout should I use for a full-featured Claude Skill?

Organize skills with optional scripts/ for executable logic, resources/ for customizable templates and data, docs/ for extended documentation, and tests/ for validation. This layout makes skills discoverable and maintainable across Claude.ai, Claude Code, SDKs, and API integrations.