Agent skill

Skill Creator

by WrongStack in WrongStack/WrongStack

A skill your agent uses when the user wants to create or improve a WrongStack skill (SKILL.md).

MITAuto-check passedAgent Workflows

Install Skill Creator

skills CLI
$ npx skills add WrongStack/WrongStack --skill skill-creator -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install WrongStack/WrongStack skill-creator --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/WrongStack/WrongStack.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/core/skills/skill-creator .claude/skills/skill-creator && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
skill-creator
GitHub stars
370
Token cost
~2.1k tokens
SKILL.md length
923 words
Files
2
Skills in repo
38
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user wants to create or improve a WrongStack skill (SKILL.md).

  • Works in 7 steps: Write a complete description (1–1024… → Name must be kebab-case: my-skill,… → Skills live in… → …
  • The user wants to create
  • SKILL.md covers Overview, Rules, Authoring commands (use these) and Patterns, plus 8 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Skill Creator is an agent skill from WrongStack/WrongStack. Use this skill when the user wants to create or improve a WrongStack skill (SKILL.md). Triggers: user says "create a skill", "new skill", "add a skill", "skill definition".

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `SKILL.save.md`).

It sits in Agent Workflows, covering Skill authoring. The repository describes itself as: An AI coding agent that reads your code, edits files, runs commands, and reasons through bugs — across a terminal REPL, a full-screen TUI, and a browser UI, while you keep your… The licence is MIT.

When your agent uses it

  • The user wants to create
  • Improve a WrongStack skill (SKILL.md)

Example prompts

  • “create a skill”
  • “new skill”
  • “add a skill”
  • “/skill-creator”

Requirements

  • Docker

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Write a complete description (1–1024 characters) explaining what the skill does and when to use it. The full description is disclosed to…
  2. Name must be kebab-case: my-skill, docker-deploy — lowercase, hyphens only.
  3. Skills live in .wrongstack/skills//SKILL.md (project level).
  4. After the trigger sentence, add Triggers: user says "X", "Y", "Z"..
  5. Content must be actionable — rules, patterns, anti-patterns, not just prose.
  6. End with "Skills in scope" listing related skills for delegation.
  7. Don't let skill names collide with existing skills.

What it can do on your machine

Read from SKILL.md and the folder at commit 57f6018. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Skill Creator loads about 2.1k tokens when it runs. Until then it costs about 47 tokens; SKILL.md has 923 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~47
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from WrongStack/WrongStack at commit 57f6018, republished under its MIT licence (© WrongStack). 923 words, ~2,106 tokens.

Download SKILL.mdSave it as .claude/skills/skill-creator/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
skill-creator
description
Use this skill when the user wants to create or improve a WrongStack skill (SKILL.md). Triggers: user says "create a skill", "new skill", "add a skill", "skill definition".
version
1.3.0
required-capabilities
filesystem.write, runtime.admin
required-tools
bash, skill

Skill Creator — WrongStack

Overview

Guides the creation of new WrongStack skills. A skill is a Markdown file with YAML frontmatter — the full description tells the model when to use it. You are the wizard: ask questions, validate answers, write the file. Use the /skill-gen sub-commands to do the mechanical parts (validation, scaffolding) deterministically.

Rules

  1. Write a complete description (1–1024 characters) explaining what the skill does and when to use it. The full description is disclosed to the model.
  2. Name must be kebab-case: my-skill, docker-deploy — lowercase, hyphens only.
  3. Skills live in .wrongstack/skills/<name>/SKILL.md (project level).
  4. After the trigger sentence, add Triggers: user says "X", "Y", "Z"..
  5. Content must be actionable — rules, patterns, anti-patterns, not just prose.
  6. End with "Skills in scope" listing related skills for delegation.
  7. Don't let skill names collide with existing skills.

Authoring commands (use these)

The /skill-gen command is a toolkit — pick the right sub-command for the job instead of writing files by hand:

Sub-commandWhen to use
/skill-gen (bare)Open-ended creation: you (the agent) ask questions one at a time, then write the file. Best for nuanced skills.
/skill-gen skeleton <name> --desc "..." --trigger a,bQuick scaffold: generates a valid SKILL.md skeleton the user edits. Use when the name + trigger are already known.
/skill-gen from-prompt "<text>"Turn an existing prompt/instruction into a skill draft. Use when the user hands you a prompt and says "make this a skill".
/skill-gen validate <name>Validate an existing skill file, or check a proposed name before writing.
/skill-gen view <name>Read-only: show a skill's body.
/skill-gen edit <name>Open the skill in $EDITOR/$VISUAL.
/skill-gen listList skills with their source layer.

After writing a skill with the wizard flow, run /skill reload, then /skill-gen validate <name> to check its YAML, name, field limits, and body. Use /skill use <name> <task> to explicitly apply it. Skeletons and prompt drafts refresh the loader automatically.

Patterns

Do
markdown
---
name: docker-deploy
description: |
  Use this skill when deploying Docker containers to a production cluster.
  Triggers: user says "docker", "container", "deploy", "dockerfile", "image".
version: 1.0.0
---

# Docker Deploy — WrongStack

## Overview
...
## Rules
...
## Patterns
...
## Skills in scope
Don't
markdown
---
name: MySkill # ❌ PascalCase
name: my_skill      # ❌ underscore
description: |
  This skill is about Docker.  # ❌ no trigger sentence
---

Skill format

Every skill is a Markdown file with YAML frontmatter:

markdown
---
name: my-skill-name
description: |
  Use this skill when <trigger situation>.
  Triggers: user says "keyword", "another keyword".
version: 1.0.0
---

# Skill Title

## Overview
What this skill does.

## Rules
- Rule 1
- Rule 2

## Patterns
### Do
\`\`\`ts
// good example
\`\`\`

### Don't
\`\`\`ts
// bad example
\`\`\`

## Workflow
1. Step one
2. Step two

File structure

A skill is a directory containing SKILL.md plus optional resource subdirectories (the agentskills.io layout):

<name>/
  SKILL.md            ← required: metadata + instructions
  scripts/            ← optional: executable code (run via bash)
  references/         ← optional: docs loaded on demand (REFERENCE.md, …)
  assets/             ← optional: templates, data, snippets
  …                   ← any other subdirectories

Skills live under these paths (priority order, first-seen wins by name):

  1. Project: <project>/.wrongstack/skills/<name>/
  2. Project foreign: <project>/.claude/skills/<name>/, <project>/.{codex,cursor,agents,…}/skills/<name>/
  3. User profile: ~/.wrongstack/profiles/<profile>/skills/<name>/
  4. User foreign: ~/.claude/skills/<name>/, ~/.{codex,cursor,agents,…}/skills/<name>/
  5. Bundled: packages/core/skills/<name>/ (read-only, core team)

For user-created skills: always use path 1 (project level).

Resource files (scripts / references / assets)

Bundled resources are NOT injected into the prompt — the agent loads them on demand via the skill tool (agentskills.io progressive disclosure, tier 3):

  • skill({ name: "<name>" }) → lists every bundled file (scripts/, references/, assets/, any subdir, recursively).
  • skill({ name: "<name>", resource: "references/REF.md" }) → returns that file's content. Scripts come back with an absolute path so the agent runs them via bash.

Keep SKILL.md under ~500 lines; move deep reference material into references/. Reference files with relative paths from the skill root. Scripts must be self-contained and safe to run. Only add the subdirectories a skill actually needs — empty directories don't persist in git, so create a file (e.g. scripts/README.md) if you want the directory tracked.

Workflow

  1. Ask the name — suggest kebab-case, validate format
  2. Ask the trigger — "What situation should activate this skill?"
  3. Ask the coverage — what rules, patterns, workflows?
  4. Generate the SKILL.md — write to .wrongstack/skills/<name>/SKILL.md
  5. Confirm — show the path, remind them to use /skill to list skills
Show full SKILL.md (369 more words)Show less

Validation Checklist

Before writing the file, verify:

  • Name is valid kebab-case
  • Name doesn't collide with existing skills
  • Description has a clear trigger sentence
  • Content is actionable (rules, patterns, not just prose)
  • File will be placed in .wrongstack/skills/

Out of scope

  • Don't write skills without running /skill-gen validate <name> first. A name that collides with an existing skill or breaks the kebab-case rule is a wall hit after the file is written. Validate first, always.
  • Don't ship a skill with a vague description. "This skill is about Docker" matches nothing. First sentence = trigger; rest = Triggers: user says "..." listing concrete keywords.
  • Don't name skills in PascalCase or with underscores. MySkill and my_skill are wrong; only my-skill (kebab-case) loads. The loader rejects the others.
  • Don't place project skills outside .wrongstack/skills/<name>/. Bundled, user-profile, and foreign paths are for other owners. User-created skills always go in the project directory.
  • Don't write prose-only skills. Rules, patterns, anti-patterns, code examples — the content has to be actionable. Prose without a checkable rule does not constrain the model.
  • Don't skip "Skills in scope". Without the hand-off list, the model doesn't know where to delegate adjacent questions. The list is what makes the skill part of a system.
  • Don't forget to bump the version on structural change. New section, scope change, rule change → major or minor bump. Patch only for wording.
  • Don't move work into the skill that belongs in /skill-gen. The sub-commands are the deterministic layer: validation, scaffolding, from-prompt conversion. The wizard is for the parts they can't do.

Before returning

  • Name is kebab-case; /skill-gen validate <name> passed
  • Name doesn't collide with bundled, project, or user-profile skills
  • First sentence of description is a concrete trigger; trigger keywords follow
  • File path is .wrongstack/skills/<name>/SKILL.md for project skills
  • Content is actionable: rules, patterns, anti-patterns, code examples
  • "Out of scope" lists what the skill is NOT for and where to hand off
  • "Before returning" gives the model a mechanical completion check
  • "Skills in scope" names the hand-off targets and the reason for each
  • Version bumped appropriately; change recorded in CHANGELOG.md
  • /skill-gen validate <name> re-run after writing; loads cleanly

Skills in scope

  • prompt-engineering — for crafting the skill description and prompt text
  • git-flow — for committing the new skill file
  • output-standards — for standardized <nextsteps> formatting

© WrongStack, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in packages/core/skills/skill-creator of WrongStack/WrongStack.

  • SKILL.md
  • SKILL.save.md

Open the folder on GitHubat commit 57f6018

Compare with similar skills

Skill Creator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Skill Creator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Skill Creator this skillWrongStack/WrongStack370—~2.1kAutomated safety check: PassMIT
Skill CreatorAzure/azqr79589 repos~8.2kAutomated safety check: PassApache-2.0
Claude Code Skill Developer Guidediet103/claude-code-infrastructure-showcase10k11 repos~3.5kAutomated safety check: PassMIT
Darwin Skill Optimizeralchaincyf/darwin-skill6.2k1 repos~4.7kAutomated safety check: PassMIT
Claude Code Command Developmentanthropics/claude-plugins-official38k10 repos~4.8kAutomated safety check: PassApache-2.0
Claude Code Plugin Structureanthropics/claude-plugins-official38k10 repos~3.4kAutomated safety check: PassApache-2.0

Similar skills

  • Skill Creator

    Azure/azqr

    Official

    Create new skills, modify and improve existing skills, and measure skill performance.

    795 GitHub starsUsed in 89 repos~8.2k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Skill Developer Guide

    diet103/claude-code-infrastructure-showcase

    A guide to creating and managing Claude Code skills with auto-activation: skill-rules.json triggers, hooks, enforcement levels, YAML frontmatter and progressive disclosure.

    10k GitHub starsUsed in 11 repos~3.5k tokens
    Agent WorkflowsAuto-check passed
  • Darwin Skill Optimizer

    alchaincyf/darwin-skill

    Scores SKILL.md files on a nine-dimension rubric, then improves them in a keep-or-revert loop with independent judge agents, test prompts, git history and human checkpoints.

    6.2k GitHub starsUsed in 1 repo~4.7k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Command Development

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code slash commands: Markdown files with YAML frontmatter, arguments, file references, bash context and interactive prompts.

    38k GitHub starsUsed in 10 repos~4.8k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Plugin Structure

    anthropics/claude-plugins-official

    Official

    Explains the directory layout, plugin.json manifest and component organization of a Claude Code plugin, including auto-discovery and portable paths.

    38k GitHub starsUsed in 10 repos~3.4k tokens
    Agent WorkflowsAuto-check passed
  • Skill Release Gate

    rohitg00/ai-engineering-from-scratch

    Evaluates an Agent Skill bundle before release for structure, trigger quality, artifact improvement, script correctness, safety, installed-tree integrity and host portability.

    66k GitHub stars~1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed

More from WrongStack/WrongStack

All 38 skills in this repo
  • Design Craft

    WrongStack/WrongStack

    Design or substantially improve user-facing interfaces with a product-specific visual direction, content hierarchy, and rendered critique.

    370 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Design Critique

    WrongStack/WrongStack

    A skill your agent uses to audit an interface that already exists and say precisely why it looks generated, templated, or unfinished — a scored rubric across composition, typography, color, states…

    370 GitHub stars~3k tokensUpdated today
    Auto-check passed
  • Mailbox Bridge

    WrongStack/WrongStack

    A skill your agent uses when external coding agents (Claude Code, Aider, custom scripts) need to participate in the project's shared WrongStack mailbox, or when a user asks to "expose the mailbox"…

    370 GitHub stars~3.9k tokensUpdated today
    Auto-check passed
  • Multi Agent

    WrongStack/WrongStack

    A skill your agent uses whenever work can be split across multiple AI agents running in parallel, or when orchestrating leader/worker patterns in WrongStack.

    370 GitHub stars~3.6k tokensUpdated today
    Auto-check passed
  • Web Platform Baseline

    WrongStack/WrongStack

    Use this skill before asserting that a CSS, HTML or accessibility capability is available, unavailable, or the right tool — it carries dated, refreshable platform facts and refuses to let stale…

    370 GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Wrongstack Mailbox

    WrongStack/WrongStack

    A skill your agent uses when the user wants to communicate with WrongStack's shared project mailbox from outside WrongStack — read messages sent by WrongStack agents, send replies, broadcast to all…

    370 GitHub stars~3.5k tokensUpdated today
    Auto-check passed

Categories

Questions about Skill Creator

What does Skill Creator do?

A skill your agent uses when the user wants to create or improve a WrongStack skill (SKILL.md). Skill Creator is an agent skill from WrongStack/WrongStack.md).

When should I use Skill Creator?

Skill Creator fits situations like: the user wants to create; improve a WrongStack skill (SKILL.md).

How do I install Skill Creator in Claude Code?

Run `npx skills add WrongStack/WrongStack --skill skill-creator -a claude-code`. Or copy the skill folder (packages/core/skills/skill-creator in WrongStack/WrongStack) into .claude/skills/skill-creator in your project. Claude Code loads it when a task matches its description.

How do I install Skill Creator in Codex?

Run `npx skills add WrongStack/WrongStack --skill skill-creator -a codex`. Or copy the skill folder (packages/core/skills/skill-creator in WrongStack/WrongStack) into .agents/skills/skill-creator in your project. Codex loads it when a task matches its description.

Can I use Skill Creator in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add WrongStack/WrongStack --skill skill-creator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/skill-creator, .gemini/skills/skill-creator, .github/skills/skill-creator and .opencode/skills/skill-creator in your project.

What does Skill Creator need to run?

SKILL.md names no scripts, command-line tools or credentials: Skill Creator is instructions for the agent only. Our summary lists: Docker.

Does Skill Creator access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Skill Creator safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Skill Creator use?

Skill Creator is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Skill Creator use?

About 2.1k tokens (SKILL.md is roughly 8.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Skill Creator?

Skills that share tags, products or a category with Skill Creator: Skill Creator (Azure/azqr, 795 stars), Claude Code Skill Developer Guide (diet103/claude-code-infrastructure-showcase, 10k stars), Darwin Skill Optimizer (alchaincyf/darwin-skill, 6.2k stars) and Claude Code Command Development (anthropics/claude-plugins-official, 38k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Skill Creator?

WrongStack (a GitHub organization) maintains it in WrongStack/WrongStack, which has 370 GitHub stars. The repository holds 38 skills in this directory. The repository was last updated on October 7, 2026.

Source: WrongStack/WrongStack on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.