How should I write instructions within a Skill?

Instructions should use the imperative or infinitive form (verb-first). Use objective, instructional language like 'To accomplish X, do Y' rather than 'You should do X'.

Why should I use the references directory instead of putting everything in SKILL.md?

Moving detailed schemas, policies, and API docs to the references folder keeps the main SKILL.md lean (target 1,500-2,000 words), preventing Claude's context window from being overwhelmed.

What is a Claude Code Skill?

A skill is a modular, self-contained package that extends Claude's capabilities with specialized knowledge, workflows, and tools, acting as an onboarding guide for specific tasks.

What is the principle of progressive disclosure in skills?

It is a three-level loading system: metadata for discovery, the SKILL.md body for core instructions, and bundled resources (references/scripts) loaded only as needed to save context space.

Skill Development for Claude Code

Name: Skill Development for Claude Code
Author: Claude-Code-Community-Ireland

byClaude-Code-Community-Ireland

•

学習とドキュメンテーション

Guides the creation, organization, and optimization of modular skills to extend Claude Code's domain-specific capabilities.

This skill provides a standardized framework for developers to build high-quality Claude Code skills using the principle of progressive disclosure. It assists in structuring the required SKILL.md file, optimizing trigger metadata for better discovery, and managing bundled resources like executable scripts, reference documentation, and assets. By following these best practices, developers can transform Claude into a specialized agent equipped with procedural knowledge and deterministic tools while maintaining a lean context window.

主な機能

01Standardized SKILL.md template generation

023 GitHub stars

03Progressive disclosure architecture patterns

04Trigger phrase and metadata quality validation

05Instructional style optimization using imperative forms

06Modular resource management for scripts and assets

ユースケース

01Refactoring bloated instruction files into modular reference documents

02Optimizing skill descriptions to improve Claude's trigger accuracy

03Bootstrapping a new domain-specific skill for a Claude Code plugin

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add claude-code-community-ireland/claude-code-resources skill-development

For use in Claude.ai and ChatGPT

Download Skill