skill-export
Export Claude skills. Use to generate documentation of all available Claude Skills.
When & Why to Use This Skill
The Skill Export tool is a specialized utility designed to automate the discovery and documentation of all Claude skills within a development environment. By scanning personal, project-specific, and plugin-based directories, it generates a structured markdown catalog (SKILLS.md) that serves as a single source of truth for an agent's capabilities, enhancing discoverability and environment management.
Use Cases
- Automated Documentation: Automatically generate and update a SKILLS.md file to maintain a comprehensive directory of all available AI skills and their absolute paths.
- Skill Discovery & Auditing: Efficiently scan multiple sources—including complex plugin manifests and local directories—to identify which capabilities are currently active and available to the Claude agent.
- Environment Standardization: Ensure team-wide consistency by providing a clear, readable table of skill names and descriptions, making it easier for developers to understand the available toolset in any given project.
- Agent Context Optimization: Create a reference guide that the AI agent can use to self-identify relevant skills for specific tasks, improving tool-use accuracy and efficiency.
| name | skill-export |
|---|---|
| description | Export Claude skills. Use to generate documentation of all available Claude Skills. |
| allowed-tools | TodoWrite, Glob, Read, Bash(echo:*), Bash(cat:*), Bash(find:*), Bash(ls:*) |
| license | MIT |
Skill Export
Generate a comprehensive markdown catalog of all Claude skills available in the environment.
Workflow
Discover Skills from Three Sources
Personal Skills: ~/.claude/skills/*/SKILL.md
- Scan all subdirectories for SKILL.md files
Project Skills: .claude/skills/*/SKILL.md
- Scan all subdirectories relative to current working directory
Plugin Skills: Requires careful multi-step discovery
- Read
~/.claude/settings.jsonto get enabled plugins (format:plugin-name@marketplace-id) - Parse each plugin ID into plugin name and marketplace ID
- Look up marketplace location in
~/.claude/plugins/known_marketplaces.json - Read
{marketplaceLocation}/.claude-plugin/marketplace.jsonto get the marketplace manifest - Find the specific plugin by name in the manifest's
pluginsarray - Only scan skills listed in that plugin's
skillsarray (do not scan entire marketplace) - For each skill path, read
{marketplaceLocation}/{skillPath}/SKILL.md
Critical: Plugin discovery must be scoped to enabled plugins. Do not scan all skills in a marketplace—only those listed in the specific enabled plugin's manifest entry.
Extract and Format
For each SKILL.md file:
- Parse YAML frontmatter to extract
nameanddescription. - Record location as absolute path to the skill directory (use
dirname()of SKILL.md path)
Critical: Only read the YAML frontmatter, i.e., the top 5 lines, of SKILL.md files.
Generate markdown table:
# Skills
Skills are additional instructions for specific scenarios. Given below is a list of name, description, and location of all available skills.
If a skill is relevant to the task you're performing based on its description, read the SKILL.md file at the location of that skill for additional instructions.
| Name | Description | Location |
|------|-------------|----------|
| skill-name | Description text | /absolute/path/to/skill |
Formatting: escape pipe characters (\|), remove newlines from descriptions, sort by location type then name.
Write Output
Write the output into a SKILLS.md file at the current working directory. Write the generated markdown into the file, and display summary to the user in chat.