> ## Documentation Index
> Fetch the complete documentation index at: https://labs.prompthon.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills 入门

> 理解 Codex skills 是什么，以及它们如何接在桌面智能体设置之后。

<div className="not-prose my-4 rounded-md border border-gray-200 bg-gray-50 p-2 text-sm dark:border-gray-800 dark:bg-gray-900/40">
  <div className="mb-2 px-1 text-xs font-semibold uppercase tracking-wide text-gray-500 dark:text-gray-400">需要帮助？</div>

  <div className="flex flex-wrap gap-2">
    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://discord.gg/sDE2HhGTg4" target="_blank" rel="noreferrer">
      <Icon icon="discord" iconType="brands" size={14} />

      <span>在 Discord 提问</span>
    </a>

    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://github.com/Prompthon-IO/agent-systems-handbook/issues/new/choose" target="_blank" rel="noreferrer">
      <Icon icon="github" iconType="brands" size={14} />

      <span>提交 GitHub Issue</span>
    </a>

    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/zh-Hans/SUPPORT.md" target="_blank" rel="noreferrer">
      <Icon icon="life-ring" size={14} />

      <span>支持指南</span>
    </a>
  </div>
</div>

Skills 是 Codex 的可复用 instruction package。它们把重复工作变成一个有名字的工作流，并配套清晰触发条件、本地脚本、支持参考资料和工具特定指导。

在这条路线中，skills 放在 Codex 和 Claude Code 设置之后，因为 skill 不是本地智能体表面的替代品。它是在智能体已经可用之后，让智能体执行得更稳定的一种方式。

## Skill 包含什么

一个典型的 Codex-compatible skill 可以包含：

```text theme={null}
skills/<skill-name>/
  SKILL.md
  agents/openai.yaml
  scripts/
  references/
```

* `SKILL.md` 说明什么时候使用这个 skill，以及工作流应该怎样运行。
* `agents/openai.yaml` 保存可选的 agent surface 元数据。
* `scripts/` 放置可重复运行的确定性 helper。
* `references/` 放置支持规则、示例、模板或 source notes。

## 什么时候使用 Skill

当工作具有可重复形状时，适合使用 skill：

* 生成 morning brief
* 按 preview-first 规则清理本地文件
* 抓取固定 source set
* 按相同结构发布报告
* 跟随工作坊或贡献 routine

不要为了一次性回答、单个小编辑，或不需要可复用工作流规则的内容创建 skill。

## Skills 如何融入本站

* [实践者技能](/zh-Hans/skills) 页面列出 repo-owned skill packages。
* [工作坊](/zh-Hans/workshops) 路线讲解设置和引导式执行。
* [贡献者工具包](/zh-Hans/contributor-kit) 说明公开贡献如何提出、review 和维护。

## 安全边界

Skills 可以调用工具、运行脚本并使用本地状态。不要把 secrets 写入 tracked files；不要把生成的 runtime artifacts 提交到 git；并且要说明 skill 依赖的外部服务。