What are the required components of a skill?

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

What is a Claude Code Skill?

A skill is a modular package that extends Claude's capabilities with specialized knowledge, tools, and procedural workflows for specific domains or tasks.

Why should I use Skill Shaper to create my skills?

Skill Shaper provides a standardized framework and best practices to ensure your skills are context-efficient, modular, and performant within Claude's environment.

Can I include executable scripts in my custom skills?

Yes, Skill Shaper guides you on placing Python or Bash scripts in the scripts/ directory, allowing Claude to execute deterministic code without exhausting the context window.

How does progressive disclosure work in Claude skills?

It manages context by only loading metadata initially, the SKILL.md body upon trigger, and external resources only when Claude determines they are strictly necessary.

Skill Shaper

Name: Skill Shaper
Author: bluewaves-creations

bybluewaves-creations

•

Developer Tools

Guides the creation and optimization of specialized Claude Code skills using standardized best practices and progressive disclosure patterns.

Skill Shaper is a comprehensive framework designed to help developers build, refine, and package specialized capabilities for Claude. It provides a structured methodology for extending Claude's intelligence with domain-specific workflows, tool integrations, and bundled resources while maintaining context efficiency through a unique three-level loading system. Whether you are initializing a new skill from scratch or optimizing an existing one, this skill ensures your additions are modular, deterministic, and perfectly calibrated for the AI's context window limits.

Key Features

01Best practices for concise YAML metadata and instructions

021 GitHub stars

03Step-by-step workflow for planning and validating domain-specific expertise

04Context-efficient progressive disclosure design patterns

05Standardized skill initialization and directory structuring

06Guidance on managing scripts, references, and assets

Use Cases

01Developing custom domain-specific agents for internal company schemas

02Optimizing existing Claude skills to reduce token consumption and improve reliability

03Packaging complex multi-step Bash or Python workflows into reusable skills

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add bluewaves-creations/bluewaves-skills skill-shaper

For use in Claude.ai and ChatGPT

Download Skill