skills.rest
gh-xj
gh-xjCOMMUNITY
Explore all skills by this author →
GitHub

skill-builder

Create and structure Claude skills with SKILL.md frontmatter and optional folders.

Updated Aug 23, 2026
Search Tags:#documentation#Claude#build#structure#refactor#best-practices#skill-builder
One-click install
npx skills add https://github.com/gh-xj/claude-skills --skill skill-builder-gh-xj
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-builder
Source: https://github.com/gh-xj/claude-skills/tree/main/.claude-plugin/skills/skill-builder
Command: npx skills add https://github.com/gh-xj/claude-skills --skill skill-builder-gh-xj

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Skill-builder provides a practical, scalable framework for creating and maintaining high-quality Claude skills. It helps teams structure knowledge, enforce clean boundaries, and accelerate skill development.

Core Features & Use Cases

  • Structured skill templates: Clear SKILL.md frontmatter and consistent folder layouts (references/, scripts/, assets/) to enable predictable loading and reuse.
  • Guided workflows: Step-by-step patterns for building, refactoring, and validating skills.
  • Progressive disclosure: Organize knowledge so Claude loads only what it needs when it needs it.

Quick Start

Create a new skill by drafting SKILL.md with frontmatter, then add optional references and scripts as needed. Use the provided structure to keep content maintainable and scalable.

Frequently Asked Questions about skill-builder

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

FAQPage Schema
How do I structure a Claude skill to keep it maintainable?▼

Structuring Claude skills involves drafting a SKILL.md file with minimal frontmatter and organizing content into references, scripts, and assets folders. This enforces clean boundaries and enables progressive disclosure for maintainable workflows.

What is progressive disclosure when building Claude skills?▼

Progressive disclosure is an organization pattern where Claude loads only the knowledge it needs when it needs it. This is achieved by routing knowledge cleanly across optional references and scripts instead of loading everything at once.

How do I refactor existing Claude skills to follow best practices?▼

Refactoring Claude skills uses guided workflows to validate and restructure existing knowledge. You update the SKILL.md frontmatter and organize files into the standard references, scripts, and assets folders to enforce clean boundaries and scalable content.

Do I need dependencies to create a new Claude skill?▼

You do not need external dependencies to create a Claude skill. Skill-builder provides a standalone framework with structured templates and guided workflows to draft SKILL.md files and organize folders without requiring additional packages.

What's the best way to organize skill assets and scripts for reuse?▼

The best way to organize skill assets and scripts is using a consistent folder layout with dedicated references, scripts, and assets directories. This structure ensures predictable loading and allows content to scale without breaking boundaries.

Related Skills

Explore More Software Engineering Skills→
iradkotiradkot

make-skill-template

Generate SKILL.md frontmatter and directory structure for new Agent Skills.

Community
Basic
aimi-soaimi-so
10

create-agent-skills

Guide skill authors to design, document, and validate Claude Code skills and slash commands.

Official
Advanced
damilola-elegbede-orgdamilola-elegbede-org

markdown-linting

Identify and report Markdown style violations across project documentation files.

Official
Basic
CaptainCrouton89CaptainCrouton89
497

Writing Documentation for LLMs

Write documentation for LLMs with progressive disclosure and consistent terminology.

Community
Basic