Why should I use gerunds for skill names?

Using the gerund form (e.g., 'creating-skills' instead of 'skill-creation') makes skills active and clear, aligning with Anthropic's conventions to improve AI recognition.

What is a Claude Code Skill?

A Claude Code Skill is a specialized reference guide that provides the AI agent with domain-specific techniques, patterns, or tools to enhance its behavior and performance during specific tasks.

What is token efficiency in the context of skills?

Skills load into the AI's conversation context; keeping them concise (ideally under 500 lines) ensures they don't consume excessive memory or interfere with task processing.

How do I make my skills discoverable for Claude?

Utilize Claude Search Optimization (CSO) by including specific triggering conditions, symptoms, and tool names in the YAML description field of your skill file.

When should I create a new skill?

Create a skill when you have a technique that isn't intuitively obvious, applies across multiple projects, and provides a pattern you'd want to reference again.

Creating Claude Skills

Name: Creating Claude Skills
Author: AgentWorkforce

byAgentWorkforce

•

Learning & Documentation

Standardizes the creation and optimization of custom Claude Code skills to ensure they are discoverable, efficient, and actionable for AI agents.

This skill provides a comprehensive framework for developing and refining Claude Code skills, which are specialized capabilities that guide AI agents through domain-specific tasks. By enforcing specific naming conventions, structural requirements like YAML frontmatter, and Claude Search Optimization (CSO) techniques, it ensures that your custom patterns and techniques are easily found and correctly applied by Claude. It emphasizes token efficiency, clear code examples, and structured workflows to help developers build a library of reusable agentic capabilities that scale across multiple projects.

Key Features

01Standardized YAML frontmatter structure for agent metadata

02Implementation patterns including 'Degrees of Freedom' for task complexity

03Gerund-based naming conventions for active capability identification

04Claude Search Optimization (CSO) for better skill discovery

0516 GitHub stars

06Token efficiency guidelines to minimize context window overhead

Use Cases

01Optimizing existing agent instructions for better performance and discovery

02Establishing a standardized library of reusable team coding patterns

03Scaling domain-specific knowledge across large engineering organizations

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add agentworkforce/trajectories creating-skills-skill

For use in Claude.ai and ChatGPT

Key Features

01Standardized YAML frontmatter structure for agent metadata

02Implementation patterns including 'Degrees of Freedom' for task complexity

03Gerund-based naming conventions for active capability identification

04Claude Search Optimization (CSO) for better skill discovery

0516 GitHub stars

06Token efficiency guidelines to minimize context window overhead

Use Cases

01Optimizing existing agent instructions for better performance and discovery

02Establishing a standardized library of reusable team coding patterns

03Scaling domain-specific knowledge across large engineering organizations

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add agentworkforce/trajectories creating-skills-skill

For use in Claude.ai and ChatGPT