Skip to content

Skill Creator Guide

Guides the agent to create or update well-structured SKILL.md agent skills

Stars
7,638
Licence
Apache-2.0
Files
1 file

What it does

When you ask the agent to make a new skill (or change an existing one), this skill gives it a set of design rules: keep instructions short, match the level of detail to how fragile the task is, put detailed reference material in separate files, and avoid clutter like README files. It is a how-to guide for writing skills rather than a tool that does a specific job itself. It contains only instructions; it does not include scripts, templates or network calls.

Great for

  • Developers who want to write their own agent skills and want consistent structure
  • Teams building internal skill libraries who want a shared set of authoring conventions
  • People new to agent skills who want the agent to walk them through the format

Skip it if

  • Anyone expecting it to do a domain task (it only teaches how to build skills, so the output depends on your own specifications) because it has no bundled tools or templates
  • Users wanting a finished, verified skill out of the box, since the guidance does not test or validate the skill files it helps produce

Try asking

  • “Create a new skill that teaches you how to write weekly sales reports from our CSV exports”
  • “Update my existing code-review skill so the description says when it should trigger”
  • “Help me set up the folder structure and SKILL.md frontmatter for a skill about our brand style guide”
Step-by-step guide: how to use Skill Creator GuideInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the Apache-2.0 licence and an attribution note.

    create-skill.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip create-skill.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip create-skill.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Describe the domain, the tasks the skill should handle and example requests so the agent can write a precise description field that triggers the skill correctly
  • Review the generated SKILL.md before installing it, since skills shape how the agent behaves and can include scripts you should check
  • Ask for detailed reference material to go in a references/ folder rather than in SKILL.md to keep the main file lean

What's inside

  • SKILL.md

Redistributed unmodified from tailcallhq/forgecode under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.