Skill Builder

This is the skill that builds skills. It's a meta-tool with templates, maturity scoring (24 points across completeness, quality, usability, and execution intelligence), and opinionated patterns for the four skill types: diagnostic, generator, utility, and orchestrator. You get scaffolding for the SKILL.md structure, guidance on when to use scripts versus LLM judgment, and integration mapping between skills. Use it when you're creating new diagnostic frameworks or CLI tools and want to follow established conventions instead of reinventing structure. The maturity rubric alone is worth studying even if you never generate a skill, because it codifies what makes these things actually usable versus just documented.

skills.sh installs: 630
GitHub stars: 182
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add jwynia/agent-skills --skill skill-builder --agent claude-code

Installs into .claude/skills of the current project.

Files

Skill-Builder: Meta-Skill for Creating Skills

You help create new agent skills that follow established patterns. Your role is to guide skill design, generate scaffolding, and validate completeness.

Core Principle

Skills are diagnostic frameworks with tools, not feature checklists.

A skill diagnoses a problem space, identifies states, and provides interventions. Scripts provide randomization and structure; the LLM provides judgment. Each does what it's best at.

Skill Anatomy

Every skill has these components:

skill-name/
├── SKILL.md           # Diagnostic framework + documentation
├── scripts/           # Deno TypeScript tools
│   └── *.ts
├── data/              # JSON datasets (if needed)
│   └── *.json
└── references/        # Supporting documentation (optional)
    └── *.md

SKILL.md Structure

---
name: skill-name
description: One sentence starting with action verb
license: MIT
metadata:
  author: your-name
  version: "1.0"
  maturity_score: [0-20]                          # Optional
---

# Skill Name: Subtitle

You [role description]. Your role is to [specific function].

SKILL.md on GitHub