Why is progressive disclosure important for skills?

It allows Claude to manage context efficiently by only loading deep documentation or complex scripts when specifically needed, preventing the context window from being overwhelmed by unnecessary data.

How should I format instructions within a skill?

Instructions should be written in the imperative or infinitive form (verb-first), focusing on objective, instructional language that another AI instance can easily follow.

What is a Claude Code Skill?

A skill is a modular, self-contained package that extends Claude's behavior by providing specialized knowledge, workflows, and tool integrations for specific domains.

What is the mandatory file for a Claude Code skill?

Every skill must have a SKILL.md file containing YAML frontmatter with a unique name and a detailed description that helps Claude identify when to trigger the skill.

Claude Code Skill Development

Name: Claude Code Skill Development
Author: brixtonpham

bybrixtonpham

0•

Learning & Documentation

Guides the creation, structuring, and optimization of specialized skills for Claude Code plugins using industry best practices.

This skill provides a standardized framework for developers to build high-quality, modular capabilities for Claude Code. It streamlines the skill creation process by offering guidance on directory structure, YAML metadata optimization, and the 'Progressive Disclosure' design principle. By organizing resources into scripts, references, and assets, this skill ensures that Claude maintains a lean context window while accessing the specific domain knowledge, schemas, and procedural workflows required to function as a specialized agent.

Key Features

01Progressive disclosure architecture for context efficiency

02Trigger phrase optimization for accurate skill activation

03Imperative writing style guidance for AI-to-AI instructions

040 GitHub stars

05Automated directory structure for scripts, references, and assets

06Standardized SKILL.md template and metadata generation

Use Cases

01Building new domain-specific capabilities for Claude Code plugins

02Refactoring existing skills to improve performance and context management

03Organizing complex API documentation and boilerplate code for AI consumption

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add brixtonpham/dot-claude skill-development

For use in Claude.ai and ChatGPT

Download Skill