skill-catalog

Categorize and display available skills. Use when listing or selecting skills.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026⬇️1downloads

When & Why to Use This Skill

The skill-catalog is a fundamental utility for the Claude Code Global Skill System, designed to organize, display, and manage available agent capabilities. It serves as a central directory that enables both users and orchestrator agents to discover and select the most appropriate tools from global, user, and project-specific registries, ensuring efficient workflow execution.

Use Cases

  • Skill Discovery: Retrieve a comprehensive list of all installed skills to understand the current environment's capabilities and available tools.
  • Categorized Selection: Filter and browse skills by specific domains such as 'Code Analysis' or 'AI & Orchestration' to find the right tool for a specialized task.
  • Agent Orchestration: Enable high-level orchestrator agents to programmatically identify and load the necessary skills required to solve complex, multi-step user requests.
  • Registry Management: Navigate the global skill hierarchy, including plugin-based, user-defined, and project-local skills, through a unified interface.
nameskill-catalog
descriptionCategorize and display available skills. Use when listing or selecting skills.
allowed-tools["Read"]

Claude Code Global Skill System

Claude Code maintains a global skill registry. All installed skills are automatically available.

System Prompt (자동 포함):
<available_skills>
  <skill><name>skill-name</name><description>...</description></skill>
  ...
</available_skills>

No discovery needed - Claude already knows all skills.


Skill Sources

Source Location Registration
Plugin Skills ~/.claude/plugins/*/skills/ marketplace.json skills array
User Skills ~/.claude/skills/ Automatic
Project Skills .claude/skills/ Automatic

All sources merge into a single global registry accessible via Skill tool.


Categories

Icon Category Keywords
📊 Data & Analysis data, sql, database, query
🎨 Design & Frontend ui, frontend, component, design
📝 Documentation doc, writing, content
🔧 Development Tools build, deploy, test, ci
🔒 Security security, auth, validation
🤖 AI & Orchestration ai, workflow, orchestration, agent
📦 Code Generation generate, scaffold, template
🔍 Code Analysis analyze, review, refactor

Usage

Listing Skills

Claude can reference <available_skills> from system prompt directly.

Calling Skills

Skill("skill-name")           # Load skill into context
Skill("plugin:skill-name")    # Fully qualified name

In Agent YAML

skills: skill1, skill2        # Auto-loaded at agent start

Skill Selection Guide

For orchestrator agents, help users select skills:

## Available Skills by Category

### 🔍 Code Analysis
- **serena-refactor:analyze** - SOLID violation detection
- **pr-review-toolkit:code-reviewer** - PR code review

### 🤖 AI & Orchestration
- **skillmaker:orchestration-patterns** - Agent architecture
- **skillmaker:mcp-gateway-patterns** - MCP isolation

Which skills does your agent need?

Best Practices

  1. Use global registry - Don't manually glob for skills
  2. Categorize by domain - Help users find relevant skills
  3. Prefer plugin:skill format - Avoid naming conflicts

References