Skills Maker

English | 中文

Use AI Agent Skills to make AI Agent Skills.

A meta-skill that automatically packages your successful tool-usage workflows into reusable Agent Skills.

What is This?

When you work with AI agents, your interactions fall into two categories:

1. Development tasks - Creating new code, tools, or features
2. Tool-usage tasks - Using existing tools to complete specific work

Skills Maker captures the second type and transforms them into reusable skills that any compatible agent can use.

Features

• Smart Detection - AI semantically analyzes conversations to distinguish development from tool-usage tasks
• Interactive Refinement - Guides you through naming, scoping, and customizing the generated skill
• Bilingual Support - Generate skills in English or Chinese
• Tool Packaging - Automatically copies scripts and tools used in workflows to the skill's directory
• Specification Compliant - Generates skills that follow the Agent Skills specification

Installation

Copy the skills-maker folder to your skills directory based on your preferred scope.

Skills Directory Locations

Tool	User (Global)	Project	Reads .claude/skills/
Claude Code	~/.claude/skills/	.claude/skills/	Native
Cursor	~/.cursor/skills/	.cursor/skills/	Yes
OpenAI Codex	~/.codex/skills/	.codex/skills/	Yes
Gemini CLI	~/.gemini/skills/	.gemini/skills/	Yes
GitHub Copilot / VS Code	~/.copilot/skills/	.github/skills/	Yes
Roo Code	~/.roo/skills/	.roo/skills/	-
OpenCode	~/.opencode/skills/	.opencode/skills/	Yes
Amp	~/.amp/skills/	.agents/skills/	-
Goose	via MCP extensions	via MCP extensions	-

Tip: Tools marked with "Yes" can directly read skills from .claude/skills/, allowing you to maintain a single skills directory for multiple tools.

For tools not listed above, please check their official documentation for Agent Skills support.

Example: Claude Code

# User-level (available in all projects)
cp -r skills-maker ~/.claude/skills/

# Project-level (current project only)
cp -r skills-maker .claude/skills/

Example: Cursor

# User-level (available in all projects)
cp -r skills-maker ~/.cursor/skills/

# Project-level (current project only)
cp -r skills-maker .cursor/skills/

Priority

When skills share the same name across levels, higher-priority locations win:

• Claude Code: Enterprise > User > Project
• Cursor: User > Project
• GitHub Copilot / VS Code: User > Project
• Gemini CLI: Workspace > User > Extension

Directory Structure

skills-maker/
├── SKILL.md                          # Main skill instructions
├── references/
│   ├── SPECIFICATION.md              # Agent Skills format specification
│   └── BEST-PRACTICES.md             # Authoring guidelines
└── assets/
    └── templates/
        ├── SKILL-TEMPLATE-EN.md      # English template
        └── SKILL-TEMPLATE-ZH.md      # Chinese template

How It Works

Complete a tool-usage workflow
            │
            ▼
   Trigger skills-maker
            │
            ▼
   AI analyzes the conversation
            │
    ┌───────┴───────┐
    │               │
Development     Tool-usage
  task            task
    │               │
    ▼               ▼
 REJECT          PROCEED
 (with          (interactive
 reason)        refinement)
                    │
                    ▼
              Generate Skill
                    │
                    ▼
          Copy tools to scripts/

Usage

After completing a tool-usage workflow with your AI agent, simply ask:

Create a skill from this workflow

The skill will guide you through:

1. Confirming the workflow summary
2. Choosing a skill name
3. Selecting the documentation language
4. Refining the scope
5. Deciding which tools to include

Example

Here's a real example of using skills-maker to create an "update-ai-cli" skill:

Step 1: Complete a Tool-Usage Workflow

First, complete a task using existing tools. In this example, the user asks the AI to create a batch script for updating CLI tools.

Step 2: AI Creates the Tool

The AI searches for update methods and creates the update-ai-cli.bat script.

Step 3: Trigger Skills-Maker

After the workflow is complete, ask the AI to package it as a skill. The AI confirms it's a tool-usage task, reads reference documents and templates, then asks interactive questions.

Step 4: Skill Generated

The AI creates the skill directory structure, copies the script using cp command, and generates the SKILL.md file.

Step 5: Use the New Skill

Now you can use the newly created skill. Simply ask the AI to "update my AI tools", and it will automatically load the skill and execute the script.

Result: A complete skill with the following structure:

.claude/skills/update-ai-cli/
├── SKILL.md                    # Skill documentation
└── scripts/
    └── update-ai-cli.bat       # Batch update script

Output

Generated skills are placed in the parent directory of skills-maker. For example:

• skills-maker location: .claude/skills/skills-maker/
• New skill location: .claude/skills/your-new-skill/

Compatibility

Skills Maker generates skills compatible with:

• Claude Code
• GitHub Copilot (VS Code, CLI, Coding Agent)
• Cursor
• And other Agent Skills compatible tools

License

Apache 2.0 - See LICENSE for details.