A skill your agent uses when 需要创建新的 AI Agent 技能、改进已有 SKILL.md 文件、设计技能工作流或不确定技能该如何组织时。触发场景:创建技能、新建技能、写技能、技能开发、skill-smith、设计技能、编写SKILL.md、制作技能、开发skill、如何写一个好技能、技能质量不好怎么改进。

MITAuto-check passed

Install Skill Smith

skills CLI
$ npx skills add ProgrammerAnthony/Expert-Coding-Harness --skill skill-smith -a claude-code

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

GitHub CLI
$ gh skill install ProgrammerAnthony/Expert-Coding-Harness skill-smith --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/ProgrammerAnthony/Expert-Coding-Harness.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/skill-smith .claude/skills/skill-smith && 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-smith
GitHub stars
235
Token cost
~847 tokens
SKILL.md length
214 words
Files
5 (incl. references)
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when 需要创建新的 AI Agent 技能、改进已有 SKILL.md 文件、设计技能工作流或不确定技能该如何组织时。触发场景:创建技能、新建技能、写技能、技能开发、skill-smith、设计技能、编写SKILL.md、制作技能、开发skill、如何写一个好技能、技能质量不好怎么改进。

  • Works in 6 steps: :理解需求(必须完成,不可跳过) → :架构规划 → :编写 SKILL.md → …
  • 需要创建新的 AI Agent 技能、改进已有 SKILL.md 文件、设计技能工作流或不确定技能该如何组织时。触发场景:创建技能、新建技能、写技能、技能开发、skill-smith、设计技能、编写SKILL.md、制作技能、开发skill、如何写一个好技能、技能质量不好怎么改进
  • SKILL.md covers 什么是技能, 工作流, 技能目录结构 and 反模式警告, plus 2 more sections
  • Calls npx

What it does

Skill Smith is an agent skill from ProgrammerAnthony/Expert-Coding-Harness. Use when 需要创建新的 AI Agent 技能、改进已有 SKILL.md 文件、设计技能工作流或不确定技能该如何组织时。触发场景:创建技能、新建技能、写技能、技能开发、skill-smith、设计技能、编写SKILL.md、制作技能、开发skill、如何写一个好技能、技能质量不好怎么改进。

Its SKILL.md is about 850 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`, `references/architecture-guide.md` and `references/description-guide.md`).

The repository describes itself as: 生产级 AI Agent 技能集,辅助AI Harness应用于企业开发,覆盖代码审查、代码安全审计、TDD、需求工程、实施计划与子代理编排、架构设计、调试、前端开发与技能创建全流程。 The licence is MIT.

When your agent uses it

  • 需要创建新的 AI Agent 技能、改进已有 SKILL.md 文件、设计技能工作流或不确定技能该如何组织时。触发场景:创建技能、新建技能、写技能、技能开发、skill-smith、设计技能、编写SKILL.md、制作技能、开发skill、如何写一个好技能、技能质量不好怎么改进

Example prompts

  • “/skill-smith”

Requirements

  • Node.js

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. :理解需求(必须完成,不可跳过)
  2. :架构规划
  3. :编写 SKILL.md
  4. :编写 References
  5. :质量检查
  6. :README.md

What it can do on your machine

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

    • npx

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

  • Network

    No URLs in SKILL.md. Its commands use npx, 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

Skill Smith loads about 847 tokens when it runs, and up to ~3.2k if it reads all its reference files. Until then it costs about 41 tokens; SKILL.md has 214 words of instructions outside code blocks.

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

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 ProgrammerAnthony/Expert-Coding-Harness at commit ab0b827, republished under its MIT licence (© ProgrammerAnthony). 214 words, ~847 tokens.

Download SKILL.mdSave it as .claude/skills/skill-smith/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
skill-smith
description
Use when 需要创建新的 AI Agent 技能、改进已有 SKILL.md 文件、设计技能工作流或不确定技能该如何组织时。触发场景:创建技能、新建技能、写技能、技能开发、skill-smith、设计技能、编写SKILL.md、制作技能、开发skill、如何写一个好技能、技能质量不好怎么改进。

技能铸造师

铁律:每一行内容都要对得起 token 消耗。不写 Claude 已经知道的东西,只写它不知道的领域知识、流程规范和决策框架。

什么是技能

技能是给 AI Agent 的"专项培训手册"——把它从通用助手变成领域专家。好的技能应该:

  • 提供 Claude 不具备的领域知识或流程约束
  • 让输出更一致、更可预测
  • 减少用户每次都要重复解释的上下文

工作流

Step 1:理解需求(必须完成,不可跳过)

至少收集 3 个具体的使用示例:

询问用户:
"请给我 3 个你会如何使用这个技能的具体例子,
包括你会说什么,以及你期望得到什么输出。"

没有 3 个具体例子,不进入下一步。

同时了解:

  • "现在没有这个技能时,你是怎么做的?"(理解 Gap)
  • "这个技能最重要的限制/铁律是什么?"
  • "输出格式有特殊要求吗?"
Step 2:架构规划

加载 references/architecture-guide.md,回答以下问题:

  1. 主文件 SKILL.md:

    • 核心工作流是什么?(步骤清单)
    • 有哪些铁律(必须遵守的规则)?
    • 需要哪些用户确认门控?
  2. 参考文档 references/:

    • 哪些内容是重型参考资料(检查清单、模板、规范)?
    • 按需加载哪些文档(在工作流的哪个步骤加载)?
    • 每个 reference 文件聚焦一个主题
  3. 资源文件 assets/(可选):

    • 用于输出但不用于推理的文件(图片、固定模板)

架构决策原则:

  • SKILL.md 控制在 500 行以内
  • 超出 500 行的内容移到 references/
  • 每个 reference 文件聚焦单一主题
Step 3:编写 SKILL.md
3.1 Frontmatter(决定触发时机)

加载 references/description-guide.md。

yaml
---
name: skill-name
description: "核心描述。触发词:[关键词 1]、[关键词 2]、[关键词 3]..."
---

描述要求:

  • 前 50 字说明解决什么问题
  • 列出 10-20 个触发关键词(中英文都要包含)
  • 包含触发场景的动词(创建、分析、优化、生成...)
3.2 铁律(Iron Law)

在标题下方立即写出最重要的约束:

markdown
# 技能名称

铁律:[最重要的行为约束,用户最需要知道的一条规则]
3.3 工作流(核心内容)

加载 references/workflow-patterns.md。

使用勾选清单格式,让 AI 可以追踪进度:

markdown
## 工作流

- [ ] 第一步:[描述](标注是否必须)
  - [子步骤 1]
  - [子步骤 2]
- [ ] 第二步:[描述]
  - 用户确认门控:[在继续前必须获得用户批准]

确认门控示例:

markdown
**将以上内容展示给用户确认,批准后才继续。**
3.4 参考资源

文件末尾列出所有 references 及加载时机:

markdown
## 参考资源

- `references/checklist.md` — 在第 3 步加载,用于[目的]
- `references/template.md` — 在输出阶段加载,用于[目的]
Step 4:编写 References

每个 reference 文件:

  • 聚焦单一主题(不要"大杂烩")
  • 以表格、清单、代码示例为主(减少叙述性文字)
  • 文件名描述内容(security-checklist.md 而非 ref1.md)
Step 5:质量检查

发布前检查清单:

  • SKILL.md 是否 < 500 行?
  • 每段内容是否都对得起 token(删掉 Claude 已经知道的废话)?
  • description 是否包含了足够的触发关键词?
  • 铁律是否明确(最重要的约束)?
  • 工作流中是否有合适的用户确认门控?
  • 是否在第一步就要求了 3 个具体例子?
  • references 是否按需加载而非一次性全加载?
  • 是否有反模式清单(告诉 AI 不该做什么)?
Step 6:README.md

编写简短的安装和使用说明:

  • 安装命令(npx skills add ...)
  • 触发方式
  • 主要功能和使用场景
  • 简单的使用示例

技能目录结构

skill-name/
├── SKILL.md          # 主文件(<500行)
├── README.md         # 安装和使用说明
└── references/       # 按需加载的参考文档
    ├── checklist.md
    └── template.md

反模式警告

反模式识别特征处理方式
废话文学解释 Claude 已知的基础概念删除
一次性全加载所有 references 在开头全部加载改为按步骤按需加载
没有铁律缺少明确的行为约束识别最重要的约束写到最前面
没有确认门控自作主张连续执行在关键决策前增加用户确认
超大单文件SKILL.md > 1000 行将重型内容移到 references
触发词不足description 太短,只有 1-2 句增加 10-20 个触发关键词

警告:当你想跳过需求收集或质量检查时

遇到以下想法,立刻停下——未经验证的技能比没有技能更有害(会给 Agent 错误指导):

借口现实
"需求很清楚,不需要 3 个例子"例子的作用是暴露你的假设,不是重复已知信息。没有例子就没有边界检验。
"description 有几个触发词就够了"触发词不足导致技能无法被发现。10-20 个关键词是最低要求,不是上限。
"SKILL.md 长一点没关系,内容更全面"超过 500 行的 SKILL.md 会消耗过多 context。把重型内容移到 references。
"这个技能很简单,不需要反模式清单"简单技能的边界更容易被 Agent 误解。反模式清单是防止误用的护栏。
"用户要的快,先发布再完善"未完善的技能会被 Agent 错误遵循,修复成本远高于一开始做好。

参考资源

  • references/description-guide.md — Frontmatter description 编写指南
  • references/workflow-patterns.md — 工作流设计模式
  • references/architecture-guide.md — 技能架构设计原则

© ProgrammerAnthony, 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 4 other files (references) in skills/skill-smith of ProgrammerAnthony/Expert-Coding-Harness.

  • SKILL.md
  • README.md
  • references/architecture-guide.md
  • references/description-guide.md
  • references/workflow-patterns.md

Open the folder on GitHubat commit ab0b827

Compare with similar skills

Skill Smith 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 Smith compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Skill Smith this skillProgrammerAnthony/Expert-Coding-Harness235—~847Automated safety check: PassMIT
10 Andruia Skill Smithsickn33/agentic-awesome-skills47k2 repos~662Automated safety check: PassMIT
Node SmithWeaveMindAI/weft2k—~3.6kAutomated safety check: PassCustom licence
Builder Payload Smithdiscord-php/DiscordPHP1.1k—~1.8kAutomated safety check: PassMIT
Doc SmithAIGNE-io/aigne-doc-smith163—~1.7kAutomated safety check: PassCustom licence
Doc Smith Docs DetailAIGNE-io/aigne-doc-smith163—~1.7kAutomated safety check: PassCustom licence

Similar skills

  • 10 Andruia Skill Smith

    sickn33/agentic-awesome-skills

    Ingeniero de Sistemas de Andru.ia. An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~662 tokens
    Auto-check passed
  • Node Smith

    WeaveMindAI/weft

    Builds exactly one weft node end to end, unsupervised. An agent skill from WeaveMindAI/weft.

    2k GitHub stars~3.6k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Builder Payload Smith

    discord-php/DiscordPHP

    Maintain Builder classes — outbound payload construction, validation, serialization, component handling, and fromPart symmetry.

    1.1k GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed
  • Doc Smith

    AIGNE-io/aigne-doc-smith

    从工作区数据源生成和更新全面的文档,包括代码仓库、文本文件和媒体资源。当用户请求以下操作时使用此技能:(1) 从代码或文件创建或生成文档,(2) 构建文档结构或文档详情,(3) 更新、修改或改进已有文档,(4) 重写文档的特定章节或段落,(5) 处理 changeset 文件或 PATCH 标记的修改请求。支持技术文档、用户指南、API 参考和一般文档需求的生成与维护。

    163 GitHub stars~1.7k tokensUpdated 7 mo ago
    Auto-check passed
  • Doc Smith Docs Detail

    AIGNE-io/aigne-doc-smith

    生成单个文档的详细内容,根据文档结构和用户意图生成包含导航、代码示例、技术图表的完整文档. An agent skill from AIGNE-io/aigne-doc-smith.

    163 GitHub stars~1.7k tokensUpdated 7 mo ago
    Auto-check passed
  • Lists, downloads, references and deploys agents on a Yao host through five bash-invoked tools, keeping edits to the smith namespace while allowing read-only study of any agent.

    8.1k GitHub stars~873 tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed

More from ProgrammerAnthony/Expert-Coding-Harness

All 23 skills in this repo
  • Architecture Advisor

    ProgrammerAnthony/Expert-Coding-Harness

    A skill your agent uses when 用户需要设计新系统架构、评审或优化已有系统架构、选择技术方案时。触发场景:架构分析、架构设计、系统设计、architecture、架构优化、系统架构、架构评审、架构咨询、技术方案、技术设计、如何组织代码结构、模块划分、服务拆分、数据库选型、微服务设计。

    235 GitHub stars~673 tokensUpdated 4 mo ago
    Auto-check passed
  • Code Review Expert

    ProgrammerAnthony/Expert-Coding-Harness

    A skill your agent uses when 用户要求审查代码、评估代码质量、提交 PR 前检查、发现代码有潜在问题时。触发场景:代码审查、code review、审查代码、review、检查代码、代码检查、代码质量、代码评审、这段代码有问题吗、帮我看看代码、合并前检查。

    235 GitHub stars~806 tokensUpdated 4 mo ago
    Auto-check passed
  • Code Security Audit

    ProgrammerAnthony/Expert-Coding-Harness

    A skill your agent uses when 用户需要对代码进行安全审计、发现安全漏洞、上线前安全评估、检查代码是否存在安全风险时。触发场景:代码安全审计、安全审计、白盒审计、安全扫描、漏洞检测、漏洞挖掘、SQL注入、命令注入、XSS、SSRF、反序列化、认证绕过、越权、代码安全检查、security audit、code…

    235 GitHub stars~1.6k tokensUpdated 4 mo ago
    Auto-check passed
  • Debug Expert

    ProgrammerAnthony/Expert-Coding-Harness

    A skill your agent uses when 程序出现错误、异常、崩溃,或行为与预期不符,或测试失败,或无法定位问题根因时。触发场景:调试、debug、报错、错误、异常、bug、问题排查、故障排查、不工作、崩溃、无法运行、出错了、为什么不生效、运行报错、跑不起来、程序挂了。

    235 GitHub stars~986 tokensUpdated 4 mo ago
    Auto-check passed
  • Frontend Code Review

    ProgrammerAnthony/Expert-Coding-Harness

    A skill your agent uses when 用户需要审查前端代码(React/Vue/Next.js/TypeScript/Tailwind等)、检查代码质量、性能问题、可维护性、安全漏洞、最佳实践落地时。触发场景:前端代码评审、前端代码优化、React/Vue代码检查、TypeScript代码审查、前端性能优化、前端安全审计、前端代码规范检查。

    235 GitHub stars~614 tokensUpdated 4 mo ago
    Auto-check passed
  • Frontend Performance Optimization

    ProgrammerAnthony/Expert-Coding-Harness

    A skill your agent uses when 用户需要优化前端性能、提升页面加载速度、减少白屏时间、优化交互流畅度、进行性能排查时。触发场景:前端性能优化、页面加载慢、白屏时间长、卡顿、LCP/FID/CLS指标优化、前端性能分析、打包体积优化。

    235 GitHub stars~701 tokensUpdated 4 mo ago
    Auto-check passed

Questions about Skill Smith

What does Skill Smith do?

A skill your agent uses when 需要创建新的 AI Agent 技能、改进已有 SKILL.md 文件、设计技能工作流或不确定技能该如何组织时。触发场景:创建技能、新建技能、写技能、技能开发、skill-smith、设计技能、编写SKILL.md、制作技能、开发skill、如何写一个好技能、技能质量不好怎么改进。. Skill Smith is an agent skill from ProgrammerAnthony/Expert-Coding-Harness.

When should I use Skill Smith?

Skill Smith fits situations like: 需要创建新的 AI Agent 技能、改进已有 SKILL.md 文件、设计技能工作流或不确定技能该如何组织时。触发场景:创建技能、新建技能、写技能、技能开发、skill-smith、设计技能、编写SKILL.md、制作技能、开发skill、如何写一个好技能、技能质量不好怎么改进.

How do I install Skill Smith in Claude Code?

Run `npx skills add ProgrammerAnthony/Expert-Coding-Harness --skill skill-smith -a claude-code`. Or copy the skill folder (skills/skill-smith in ProgrammerAnthony/Expert-Coding-Harness) into .claude/skills/skill-smith in your project. Claude Code loads it when a task matches its description.

How do I install Skill Smith in Codex?

Run `npx skills add ProgrammerAnthony/Expert-Coding-Harness --skill skill-smith -a codex`. Or copy the skill folder (skills/skill-smith in ProgrammerAnthony/Expert-Coding-Harness) into .agents/skills/skill-smith in your project. Codex loads it when a task matches its description.

Can I use Skill Smith 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 ProgrammerAnthony/Expert-Coding-Harness --skill skill-smith -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-smith, .gemini/skills/skill-smith, .github/skills/skill-smith and .opencode/skills/skill-smith in your project.

What does Skill Smith need to run?

Going by SKILL.md and its folder, Skill Smith needs the command-line tools its instructions call (npx). Our summary lists: Node.js.

Does Skill Smith access the network?

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

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

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

About 847 tokens (SKILL.md is roughly 3.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.3k tokens, read only when the agent opens those files.

What are the alternatives to Skill Smith?

Skills that share tags, products or a category with Skill Smith: 10 Andruia Skill Smith (sickn33/agentic-awesome-skills, 47k stars), Node Smith (WeaveMindAI/weft, 2k stars), Builder Payload Smith (discord-php/DiscordPHP, 1.1k stars) and Doc Smith (AIGNE-io/aigne-doc-smith, 163 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Skill Smith?

ProgrammerAnthony (a GitHub user) maintains it in ProgrammerAnthony/Expert-Coding-Harness, which has 235 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on May 11, 2026.

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