What is a Claude Code Skill?

A skill is a specialized, modular package that extends an AI agent's capabilities by providing domain-specific workflows, tool integrations, and expert knowledge that the base model may lack.

What is the recommended writing style for skills?

Skills should be written using an imperative or infinitive form (verb-first instructions) to maintain consistency and clarity for AI consumption, avoiding second-person language.

Why is progressive disclosure important in skill design?

Progressive disclosure ensures the AI only loads relevant information in stages—metadata first, then the core skill body, then specific resources—preventing context window saturation and improving performance.

What is the anatomy of a skill in this ecosystem?

Every skill requires a SKILL.md file containing YAML metadata and instructions, and can optionally include directories for executable scripts, reference documentation, and static assets.

Skill Creator

Name: Skill Creator
Author: OpenHands

byOpenHands

•

Developer Tools

Standardizes the creation and optimization of OpenHands skills through structured guidance and best practices for modular AI capabilities.

The Skill Creator provides a comprehensive framework for building modular, specialized capabilities within the OpenHands ecosystem. It guides developers through a six-step process—from initial conceptualization and concrete examples to validation and iteration—ensuring that new skills are token-efficient, well-documented, and utilize progressive disclosure to manage context windows effectively. By leveraging standardized templates for SKILL.md and organized resource directories for scripts, references, and assets, this skill transforms generic AI agents into domain-specific experts with procedural knowledge.

Key Features

01Validation workflow for trigger phrases and imperative writing styles

02Standardized SKILL.md template generation with required YAML frontmatter

03Progressive disclosure design for optimized AI context window management

04Categorized resource organization for scripts, references, and assets

0572 GitHub stars

06Step-by-step guidance from discovery to iterative skill improvement

Use Cases

01Refactoring monolithic agent instructions into modular, reusable skill packages

02Optimizing existing skills to reduce token usage by moving documentation to reference files

03Developing new domain-specific skills for internal company APIs or proprietary workflows

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add openhands/extensions skill-creator

For use in Claude.ai and ChatGPT

Download Skill