What exactly is a Claude Code Skill?

A skill is a modular, self-contained package that extends an AI agent's capabilities by providing specialized workflows, tool integrations, and domain-specific expertise that the base model may not possess natively.

What is the mandatory anatomy of a skill?

Every skill must contain a SKILL.md file with YAML frontmatter (name and description) and Markdown instructions. Optional components include scripts, references for documentation, and assets for output templates.

How does the Skill Creator help with token efficiency?

It implements the 'Progressive Disclosure' principle, teaching you to keep the core SKILL.md lean while moving heavy documentation or deterministic logic into external reference files or scripts that are only loaded when needed.

When should I use scripts instead of text instructions?

Use scripts in the /scripts folder for tasks that require deterministic reliability, complex logic that is frequently rewritten by the AI, or operations that are fragile and error-prone if left to high-freedom text instructions.

Skill Creator

Name: Skill Creator
Author: x-cmd

byx-cmd

•

개발자 도구

Guides the creation and optimization of custom Claude Code skills using standardized best practices for modular, token-efficient agent capabilities.

Skill Creator is a specialized utility designed to help developers build, update, and refine custom capabilities for AI agents. It provides a structured framework for defining workflows, tool integrations, and domain-specific knowledge while prioritizing context window efficiency through the principle of progressive disclosure. By following its standardized anatomy—including metadata, SKILL.md instructions, and optional bundled resources like scripts and assets—developers can transform general-purpose agents into specialized experts with high procedural reliability and minimal token overhead.

주요 기능

019 GitHub stars

02Step-by-step skill development and packaging workflow

03Standardized file structure templates for SKILL.md and resources

04Best practices for defining degrees of freedom in agent behavior

05Naming and metadata optimization for improved skill triggering

06Guidance on context-saving progressive disclosure patterns

사용 사례

01Developing custom domain-specific capabilities for AI coding agents

02Optimizing existing skills to reduce context bloat and token costs

03Standardizing internal tool integrations and workflows for engineering teams

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add x-cmd/skill skill-creator

For use in Claude.ai and ChatGPT

Download Skill