What is a Claude Code Skill?

A Claude Code Skill is a specialized reference guide that provides domain-specific guidance, best practices, and implementation patterns to enhance Claude's behavior during specific coding tasks.

How do I keep my skills token-efficient?

Keep SKILL.md files under 500 lines, use concise examples, and reference external files for heavy documentation or large API references to avoid wasting context window space.

Why does the naming convention require gerunds?

Using the gerund form (e.g., 'testing-apps' instead of 'app-test') describes an active process, making it easier for Claude to match the skill to the current action it is performing.

What is Claude Search Optimization (CSO)?

CSO is the practice of optimizing skill descriptions with specific triggers, error messages, and keywords that Claude searches for when deciding if a skill is relevant to the current context.

Claude Code Skill Architect

Name: Claude Code Skill Architect
Author: AgentWorkforce

byAgentWorkforce

•

Developer Tools

Standardizes the creation and optimization of Claude Code skills to ensure they are discoverable, token-efficient, and highly effective.

The Claude Code Skill Architect provides a definitive framework for building high-quality skills that enhance Claude's autonomous coding capabilities. It focuses on Claude Search Optimization (CSO), structured YAML frontmatter, and gerund-based naming conventions to ensure custom skills are easily discovered and correctly applied. By balancing 'degrees of freedom' with explicit implementation patterns, this skill helps developers document reusable techniques and complex workflows in a format that maximizes AI performance while minimizing token overhead.

Key Features

01Token-efficient documentation patterns and compression techniques

029 GitHub stars

03Claude Search Optimization (CSO) keyword and trigger strategies

04Standardized YAML frontmatter for improved skill discoverability

05Gerund-based naming conventions for active task matching

06Degrees of Freedom framework for balancing task flexibility and constraint

Use Cases

01Optimizing existing custom skills for better keyword matching in Claude

02Documenting fragile deployment or security workflows with explicit step-by-step guidance

03Converting internal team coding standards into discoverable AI skills

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add agentworkforce/relay creating-skills-skill

For use in Claude.ai and ChatGPT

Key Features

01Token-efficient documentation patterns and compression techniques

029 GitHub stars

03Claude Search Optimization (CSO) keyword and trigger strategies

04Standardized YAML frontmatter for improved skill discoverability

05Gerund-based naming conventions for active task matching

06Degrees of Freedom framework for balancing task flexibility and constraint

Use Cases

01Optimizing existing custom skills for better keyword matching in Claude

02Documenting fragile deployment or security workflows with explicit step-by-step guidance

03Converting internal team coding standards into discoverable AI skills

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add agentworkforce/relay creating-skills-skill

For use in Claude.ai and ChatGPT