Create or Refactor a Skill

VerifiedSafe

Creates or refactors a Claude Code skill using a skill name and optional documentation path. It reads the existing skill definition and generates a new or updated SKILL.md file. Use this when you need to define a new reusable skill or update an existing one.

Sby Skills Guide Bot
DevelopmentIntermediate
1306/2/2026
Claude Code
#skill#creation#refactoring#claude-code

Recommended for

Our review

Creates or refactors a Claude Code skill by following a structured template.

Strengths

  • Automates the creation of reusable skills
  • Leverages a base skill file for consistency
  • Supports parameters like skill name and documentation path

Limitations

  • Requires strict adherence to a reference skill file
  • Limited to allowed tools (Read, Grep, Glob, Write, Task)
  • May fail if the base skill is not loaded
When to use it

Use this skill when you need to create a new skill or refactor an existing one in a structured way.

When not to use it

Avoid it if the skill is trivial or if you are working outside the Claude Code environment with unsupported tools.

Security analysis

Safe
Quality score75/100

The skill is a meta-skill that only instructs to read another skill and use safe tools (Read, Grep, Glob, Write, Task). There are no destructive or exfiltrating commands, no obfuscation, and no network access. The Write tool is used for its intended purpose.

No concerns found

Examples

Create a new skill
/create-skill circuit-breaker docs/features/resilience
Refactor an existing skill
/create-skill codex-brainstorm

description: Create or refactor a Claude Code skill argument-hint: <skill-name> [docs-path] allowed-tools: Read, Grep, Glob, Write, Task

⚠️ Must read and follow the skill below before executing this command:

@skills/create-skill/SKILL.md

Task

Create or refactor a skill.

Parameters

$ARGUMENTS

Examples

/create-skill circuit-breaker docs/features/resilience
/create-skill codex-brainstorm  # Refactor existing skill
Related skills