# Skill Creator

Create, edit, improve, or audit skills for SwarmClaw agents.

- Repository: https://github.com/swarmclawai/swarmclaw (703 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-06-30
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add swarmclawai/swarmclaw --skill skill-creator -g -a claude-code -y`
Codex: `npx skills add swarmclawai/swarmclaw --skill skill-creator -g -a codex -y`
Cursor: `npx skills add swarmclawai/swarmclaw --skill skill-creator -g -a cursor -y`
Gemini CLI: `npx skills add swarmclawai/swarmclaw --skill skill-creator -g -a gemini-cli -y`

## Description

Create, edit, improve, or audit skills for SwarmClaw agents. Use when creating a new skill from scratch or when asked to improve, review, audit, tidy up, or clean up an existing skill or SKILL.md file. Also use when editing or restructuring a skill directory. Triggers on phrases like "create a skill", "author a skill", "tidy up a skill", "improve this skill", "review the skill", "clean up the skill", "audit the skill".

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Skill Creator

Guidance for creating effective skills that extend SwarmClaw agent capabilities.

## About Skills

Skills are modular, self-contained packages that provide specialized knowledge, workflows, and tools. They transform a general-purpose agent into a specialized one equipped with procedural knowledge that no model can fully possess.

### What Skills Provide

1. Specialized workflows, multi-step procedures for specific domains
2. Tool integrations, instructions for working with specific file formats or APIs
3. Domain expertise, company-specific knowledge, schemas, business logic
4. Bundled resources, scripts, references, and assets for complex and repetitive tasks

## Core Principles

### Concise is Key

The context window is a shared resource. Only add context the agent doesn't already have. Challenge each piece of information: "Does the agent really need this explanation?" Prefer concise examples over verbose explanations.

### Set Appropriate Degrees of Freedom

- **High freedom** (text instructions): Multiple valid approaches, context-dependent decisions
- **Medium freedom** (pseudocode/parameterized scripts): Preferred pattern exists, some variation OK
- **Low freedom** (specific scripts): Fragile operations, consistency critical, exact sequence required

### Anatomy of a Skill

```
skill-name/
├── SKILL.md (required)
│   ├── YAML frontmatter (name + description, required)
│   └── Markdown instructions (required)
└── Bundled Resources (optional)
    ├── scripts/, Executable code (Python/Bash/etc.)
    ├── references/, Documentation loaded into context as needed
    └── assets/, Files used in output (templates, icons, fonts)
```

#### Frontmatter

- `name`: Skill name (hyphen-case, lowercase)
- `description`: Primary triggering mechanism. Include what the skill does AND when to use it. All "when to use" info goes here, not in the body.

#### Scripts (`scripts/`)

The rest: https://github.com/swarmclawai/swarmclaw/blob/HEAD/skills/skill-creator/SKILL.md