Procedural memory that installs, patches, and publishes like code像代码一样可安装、可修补、可发布的程序性记忆
A skill is a SKILL.md — YAML frontmatter plus markdown — that teaches a domain workflow: endpoints, auth, gotchas, and tested sequences.Skill 是一个 SKILL.md——YAML frontmatter 加 Markdown——用来教一个领域的工作流：端点、鉴权、坑点与经过验证的步骤。
Reading a skill loads it and registers its tools. The knowledge it carries would otherwise be re-derived from scratch each session — and re-derived wrongly, because the details that matter are exactly the ones a model does not reliably remember.读取 skill 即加载它并注册其工具。它承载的知识，若没有它，就得在每个会话里从头重新推导——而且会推错，因为真正要紧的细节，恰恰是模型无法可靠记住的那些。
A skill is small enough to hold in context and concrete enough to act on: the frontmatter names what it is for and what it costs; the body is a sequence a model can follow.Skill 小到可以放进上下文，又具体到可以照做：frontmatter 说明它的用途与代价；正文是一段模型可以遵循的流程。
Skills are found in three tiers, and the rule is to take the lowest tier that fits.Skill 分三层被发现，规则是：取最合适的最低层。
Tier 0 is installed skills plus platform tools — free and instant. Tier 1 is the official and community registries, plus the paid x402 marketplace; these are installable. Tier 2 is building it yourself: research plus custom code.第 0 层是已安装的 skills 加平台工具——免费且即时。第 1 层是官方与社区注册表，外加付费的 x402 市场；这些可安装。第 2 层是自己构建：调研加自定义代码。
Execution against third-party APIs always checks for a skill first. A skill ships correct auth and tested workflows; guessing at an API from memory is how credentials leak and money is lost.对第三方 API 的执行总是先查 skill。Skill 自带正确的鉴权与经过验证的工作流；凭记忆猜 API 正是凭证泄露和亏钱的来源。
Discovery is a lookup, not a browse: search_skills returns a ranked list, and loading a skill is a single deliberate action, not an automatic flood of schemas.发现是一次查询，而不是浏览：search_skills 返回排序后的列表，加载 skill 是一次刻意的动作，而不是 schema 的自动涌入。
Skills are living documents, and the patch happens where the context is fullest — in the conversation.Skill 是活的文档，修补发生在上下文最完整的地方——对话之中。
When a skill's instructions turn out wrong, they are patched immediately, in-conversation, while the full context is still on the table. A new skill is created only when nothing fits and the workflow has non-obvious, reusable substance.当 skill 里的说明出错时，就在对话中立即修补，趁完整上下文还在桌面上。只有当什么都不合适、且该工作流含有不显而易见的可复用内容时，才创建新 skill。
The goal is a few comprehensive domain skills, not many narrow ones. Each skill earns its place by being the thing the agent reaches for again and again.目标是少数几个全面的领域 skill，而不是许多狭窄的碎片。每个 skill 靠「agent 反复取用」来证明自己的位置。
Patch-in-place keeps the skill honest: every correction is a diff against what actually happened, so the document and the world never drift far apart.就地修补让 skill 保持诚实：每次修正都是对真实发生之事的 diff，文档与世界因此不会长期分道扬镳。
Skills version like software, and publishing is a code review, not a copy-paste.Skill 像软件一样做版本管理，发布是一次代码评审，而不是复制粘贴。
The community repository takes pull requests; the index tracks versions; updates flow to installed copies. A mature agent runs roughly a hundred skills spanning trading, image and video, messaging, and on-chain execution.社区仓库接受 pull request；索引跟踪版本；更新流向已安装的副本。一个成熟的 agent 大约运行上百个 skill，覆盖交易、图像与视频、消息、链上执行。
Publishing carries obligations: a skill's claims are tested before it is indexed, and the marketplace route takes a cut that keeps the ecosystem sustainable.发布伴随义务：skill 的声明在进入索引前经过测试，市场通道抽取的分成让整个生态可持续。