skill-builder

A workflow for creating or restructuring reusable coding-agent skills with clear triggers, boundaries, instructions, and test cases.

In plain words
What is it for?
Use it to build skill directories, define when a skill should or should not run, add references and examples, update prompt cases, and run structural and behavioral checks.
Why use it?
It prevents new skills from duplicating existing ones or lacking clear conditions, outputs, safety limits, and ways to verify their behavior.

Skill for Claude CodeCodex

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.

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

Made for: Claude Code, Codex.

Per session 61 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 561 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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 $0.00061 $0.00561
Opus 5 $0.00030 $0.00280
Sonnet 5 $0.00012 $0.00112
Haiku 4.5 $0.00006 $0.00056

Measured 3d ago against content hash feb8bab649b6, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

skill-builder 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 3d 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.

.agents/skills/skill-builder/SKILL.md · 51 lines

What it actually says

技能构建技能 (skill-builder)

Purpose

建立职责明确、可触发、可验证并与三路由及风险门禁一致的可复用技能,而不是增加百科式说明。

Trigger

  • 新能力无法由现有 Skill 合理承担。
  • 现有 Skill 需要重构其触发边界、契约或验证方式。
  • 纯文案调整或通用 Agent 行为不需要新 Skill。

Required context

  • 当前 AGENTS.md
  • 1~2 个职责最接近的现有 Skill 及阶段契约。
  • 新能力的触发/非触发场景、输入、输出、合格标准和红线。
  • 至少一个正例、一个边界反例和可自动检查的行为用例。

Workflow

  1. 先证明职责不与现有 Skill 重叠,并确定三路由中的位置。
  2. 创建 SKILL.mdagents/openai.yaml 和必要的 references/stage-contract.md
  3. SKILL.md 使用 Purpose、Trigger、Required context、Workflow、Output、Stop or escalate、References 七个统一章节。
  4. 将详细模板、检查表和 Examples 放入阶段契约,入口保持短而明确。
  5. 更新 Prompt 用例集、YAML 展示信息和相关文档。
  6. 运行结构校验、YAML 解析、Prompt 契约评测、构建与验证。

Output

  • 完整技能目录和职责说明。
  • 触发/非触发边界、阶段契约与 Examples。
  • agents/openai.yaml 展示名、描述和显式引用 $skill-name 的默认提示。
  • 新增或更新的行为用例和验证证据。

Stop or escalate

  • 职责可由现有 Skill 承担:修改现有 Skill,不新增目录。
  • 变更破坏三路由、风险分级、权限或发布边界:停止并请求确认。
  • 没有可测试边界或只复制通用行为:打回。
  • 变更降低交付、审查、隐私或发布标准:不得实施。

References

执行前读取 stage-contract.md

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. 3d ago First seen · 51 lines · 61 tokens per session scan A feb8bab649b6

Subscribe to this mod's changes

skill-builder is a skill published in the GitHub repository arctan303/creator.skill (20 stars, last pushed 29d ago), licensed MIT. It adds 61 tokens to every session and 561 once invoked, about $0.0003 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

sentry-fix-issues

Find and fix issues from Sentry using MCP. Use when asked to fix Sentry errors, debug production issues, investigate exceptions, or resolve bugs reported in Sentry. Methodically analyzes stack traces, breadcrumbs, traces, and context to identify root causes.

openclaw/clawhub · 58 tokens

agent-sop-author

Create (or update) and validate Agent SOPs (Standard Operating Procedures) - markdown-based workflows that guide AI agents through complex, multi-step tasks with RFC 2119 constraints.

strands-agents/agent-sop · 41 tokens

skill-creator

Create or improve Zhin Agent skills (SKILL.md). Use when asked to add a skill, write SKILL.md, document a repeatable agent workflow, or refine skill frontmatter/keywords. Triggers: 创建技能, 写 SKILL, skill-creator, 加 skill.

zhinjs/zhin · 61 tokens

agent-team

Build low-context multi-agent teams with durable handoff, independent review, and user gates. Use when a project needs separate management, execution, and review roles.

AidenXu-1/agent-team-skill · 35 tokens

agent-team

Build low-context multi-agent teams with durable handoff, independent review, and user gates. Use when a project needs separate management, execution, and review roles.

AidenXu-1/agent-team-skill · 35 tokens

icode

端到端编码工作流(步骤 06,含可选需求初稿步骤与日志根因分析入口),支持分步手动调用:/icode help (帮助), /icode install (MCP 环境检查+一键安装), /icode init [ ] (需求初稿), /icode log [零散信息...] (日志根因分析→转修复需求), /icode start (全流程), /icode fast (精简全流程), /icode plan (计划), /icode review [N] (审查), /icode merge (定稿), /icode code (编码), /icode deepcheck (复检), /icode audit (终审)…

ayukyo/icode-skill · 388 tokens