agentleFS
Sign inStart free
young1linyoung1lin/cc-tutorial/advanced/skill.md

advanced

Skill38 starsChanged 4 months agoMITView on GitHub

T1 Claude Code 官方的技能模型：每个 skill 必须有一个 SKILL.md 文件；frontmatter 字段*全部可选*——name 缺省取目录名，description 官方标注为 Recommended，因为 Claude 靠它决定何时自动加载。技能本体可以继续挂载脚本、参考资料和资源文件。Claude Code 的 skill 遵循 Agent Skills 开放标准。（Claude Code skills docs，Anthropic） [Tutorial perspective] Skill 的本质不是“更长的提示词”。它是一个可路由、可分目录、可增量维护的能力包。提示词只是入口。真正值钱的是后面的目录、脚本、参考资料、知识沉淀和固定工作流。 不用 Skill，会反复掉进同一个坑： Skill 解决的是这类重复成本： [Tutorial perspective] 在线搜索擅长找“外部最新信息”。Skill 擅长沉淀“项目内部稳定结构”。两者不是替代关系。把稳定知识每次都交给搜索和探索，像每次进办公室先把工位拆了再重新摆。 适合放进 Skill 的内容： business-logic 这个 skill 的目标很直接：把代码、需求、业务规则、关键行号、时序图和改动影响，沉淀到按业务划分的目录里。 它不是为了替代 RAG 的所有能力。它是为了让会话一上来就拿到“这个业务为什么存在、代码在哪里、应该怎么改”。 在这个仓库里，business-logic 的入口协议也直接放在 SKILL.md，没有再在 .claude/commands/ 下复制一份。 T1 OpenClaw 官方文档明确写了：第三方 skills 应被视为不受信任代码；涉及高风险工具或不受信任输入时，应优先采用沙箱。Skills docs T1 ClawHub 官方文档说明市场默认开放上传，治理主要依赖账号门槛、举报和隐藏机制。ClawHub docs T3 公开研究和报道已经把恶意 skills、凭据窃取和恶意载荷投递与 OpenClaw 生态直接关联起来。Snyk report summary TechRadar report [Author's analysis] 所以结论不该温和。公共 Skill Marketplace 不是玩具。恶意 skill 可以把你的 agent 变成数据外带器、下载器，甚至跳板机。别把能跑终端和读文件的…

1 other project uses a version of this.

Adopted by

Most recently taken up by

  • Other versions1 project uses a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 1

    1. nguyenthanhtat/screen1-claude★ 2same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository4 other files it gives its agents.

The file

Create a free account to mount
Files
skill.md

Skill

Skill 的本质

T1 Claude Code 官方的技能模型：每个 skill 必须有一个 SKILL.md 文件；frontmatter 字段全部可选——name 缺省取目录名，description 官方标注为 Recommended，因为 Claude 靠它决定何时自动加载。技能本体可以继续挂载脚本、参考资料和资源文件。Claude Code 的 skill 遵循 Agent Skills 开放标准。（Claude Code skills docs，Anthropic）

[Tutorial perspective] Skill 的本质不是“更长的提示词”。它是一个可路由、可分目录、可增量维护的能力包。提示词只是入口。真正值钱的是后面的目录、脚本、参考资料、知识沉淀和固定工作流。

为什么需要 Skill

不用 Skill，会反复掉进同一个坑：

  • 每次新会话都要重新 Explore 整个项目
  • 每次都要重新告诉 Agent 某个业务在哪里
  • 每次都要重新解释某个 PDF 怎么生成、脚本放哪里、样例代码是什么
  • 每次都把关键知识塞进聊天记录，下一次又丢光

这不是智能。是失忆。

Skill 解决的是这类重复成本：

  • 把领域知识固定到目录里
  • 把路由规则固定到 SKILL.md
  • 把脚本固定到 scripts/
  • 把参考资料固定到 references/
  • 把输出模板固定到 assets/

为什么不是每次都在线搜索

[Tutorial perspective] 在线搜索擅长找“外部最新信息”。Skill 擅长沉淀“项目内部稳定结构”。两者不是替代关系。把稳定知识每次都交给搜索和探索，像每次进办公室先把工位拆了再重新摆。

适合放进 Skill 的内容：

  • 项目自己的业务分层
  • 接口与 service 的映射
  • 常见改动的调用链
  • PDF 生成方式
  • 报表模板
  • 常用脚本和样例代码
  • 团队内部约定

适合在线搜索的内容：

  • 官方文档最新变更
  • 价格和配额
  • 新发布的 API
  • 安全公告

Skill 与 business-logic

business-logic 这个 skill 的目标很直接：把代码、需求、业务规则、关键行号、时序图和改动影响，沉淀到按业务划分的目录里。

它不是为了替代 RAG 的所有能力。它是为了让会话一上来就拿到“这个业务为什么存在、代码在哪里、应该怎么改”。

在这个仓库里，business-logic 的入口协议也直接放在 SKILL.md，没有再在 .claude/commands/ 下复制一份。

推荐结构

.claude/skills/business-logic/
├── SKILL.md
├── change-log.md
├── shared/
│   └── cross-cutting.md
├── team/
│   ├── overview.md
│   ├── join-team.md
│   └── leave-team.md
└── order/
    ├── overview.md
    └── cancel-order.md

安全

T1 OpenClaw 官方文档明确写了：第三方 skills 应被视为不受信任代码；涉及高风险工具或不受信任输入时，应优先采用沙箱。Skills docs

T1 ClawHub 官方文档说明市场默认开放上传，治理主要依赖账号门槛、举报和隐藏机制。ClawHub docs

T3 公开研究和报道已经把恶意 skills、凭据窃取和恶意载荷投递与 OpenClaw 生态直接关联起来。Snyk report summary TechRadar report

[Author's analysis] 所以结论不该温和。公共 Skill Marketplace 不是玩具。恶意 skill 可以把你的 agent 变成数据外带器、下载器，甚至跳板机。别把能跑终端和读文件的 agent 当成浏览器插件。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free