skill-creator

skill-creator is a skill for Claude Code from HezaoHezao/poirot. It costs 15 tokens per session (834 once invoked), scanned A, original, MIT.

A guide for creating and improving reusable skills for coding agents through drafts, test prompts, evaluation, and revision.

In plain words
What is it for?
It helps write SKILL.md files, design test prompts, assess results, and refine skills over several iterations.
Why use it?
It gives a repeatable way to check whether a skill behaves as intended instead of relying on a single draft.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter.

Good fit It helps write SKILL.md files, design test prompts, assess results, and refine skills over several iterations.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/hezaohezao/poirot/skill-creator
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add HezaoHezao/poirot --skill skill-creator
Clone the repo
git clone --depth 1 https://github.com/HezaoHezao/poirot

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for skill-creator

README.md
[![agentmods](https://agentmods.dev/badge/skills/hezaohezao/poirot/skill-creator/github.svg)](https://agentmods.dev/skills/hezaohezao/poirot/skill-creator)
Your own site
<a href="https://agentmods.dev/skills/hezaohezao/poirot/skill-creator"><img src="https://agentmods.dev/badge/skills/hezaohezao/poirot/skill-creator/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for skill-creator

Your own site · 80×15
<a href="https://agentmods.dev/skills/hezaohezao/poirot/skill-creator"><img src="https://agentmods.dev/badge/skills/hezaohezao/poirot/skill-creator.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 15 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 834 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00015 $0.00834
Opus 5 $0.00008 $0.00417
Sonnet 5 $0.00003 $0.00167
Haiku 4.5 $0.00002 $0.00083

Measured 10d ago against content hash 0f6ce8b41b21, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

skill-creator scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

poirot/backend/agents/skill/builtin_skills/core/skill-creator/SKILL.md · 97 lines

How it starts

The opening of the file, as written. The whole thing — 97 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Skill Creator

A skill for creating new skills and iteratively improving them.

At a high level, the process of creating a skill goes like this:

  • Decide what you want the skill to do and roughly how it should do it
  • Write a draft of the skill (a SKILL.md with YAML frontmatter + Markdown body)
  • Create a few test prompts and run them with the skill injected
  • Help the user evaluate the results both qualitatively and quantitatively
  • Rewrite the skill based on feedback from the user's evaluation
  • Repeat until you're satisfied
  • Expand the test set and try again at larger scale

Your job when using this skill is to figure out where the user is in this process and then jump in and help them progress through these stages.

Poirot skill format

A Poirot skill lives in a directory containing SKILL.md:

skills/<category>/<skill-name>/SKILL.md      # user skills
poirot/backend/agents/skill/builtin_skills/<category>/<skill-name>/SKILL.md   # builtin

Frontmatter fields:

---
name: <skill-name>            # unique, lowercase-hyphenated
description: <≤60 char one sentence ending with a period>
allowed-tools:                # Poirot tools this skill may invoke
  - web_search
  - browse_page
  - bash
  - read_file
  - write_file
  - list_dir
  - str_replace
  - present_files
  - read_snapshot
enabled: true
related-skills: [<other-skill-name>]   # optional cross-references
license: MIT                  # recommended for contributed skills
author: <human contributor or source attribution>
---

Body: # <Skill> title, 2-3 sentence intro, ## When to Use, ## How to Run, ## Procedure, ## Pitfalls, ## Verification.

Authoring standards

  1. description ≤ 60 characters, one sentence, ends with a period. State the capability, not the implementation. No marketing words.
  2. Tools referenced in prose must be native Poirot tools (listed above) or MCP servers the skill explicitly expects. Do NOT name shell utilities the agent already has wrapped — grepbash, cat/head/tailread_file, sed/awkstr_replace, find/lslist_dir.
  3. Scripts go in scripts/, references in references/, templates in templates/ inside the skill directory. Don't expect the model to inline-write non-trivial logic every call — ship a helper script.
  4. Keep the body focused: ~100 lines for a simple skill, ~200 for complex.

Read the full file on GitHub · 97 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 10d ago First seen · 97 lines · 15 tokens per session scan A 0f6ce8b41b21

Subscribe to this mod's changes

skill-creator is a skill published in the GitHub repository HezaoHezao/poirot (217 stars, last pushed 1mo ago), licensed MIT. It adds 15 tokens to every session and 834 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

commit

Atomic git commit with conventional message. Use when the user says "commit", "save my changes", "commit this", or wants to create a git commit. Stages specific files, writes a conventional commit message with body explaining non-obvious decisions. Never uses git add -A.

congchuanling-dot/Cohort · 59 tokens

python-run

Run and debug Python scripts in the project. Use when the user says "run python", "execute this script", "debug this py file", or wants to run/modify a .py file. Handles dependency checks, linting, execution, and error analysis.

congchuanling-dot/Cohort · 56 tokens

hqe

Comprehensive codebase health auditing, remediation, and verification skill based on the canonical HQE Protocol v5.0.0.

spearchucker667/Skill-HQE · 29 tokens

cost-efficiency-analyzer

Analyzes cost structure, cost efficiency, and expense management from P&L data. Use when the user asks about costs, expenses, COGS, operating expenses, cost ratios, cost control, spending efficiency, margin compression from cost side, or wants to understand where money is going. Also use for "are we spending too…

awslabs/agentcore-samples · 98 tokens

computer-use

Read and drive native desktop applications through the accessibility layer — list on-screen apps, snapshot one window as a numbered element tree, then click / type / set a value / scroll / drag / run a named action, by element index or by screen coordinates. Use for work in a desktop app rather than a web page. Full…

kirodotdev/KiroCrew · 105 tokens

goal-conductor

Own a long-horizon goal end to end - decompose it into work items, stand up one top-level session per item, patrol their state on a nudge loop, and decide each next round until the goal is met or a stop condition fires. Use when the user hands over a goal too large for one session ("clear the flaky-test backlog"…

kirodotdev/KiroCrew · 105 tokens