What files are required for a new skill?

Every skill requires a SKILL.md file containing YAML frontmatter (name and description) and Markdown instructions. Optional folders include scripts, references, and assets.

What is the Progressive Disclosure principle?

It is a three-level loading system (Metadata, SKILL.md, and Bundled Resources) designed to keep the context window lean by only loading detailed information when Claude determines it is actually needed for the task.

Why use scripts instead of text instructions in a skill?

Scripts provide deterministic reliability for fragile tasks, are more token-efficient than long text explanations, and can be executed by Claude without loading the entire code into the context window.

What is a Claude Code Skill?

A Claude Code Skill is a modular, self-contained package that extends Claude's capabilities with specialized knowledge, workflows, and tool integrations, essentially acting as an onboarding guide for specific domains.

Skill Creator

Name: Skill Creator
Author: macnversion

bymacnversion

0•

Developer Tools

Guides the development and optimization of custom Claude Code Skills using specialized design patterns and context-efficient architectures.

The Skill Creator provides a comprehensive framework for building modular, self-contained packages that transform Claude from a general-purpose agent into a domain-specific expert. It emphasizes the 'Progressive Disclosure' design principle to manage the context window efficiently, ensuring Claude only loads deep technical references or complex scripts when necessary. By following this skill's guidance, developers can create specialized workflows, integrate deterministic scripts, and package organizational knowledge into reusable assets that enhance Claude's procedural capabilities without bloat.

Key Features

010 GitHub stars

02Guidance on setting appropriate degrees of freedom for AI tasks

03Best practices for bundling deterministic scripts and reusable assets

04Domain-specific organization patterns for complex workflows

05Progressive disclosure architecture for context window optimization

06Standardized skill anatomy including SKILL.md, scripts, and references

Use Cases

01Architecting a new Claude Skill from scratch for specialized company workflows

02Refactoring existing AI prompts into modular, token-efficient skill packages

03Creating resource-heavy skills that require external scripts or large documentation sets

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add macnversion/skills skill-creator

For use in Claude.ai and ChatGPT

Download Skill