How do I ensure Claude triggers my skill correctly?

Effective skills use specific, concrete trigger phrases in the YAML frontmatter description, written in the third person (e.g., 'This skill should be used when the user asks to...').

What is a Claude Code Skill?

A Claude Code Skill is a specialized, modular capability that extends Claude's behavior with domain-specific workflows, tool integrations, and procedural knowledge.

What is the Progressive Disclosure principle in skill design?

It is a three-level loading system (Metadata, SKILL.md, and Resources) designed to keep the context window lean by only providing detailed information when Claude identifies a specific need.

Why should I use the imperative writing style for skills?

Using verb-first, objective instructions (e.g., 'To accomplish X, do Y') provides the clearest guidance for AI models and ensures consistency across different skills.

Claude Skill Architect

Name: Claude Skill Architect
Author: iButters

byiButters

•

开发者工具

Provides a standardized framework and best practices for creating, organizing, and optimizing modular skills for Claude Code plugins.

The Skill Development skill is a meta-utility designed to help developers architect high-quality capabilities for Claude Code. It provides a comprehensive methodology for building skills that are context-efficient and highly effective, focusing on the core principle of progressive disclosure. By guiding developers through the creation of SKILL.md files, specialized scripts, and reference documentation, it ensures that new plugins are deterministic, modular, and optimized for AI-driven workflows. Whether you are defining trigger phrases in YAML metadata or organizing complex domain knowledge into reference files, this skill provides the procedural expertise needed to transform Claude into a specialized agent for any technical domain.

主要功能

011 GitHub stars

02Imperative writing style guidelines for AI-optimized instructions

03Progressive disclosure patterns for efficient context window management

04Standardized SKILL.md structure with YAML metadata guidance

05Best practices for organizing scripts, references, and assets

06Step-by-step skill creation and validation workflows

使用场景

01Optimizing skill descriptions to improve AI intent recognition and triggering

02Refactoring monolithic documentation into modular, load-on-demand reference files

03Bootstrapping new specialized capabilities for a custom Claude Code plugin

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ibutters/claudecodeplugins skill-development

For use in Claude.ai and ChatGPT

Download Skill