Agent skill

Create Skill

by tamdogood in tamdogood/builder-essential-skills

Create or update a complete repository skill from a user's idea, including the workflow instructions, references, scripts or assets, agent metadata, skill-card artwork, cinematic banner artwork…

MITAuto-check passedDevelopment

Install Create Skill

skills CLI
$ npx skills add tamdogood/builder-essential-skills --skill create-skill -a claude-code

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

GitHub CLI
$ gh skill install tamdogood/builder-essential-skills create-skill --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/tamdogood/builder-essential-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/create-skill .claude/skills/create-skill && 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
create-skill
GitHub stars
219
Token cost
~1.4k tokens
SKILL.md length
639 words
Files
4 (incl. references)
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

Create or update a complete repository skill from a user's idea, including the workflow instructions, references, scripts or assets, agent metadata, skill-card artwork, cinematic banner artwork…

  • Works in 7 steps: Orient the repository. Read AGENTS.md,… → Define the contract. Extract the skill… → Choose the smallest useful structure.… → …
  • The user asks to create a new skill
  • SKILL.md covers Workflow, Skill content requirements, Artwork routing and Validation commands
  • Calls git, python3 and npm

What it does

Create Skill is an agent skill from tamdogood/builder-essential-skills. Create or update a complete repository skill from a user's idea, including the workflow instructions, references, scripts or assets, agent metadata, skill-card artwork, cinematic banner artwork, README links, discovery metadata, and validation. Use when the user asks to create a new skill, add a skill to this collection, turn a workflow into a reusable skill, or make a skill's documentation and artwork consistent with the repository.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `README.md`, `agents/openai.yaml` and `references/artwork.md`).

It sits in Development, covering Technical documentation. The repository describes itself as: A repository for skills that are essential to my daily work. The licence is MIT.

When your agent uses it

  • The user asks to create a new skill
  • Add a skill to this collection
  • Turn a workflow into a reusable skill
  • Make a skills documentation and artwork consistent with the repository

Example prompts

  • “/create-skill”

Requirements

  • Python 3

Workflow steps

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

  1. Orient the repository. Read AGENTS.md, the root README.md, the nearest existing skill with a similar purpose, and any local lessons file…
  2. Define the contract. Extract the skill slug, purpose, audience, trigger phrases, inputs, outputs, and acceptance checks from the request…
  3. Choose the smallest useful structure. Create only the resources the skill needs
  4. Write the skill. Use imperative instructions. State the decision points, required tools, file paths, invariants, failure handling, and…
  5. Create the required artwork. In this repository, every new skill needs assets/skill-cards/.svg and a linked row in the root README's Pick…
  6. Wire every discovery surface. Update all surfaces that explicitly enumerate skills: the root README card table, the skill README…
  7. Validate before handoff. Run the skill validator, parse the SVG, inspect the rendered card and banner, check every new README link, run…

What it can do on your machine

Read from SKILL.md and the folder at commit 1be9984. 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

    Shell commands in SKILL.md call:

    • git
    • python3
    • npm

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

  • Network

    No URLs in SKILL.md. Its commands use git and npm, which can reach the network depending on how they are called.

    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

Create Skill loads about 1.4k tokens when it runs, and up to ~3.4k if it reads all its reference files. Until then it costs about 113 tokens; SKILL.md has 639 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~113
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.4k

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 tamdogood/builder-essential-skills at commit 1be9984, republished under its MIT licence (© tamdogood). 639 words, ~1,357 tokens.

Download SKILL.mdSave it as .claude/skills/create-skill/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
create-skill
description
Create or update a complete repository skill from a user's idea, including the workflow instructions, references, scripts or assets, agent metadata, skill-card artwork, cinematic banner artwork, README links, discovery metadata, and validation. Use when the user asks to create a new skill, add a skill to this collection, turn a workflow into a reusable skill, or make a skill's documentation and artwork consistent with the repository.

Create Skill

Turn a skill idea into a complete, discoverable, and shippable skill folder. Treat the skill instructions, metadata, artwork, README wiring, and validation as one deliverable.

Workflow

  1. Orient the repository. Read AGENTS.md, the root README.md, the nearest existing skill with a similar purpose, and any local lessons file. Inspect package.json, skills.sh.json, the installer, and the existing assets/skill-cards/ and assets/skill-banners/ conventions before editing.

  2. Define the contract. Extract the skill slug, purpose, audience, trigger phrases, inputs, outputs, and acceptance checks from the request. Normalize the slug to lowercase hyphen-case. Preserve the user's terminology, but make the frontmatter description explicit about both the capability and the situations that should trigger it.

  3. Choose the smallest useful structure. Create only the resources the skill needs:

    • skills/<slug>/SKILL.md for the core workflow and routing rules.
    • skills/<slug>/agents/openai.yaml for display metadata and an explicit $<slug> default prompt.
    • skills/<slug>/references/ for detailed domain guidance that should load progressively.
    • skills/<slug>/scripts/ only for deterministic, repeatable automation.
    • skills/<slug>/assets/ only for files the skill will reuse in its outputs.
    • skills/<slug>/README.md because this repository documents every published skill.

    Keep SKILL.md under 500 lines. Put deep specifications and long examples in one-level-deep references and link them directly from the skill.

  4. Write the skill. Use imperative instructions. State the decision points, required tools, file paths, invariants, failure handling, and verification commands another agent cannot safely infer. Prefer a short workflow in SKILL.md and conditional links such as references/artwork.md for specialized work.

  5. Create the required artwork. In this repository, every new skill needs assets/skill-cards/<slug>.svg and a linked row in the root README's Pick a skill table. When the collection uses cinematic banners, also create assets/skill-banners/<slug>.webp and use the banner in the root and skill READMEs. Read references/artwork.md before creating either asset.

  6. Wire every discovery surface. Update all surfaces that explicitly enumerate skills: the root README card table, the skill README, skills.sh.json groupings, and any registry or installer allowlist discovered during orientation. Do not invent a new registry file. Confirm that package.json already includes the skills/ and assets/ trees; change it only if the package would otherwise omit the new files.

  7. Validate before handoff. Run the skill validator, parse the SVG, inspect the rendered card and banner, check every new README link, run the repository test suite, and run git diff --check. Review the diff for stale names, placeholder text, missing metadata, broken relative paths, untracked required assets, and accidental unrelated edits.

Show full SKILL.md (239 more words)Show less

Skill content requirements

Include these sections when relevant:

  • Scope and trigger behavior: what the skill handles and what it should not handle.
  • Inputs and outputs: expected files, links, user decisions, and final artifacts.
  • Workflow: the smallest reliable sequence, with explicit branch points.
  • Resources: when to read each reference or run each script.
  • Validation: concrete commands and visual or semantic acceptance checks.
  • Failure handling: what to do when a tool, dependency, reference, or user choice is missing.

Never leave TODO markers, template prose, guessed tool names, or unsupported claims in a published skill. Avoid duplicating long reference material in SKILL.md.

Artwork routing

Use the built-in image-generation tool for a new raster banner. First inspect two or more existing banners and any user-provided reference images. Treat references as style and composition guidance, not as content to copy. Generate a wide cinematic scene with exact title text only when the tool can render it reliably; inspect the result and iterate on one targeted issue at a time. Save the final project asset as WebP and keep the SVG card deterministic and accessible.

For the detailed visual system, prompt template, composition rules, conversion commands, and review checklist, read references/artwork.md.

Validation commands

From the repository root, adapt these commands to the local toolchain:

bash
python3 "${CODEX_HOME:-$HOME/.codex}/skills/.system/skill-creator/scripts/quick_validate.py" skills/<slug>
xmllint --noout assets/skill-cards/<slug>.svg
npm test
git diff --check

If a command is unavailable, use the repository's documented equivalent and report the substitution. Do not call the work complete while required files are untracked or a validation check is red.

© tamdogood, 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 3 other files (references) in skills/create-skill of tamdogood/builder-essential-skills.

  • SKILL.md
  • README.md
  • agents/openai.yaml
  • references/artwork.md

Open the folder on GitHubat commit 1be9984

Compare with similar skills

Create Skill 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.

Create Skill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Create Skill this skilltamdogood/builder-essential-skills219—~1.4kAutomated safety check: PassMIT
Diagram Designcathrynlavery/diagram-design45k1 repos~7.5kAutomated safety check: PassMIT
Simple Englishmoeru-ai/airi50k2 repos~4.6kAutomated safety check: PassMIT
Get API Docs with chubandrewyng/context-hub14k2 repos~775Automated safety check: PassMIT
Doc SyncJetBrains/ideavim10k2 repos~2.6kAutomated safety check: PassMIT
Mailspring App ScreenshotsFoundry376/Mailspring18k—~1.5kAutomated safety check: PassGPL-3.0

Similar skills

  • Diagram Design

    cathrynlavery/diagram-design

    Creates branded diagrams, from architecture, flowchart and sequence to charts and maps, as self-contained HTML with inline SVG, with import from draw.io, Mermaid and Excalidraw.

    45k GitHub starsUsed in 1 repo~7.5k tokens
    DevelopmentAuto-check passed
  • Simple English

    moeru-ai/airi

    Write or rewrite technical text with the rules of ASD-STE100 Simplified Technical English so it is clear, unambiguous, and free of AI slop.

    50k GitHub starsUsed in 2 repos~4.6k tokens
    DevelopmentAuto-check passed
  • Get API Docs with chub

    andrewyng/context-hub

    Fetches current documentation for third-party APIs and SDKs with the chub CLI before the agent writes code against them, instead of relying on remembered API shapes.

    14k GitHub starsUsed in 2 repos~775 tokens
    DevelopmentAuto-check passed
  • Doc Sync

    JetBrains/ideavim

    Official

    Keeps IdeaVim documentation in sync with code changes. An agent skill from JetBrains/ideavim.

    10k GitHub starsUsed in 2 repos~2.6k tokens
    DevelopmentAuto-check passed
  • Mailspring App Screenshots

    Foundry376/Mailspring

    Captures screenshots of the running Mailspring dev app for docs, PRs or visual checks by launching it with a debugging port, driving the UI and clipping to an element.

    18k GitHub stars~1.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Draw.io Diagram Studio

    Agents365-ai/drawio-skill

    Creates and edits editable draw.io diagrams from descriptions, code, infrastructure files, SQL and API schemas, with sync, review, test and export tools.

    10k GitHub stars~2.4k tokensUpdated 6 days ago
    DevelopmentAuto-check: notes

More from tamdogood/builder-essential-skills

All 18 skills in this repo
  • Create Marketing Kit

    tamdogood/builder-essential-skills

    Create truthful, human-centered marketing campaigns for an app or product, including positioning, channel copy, original artwork, editable layouts, README banners, and selective website integration.

    219 GitHub stars~1.9k tokensUpdated 1 mo ago
    Auto-check passed
  • Name Your Business

    tamdogood/builder-essential-skills

    Generate, refine, compare, and when needed validate distinctive names for startups, AI products, developer tools, protocols, open-source projects, apps, product families, local businesses, services…

    219 GitHub stars~4.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Session Profiler

    tamdogood/builder-essential-skills

    Profile and debug Hermes sessions from their JSONL transcripts.

    219 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Build Scenario Tests

    tamdogood/builder-essential-skills

    Inspect an unfamiliar repository, turn a focused Markdown behavior scenario into a deterministic test in the repository's native test stack, run it, and preserve traceability between intent and code.

    219 GitHub stars~1.7k tokensUpdated 1 mo ago
    Auto-check passed
  • Paper Opportunity Radar

    tamdogood/builder-essential-skills

    Run a cumulative daily or retrospective sweep of research papers on a chosen topic, audit their claims, methods, integrity signals, and independent support, then identify overlooked but feasible…

    219 GitHub stars~3.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Repo System Map

    tamdogood/builder-essential-skills

    Analyze a software repository at the latest remote main commit and turn its implemented architecture into a citation-backed interactive isometric system map with a legend, selectable infrastructure…

    219 GitHub stars~3k tokensUpdated 1 mo ago
    Auto-check: notes

Categories

Questions about Create Skill

What does Create Skill do?

Create or update a complete repository skill from a user's idea, including the workflow instructions, references, scripts or assets, agent metadata, skill-card artwork, cinematic banner artwork…. Create Skill is an agent skill from tamdogood/builder-essential-skills. Create or update a complete repository skill from a user's idea, including the workflow instructions, references, scripts or assets, agent metadata, skill-card artwork, cinematic banner artwork, README links, discovery metadata, and validation.

When should I use Create Skill?

Create Skill fits situations like: the user asks to create a new skill; add a skill to this collection; turn a workflow into a reusable skill; make a skills documentation and artwork consistent with the repository.

How do I install Create Skill in Claude Code?

Run `npx skills add tamdogood/builder-essential-skills --skill create-skill -a claude-code`. Or copy the skill folder (skills/create-skill in tamdogood/builder-essential-skills) into .claude/skills/create-skill in your project. Claude Code loads it when a task matches its description.

How do I install Create Skill in Codex?

Run `npx skills add tamdogood/builder-essential-skills --skill create-skill -a codex`. Or copy the skill folder (skills/create-skill in tamdogood/builder-essential-skills) into .agents/skills/create-skill in your project. Codex loads it when a task matches its description.

Can I use Create Skill 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 tamdogood/builder-essential-skills --skill create-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/create-skill, .gemini/skills/create-skill, .github/skills/create-skill and .opencode/skills/create-skill in your project.

What does Create Skill need to run?

Going by SKILL.md and its folder, Create Skill needs the command-line tools its instructions call (git, python3 and npm). Our summary lists: Python 3.

Does Create Skill access the network?

SKILL.md contains no URLs. Its commands use git and npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Create Skill 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 Create Skill use?

Create Skill 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 Create Skill use?

About 1.4k tokens (SKILL.md is roughly 5.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.1k tokens, read only when the agent opens those files.

What are the alternatives to Create Skill?

Skills that share tags, products or a category with Create Skill: Diagram Design (cathrynlavery/diagram-design, 45k stars), Simple English (moeru-ai/airi, 50k stars), Get API Docs with chub (andrewyng/context-hub, 14k stars) and Doc Sync (JetBrains/ideavim, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Create Skill?

tamdogood (a GitHub user) maintains it in tamdogood/builder-essential-skills, which has 219 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on August 16, 2026.

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