Agent skill

skill-creator

Create new AI agent skills for Claude Code, Codex, and Cursor. Use when asked to create a skill, add a new agent capability, or set up a slash command.

View SKILL.md on GitHub Repository
Stars 121
Forks 14

Install this agent skill to your Project

npx add-skill https://github.com/stacklok/toolhive-studio/tree/main/.cursor/skills/skill-creator

SKILL.md

Skill Creator

Create AI agent skills that work across Claude Code, Codex, and Cursor.

Workflow

  1. Claude is canonical - Always create/edit in .claude/skills/<name>/ first
  2. Replicate with CLI - Copy to .codex/skills/ and .cursor/skills/ using cp -r
  3. Format differences - Use sed only if agent-specific tweaks are needed (rare)

Directory Structure

.claude/skills/<skill-name>/
├── SKILL.md          # Required - instructions + metadata
├── references/       # Optional - supporting documentation
├── scripts/          # Optional - executable helpers
└── assets/           # Optional - templates, resources

.codex/skills/<skill-name>/   # Copy of Claude's
.cursor/skills/<skill-name>/  # Copy of Claude's

SKILL.md Format

yaml
---
name: skill-name # Required: lowercase, hyphens, max 64 chars
description: What it does... # Required: triggers auto-selection by agent
allowed-tools: Read, Grep, Bash # Optional: Claude-specific (ignored by others)
model: claude-opus-4-5-20251101 # Optional: Claude-specific (ignored by others)
---
# Skill Title

Instructions in markdown...

Required Fields

  • name: Lowercase with hyphens, must match directory name
  • description: Explains what the skill does and when to use it. Include keywords users would say to help the agent auto-select this skill.

Optional Fields (Claude-specific, ignored by other agents)

  • allowed-tools: Tools the agent can use without asking permission
  • model: Override the model for this skill
  • context: fork: Run in isolated subagent context

Creating a New Skill

  1. Ask the user what the skill should do
  2. Choose a descriptive name (lowercase, hyphens)
  3. Create the Claude skill:
    bash
    mkdir -p .claude/skills/<name>
  4. Write .claude/skills/<name>/SKILL.md with proper frontmatter
  5. Replicate to other agents:
    bash
    cp -r .claude/skills/<name> .codex/skills/
cp -r .claude/skills/<name> .cursor/skills/

Modifying an Existing Skill

  1. Edit .claude/skills/<name>/SKILL.md (canonical source)
  2. Replicate changes:
    bash
    cp .claude/skills/<name>/SKILL.md .codex/skills/<name>/
cp .claude/skills/<name>/SKILL.md .cursor/skills/<name>/

Best Practices

  • Keep skills focused on a single capability
  • Write clear descriptions with keywords for auto-discovery
  • Use references/ for lengthy documentation to keep SKILL.md concise
  • Test the skill by asking the agent to perform the task

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

stacklok/toolhive-studio

testing-with-api-mocks

Start here for all API mocking in tests. Covers auto-generation, fixtures, and when to use other skills. Required reading before creating, refactoring, or modifying any test involving API calls.

121 14
Explore
stacklok/toolhive-studio

testing-api-overrides

Test that components send correct query parameters or request arguments. Use when testing filtering, sorting, pagination, or any read operation where request parameters matter. Use for test-scoped mock customization.

121 14
Explore
stacklok/toolhive-studio

deep-links

Deep links in ToolHive Studio. Use when implementing, debugging, or asking about deep link features (toolhive-gui:// protocol), adding new deep link intents, understanding the deep link architecture, IPC model, or platform/packaging support.

121 14
Explore
stacklok/toolhive-studio

skill-editor

REQUIRED for editing any skill file. Ensures changes sync to Claude, Codex, and Cursor. Never edit .claude/skills/ files directly - always use this skill.

121 14
Explore
stacklok/toolhive-studio

security-vuln-remediation

Remediate security vulnerabilities found by Grype or pnpm audit. Use when a security scan fails, a CVE needs fixing, or you need to analyze, upgrade, override, or ignore a vulnerable dependency.

121 14
Explore
stacklok/toolhive-studio

testing-api-assertions

Verify API requests in tests. Use when testing that correct API calls are made for create, update, or delete operations. Use when testing mutations, form submissions, or actions with backend side effects.

121 14
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results