> ## 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.

# Skill Package Guidelines

<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>

Skill package 是面向 local agent workflow 的贡献。它把一种可重复的工作方式打包起来，让学习者或操作者可以用 AI assistant 运行、检查步骤，并根据自己的环境改造这个 workflow。

这个贡献类型不绑定某一个 assistant 产品。好的 package 会定义 workflow、面向人的说明、面向 agent 的指令，以及让 workflow 可 review、可重复运行所需的辅助文件。

## 这里适合什么

* 比单个 prompt 更需要结构的 local-agent workflow
* 可重复的 research、review、capture、cleanup 或 monitoring routine
* 让 workflow 更安全运行的 helper scripts、references 或 rules
* 清楚说明什么时候需要人来 review、approve 或接手

## Skill package 应放在哪里

Skill package 放在 `skills/<skill-slug>/` 下。

| Surface                           | 内容范围                                | 示例                                                     |
| --------------------------------- | ----------------------------------- | ------------------------------------------------------ |
| `skills/<skill-slug>/README.md`   | 面向人的 workflow 和目标读者说明。              | Daily News Watcher overview、Garbage Collector workflow |
| `skills/<skill-slug>/SKILL.md`    | 面向 agent 的调用规则和运行契约。                | 什么时候运行 skill、应该遵循哪些步骤                                  |
| `skills/<skill-slug>/scripts/`    | 让 workflow 可重复运行的确定性辅助工具。           | fetchers、analyzers、report writers                      |
| `skills/<skill-slug>/references/` | 规则、source notes、checklists 或支持性上下文。 | cleanup rules、source lists、escalation checklists       |

## Issue 和 review 流程

在构建 package 之前，先创建 GitHub issue。使用 `Practitioner Skill Package` 表单，让 workflow、package shape、local integrations 和 safety boundaries 在开工前可见。

核心团队会先 review issue。他们可能批准 scope、请求修改，或拒绝 proposal。issue 被批准或确认之后，贡献者可以 fork 仓库并开始修改。

核心团队会再单独 review pull request。他们可能批准、请求修改，或拒绝 PR。如果 issue 或 PR 被拒绝，贡献者仍然可以保留自己的 fork，并在仓库外继续使用这些改动。

## Package 结构

每个 package 都应保持小而清晰：

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

使用 `README.md` 讲清面向人的故事：这个 package 为什么存在、适合谁、它教会什么 workflow。使用 `SKILL.md` 放置 agent-facing invocation contract。`scripts/` 只放确定性的辅助工具，`references/` 放规则、source notes 或支持性指南。

## 工作规则

* 让 package 聚焦在一个可重复 workflow 上。
* 在任何自动化步骤之前说清人的角色。
* 优先使用小型 helper scripts，而不是很长的手动命令块。
* 提供足够 review 的文档，但不要把 package 写成一篇泛化文章。
* 有用时，从 package 链回相关手册页面、项目或 contributor discussion。

## 完成标准

当一个 skill package 满足以下条件时，即可进入 review：

* 说明了 workflow 和目标读者
* 同时包含面向人和面向 agent 的说明
* helper files 保持最小且确定性
* 记录了安全边界或 approval points
* 可以作为一个完整 package 被 review