# SkillPKG / 技能包 — 完整网站使用指南

> 简短索引：https://skillpkg.com/llms.txt
> 本文件由各主题 Markdown 指南生成；具体内容和可用状态以当前页面或接口为准。

# SkillPKG 网站使用指南

Canonical page: https://skillpkg.com/

SkillPKG（技能包）是面向知识工作者的 AI 能力资产平台，定位为“能力，即服务”。网站提供技能包、提示词、在线助手和文章；SkillPKG Studio 是用于本地 Skills 管理的独立桌面工具。

## 按任务选择入口

| 任务 | 网站入口 | 使用说明 |
| --- | --- | --- |
| 为 Agent 寻找可复用技能或方案 | [技能包](https://skillpkg.com/packages) | [技能包指南](https://skillpkg.com/packages.md) |
| 查找可以复制使用的提示词 | [提示词](https://skillpkg.com/prompts) | [提示词指南](https://skillpkg.com/prompts.md) |
| 在网站上运行任务型 AI 助手 | [在线助手](https://skillpkg.com/assistants) | [助手指南](https://skillpkg.com/assistants.md) |
| 阅读教程、趋势解读和实践内容 | [文章](https://skillpkg.com/posts) | [文章指南](https://skillpkg.com/posts.md) |
| 按关键词定位文章、技能包或助手 | [搜索](https://skillpkg.com/search) | [搜索指南](https://skillpkg.com/search.md) |
| 集中管理并向多个 Agent 安装本地 Skills | [Studio](https://skillpkg.com/studio) | [Studio 指南](https://skillpkg.com/studio.md) |
| 分享自己的技能包或提示词 | [提交技能包](https://skillpkg.com/packages/submit)、[提交提示词](https://skillpkg.com/prompts/submit) | [提交指南](https://skillpkg.com/submit.md) |
| 用程序查询和下载 Skill/Solution | 登录后在账户中创建 API Key | [API 指南](https://skillpkg.com/api.md) |

## 内容模块之间的关系

- 技能包是带有说明文件、目录结构和发布版本的可下载能力包，包含 Skill、Solution、Claw 三种类型。
- 提示词库提供可复用文本；在线助手则使用任务模板和会话系统在网站上生成回答。复制一条提示词与启动一个助手是两种操作。
- 文章可以关联技能包，技能包详情也可以列出相关文章。可从教程进入相关能力包，也可从能力包回到实践说明。
- 提交人的公开主页展示其已发布的技能包和提示词；个人账户用于管理自己的内容和使用记录。
- Studio 的发现、本地管理、编辑、扫描和安装发生在桌面应用中，网页提供介绍和安装包下载入口。

## 推荐使用顺序

1. 根据任务选择内容模块，使用该模块的分类或站内搜索定位候选项。
2. 打开实际详情链接，阅读名称、简介、正文、来源和适用条件。分类 slug、内容 slug 和 publicId 都应从页面或 API 获取。
3. 下载技能包前阅读入口文件、目录结构、版本和风险等级；复制提示词时确认获取的是完整正文；启动助手前查看参数与积分提示。
4. 需要下载、完整提示词、会话或投稿时，使用网站登录入口。需要程序集成时，使用 [API](https://skillpkg.com/api.md)。

## Agent 访问

从 [llms.txt](https://skillpkg.com/llms.txt) 选择主题，或一次读取 [llms-full.txt](https://skillpkg.com/llms-full.txt)。这些文件描述使用方式，不包含实时目录、账户数据或所有内容正文。[站点地图](https://skillpkg.com/sitemap.xml) 可用于发现公开内容链接。

公开浏览不需要 API Key；对外 `/api/v1/skills` 接口需要用户 API Key。网站登录会话与 API Key 是不同的访问方式。本文档不会授予账户操作、内容发布、付费使用或本地安装权限；应在用户交代的任务范围内操作。

当前数量、分类、推荐项、发布状态、积分规则和安装包地址应从实际页面或接口确认。不要根据本指南推断全部内容免费、全部包开源、某个包兼容所有 Agent，或某个助手一定能联网。

---

# SkillPKG 技能包

Canonical page: https://skillpkg.com/packages

技能包是可下载的结构化能力资产。列表提供内容卡片和推荐展示；打开详情可阅读说明、查看文件结构、来源、提交人、作者信息和风险等级。

## 三种类型

| 类型 | 用途 | 提交时的必要入口文件 |
| --- | --- | --- |
| `skill` / Skill | 遵守 Agent Skills 规范的技能 | `SKILL.md` |
| `solution` / Solution | 为特定问题组织的一组技能或 Agent | `README.md` |
| `claw` / Claw | OpenClaw Workspace，可包含身份、行为说明和技能集合 | `README.md` |

详情页显示发布版本选择的说明文件。Skill 包可以同时包含 `README.md` 与 `SKILL.md`，页面展示 README 并不表示包中没有 SKILL.md。类型以页面标识为准；运行、安装和依赖要求以包内说明为准。

## 发现与阅读

1. 打开 [技能包列表](https://skillpkg.com/packages)，或从导航栏选择技能包分类。
2. 需要关键词检索时使用 [技能包搜索](https://skillpkg.com/search?collection=packages)，填写关键词后搜索。
3. 跟随候选卡片或搜索结果进入 `/packages/{slug}`。不要将提示词 publicId 或 API 的 publicId 直接当作网页 slug。
4. 阅读简介、说明正文和目录结构，确认所需工具、依赖、配置与使用步骤。可通过来源链接、作者链接和相关文章了解背景。
5. 需要 ZIP 时点击详情页的“下载 Zip”；网站下载需要登录，未登录会提示先登录。

## 路径与标识

- 列表：`/packages`。
- 分页：`/packages/page/{page}`，页码从 `1` 开始。
- 分类分页：`/packages/categories/{slug}/page/{page}`。
- 等价查询形式：`/packages?category={slug}&page={page}`。
- 详情：`/packages/{slug}`，跟随实际页面链接。
- 投稿：[提交技能包](https://skillpkg.com/packages/submit)。

网页列表按分类和页码浏览。需要类型、推荐状态、名称查询等程序化筛选时，使用 [Skill/Solution API](https://skillpkg.com/api.md)；该 API 当前不包含 Claw。

## 风险等级与使用判断

| 值 | 页面含义 |
| --- | --- |
| `benign` | 安全 |
| `suspicious` | 可疑 |
| `malicious` | 危险 |
| 空值或未识别值 | 未知 |

风险等级属于发布版本的信息，不能代替对当前文件、来源、权限和执行行为的判断。未知不表示已经通过安全审查。推荐位置或下载次数也不能说明包适合某个任务。

下载获得 ZIP，并不自动安装到 Agent。可继续按照包内说明操作，或使用 [Studio](https://skillpkg.com/studio.md) 管理本地 Skills。许可证、作者支持和适用环境应查阅包内文件及原始来源。

Related: [分类](https://skillpkg.com/categories.md)、[提交](https://skillpkg.com/submit.md)、[API](https://skillpkg.com/api.md)。

---

# SkillPKG 提示词

Canonical page: https://skillpkg.com/prompts

提示词库用于发现、复制和分享可直接复用的 AI 提示词。它与在线助手使用的任务模板是不同模块；复制提示词不会在本站启动会话。

## 浏览和复制

1. 打开 [提示词列表](https://skillpkg.com/prompts)，通过一级、二级分类浏览内容。
2. 跟随卡片打开 `/prompts/{publicId}`。详情标识是 publicId，不是文章或技能包使用的 slug。
3. 阅读标题、简介、分类与正文；有来源链接时，可继续查看原始出处。
4. 使用复制按钮复制当前显示的内容。未登录时，长正文会截断，复制到的也只是预览；较短正文可能完整显示。登录后可查看并复制完整提示词。
5. 将完整提示词按用户的任务和使用环境填写、调整，再用于相应 AI 工具。

## 路径

- 列表：`/prompts`。
- 分页：`/prompts/page/{page}`。
- 分类分页：`/prompts/categories/{slug}/page/{page}`。
- 等价查询形式：`/prompts?category={slug}&page={page}`。
- 详情：`/prompts/{publicId}`。
- 投稿：[提交提示词](https://skillpkg.com/prompts/submit)。

站内搜索目前覆盖文章、技能包、助手，未包含提示词库。寻找提示词时使用提示词列表、分类、提交人的主页或公开内容链接。

## 发布和管理

提示词投稿需要登录，审核通过后才进入公开列表、详情页和提示词站点地图。用户可在 [我的提示词](https://skillpkg.com/account?tab=my-prompts) 管理投稿；公开作者主页的提示词页签为 `/u/{slug}?tab=prompts`。

详情页的简介或预览不是完整提示词的替代内容。发现正文被截断时应说明该限制，不要补写缺失部分并当作作者原文。

Related: [提交指南](https://skillpkg.com/submit.md)、[分类](https://skillpkg.com/categories.md)、[在线助手](https://skillpkg.com/assistants.md)。

---

# SkillPKG 在线助手

Canonical page: https://skillpkg.com/assistants

在线助手是由任务模板和会话系统驱动的 AI 助理。在详情页填写任务输入后，网站创建会话并转入聊天页面。它与可复制的提示词库、下载到本地的技能包分别提供不同的使用方式。

## 启动和继续对话

1. 打开 [助手列表](https://skillpkg.com/assistants)，按分类浏览，或使用 [助手搜索](https://skillpkg.com/search?collection=assistants)。
2. 跟随链接进入 `/assistants/{slug}`，阅读描述与参考示例。
3. 登录后填写表单列出的参数。字段由具体助手定义，不要假设所有助手使用相同字段；没有参数的助手可直接启动。
4. 查看页面上的积分消耗提示，点击“启动助手”。启动后会转入 `/chat?sessionId={sessionId}`。
5. 在该会话中阅读回答并继续对话。sessionId 来自创建结果或实际页面，应保留当前会话标识。

## 路径

- 列表：`/assistants`。
- 分页：`/assistants/page/{page}`。
- 分类分页：`/assistants/categories/{slug}/page/{page}`。
- 等价查询形式：`/assistants?category={slug}&page={page}`。
- 详情和任务输入：`/assistants/{slug}`。
- 登录后的聊天页面：`/chat`，具体会话使用页面生成的 sessionId。

## 登录、积分和能力

公开列表和助手说明可用于选择任务；启动助手和使用会话需要登录。助手使用会消耗积分，积分不足可能阻止开始对话。当前消耗、余额和充值方式以助手页面与 [账户](https://skillpkg.com/account) 为准。

助手的联网等能力取决于具体模板和当前配置，不能从“在线助手”名称推断所有助手都支持联网搜索。判断能力时结合助手说明、当前输入字段和实际返回内容。

自动化浏览时使用网站展示的表单和会话流程。[Skill/Solution API](https://skillpkg.com/api.md) 不提供助手会话接口。

Related: [提示词](https://skillpkg.com/prompts.md)、[搜索](https://skillpkg.com/search.md)、[账户](https://skillpkg.com/account.md)。

---

# SkillPKG 文章

Canonical page: https://skillpkg.com/posts

文章承载趋势洞察、技术解读和实践教程。阅读文章可以了解方法与背景，也可以通过文中关联的技能包进入可复用的能力资产。

## 使用方式

1. 打开 [文章列表](https://skillpkg.com/posts)，通过导航分类或 [文章搜索](https://skillpkg.com/search?collection=articles) 查找内容。
2. 跟随链接进入 `/posts/{slug}`，阅读正文；较大屏幕上的文章大纲可用于跳到相应章节。
3. 文章列出关联技能包时，继续打开对应详情页确认说明与当前发布版本。

## 路径

- 列表：`/posts`。
- 分页：`/posts/page/{page}`。
- 分类分页：`/posts/categories/{slug}/page/{page}`。
- 等价查询形式：`/posts?category={slug}&page={page}`。
- 详情：`/posts/{slug}`。
- 公开内容链接：[文章站点地图](https://skillpkg.com/posts-sitemap.xml)。

搜索参数使用 `collection=articles`，详情页面路径使用 `/posts/`。文章中的软件版本、操作示例和关联包应结合当前来源及详情核对，不要把文章发布时间的状态当作实时状态。

Related: [搜索](https://skillpkg.com/search.md)、[技能包](https://skillpkg.com/packages.md)、[分类](https://skillpkg.com/categories.md)。

---

# SkillPKG 搜索

Canonical page: https://skillpkg.com/search

站内搜索按内容模块分别检索文章、技能包和在线助手。提示词库目前不在站内搜索范围内，请通过 [提示词分类](https://skillpkg.com/prompts) 浏览。

## 网页参数

| 参数 | 说明 |
| --- | --- |
| `q` | 搜索关键词，需要非空；URL 中应编码特殊字符 |
| `collection` | `articles`、`packages` 或 `assistants`；未指定时默认文章 |
| `page` | 从 `1` 开始的页码；切换关键词或模块后从第一页开始 |

示例：[搜索技能包中的 code](https://skillpkg.com/search?q=code&collection=packages&page=1)。其中 code 是查询示例，不表示网站一定有匹配结果。

搜索文章时匹配标题、文章文本及分类名；搜索技能包或助手时匹配名称或标题、简介及分类名。网页搜索不是一次同时检索全部模块的聚合结果。

## 推荐流程

1. 打开搜索页，选择“文章”“技能包”或“助手”。
2. 输入关键词后点击“搜索”。单独切换页签并不提交新的查询，需要再次搜索。
3. 等待搜索请求完成，跟随结果链接进入详情；通过分页控件继续读取结果。
4. 结果为空时尝试更简短的名称、同义词或分类入口。空结果仅表示当前查询未匹配，不表示网站没有该能力。

搜索结果在浏览器中通过请求加载。只获取初始 HTML 的客户端可能看不到结果，应等待页面加载，或读取以下同源搜索接口。

## 网页搜索使用的只读接口

`GET /api/search?q={query}&collection={collection}&page={page}&pageSize={pageSize}`。

- 支持的 collection 仍为 `articles`、`packages`、`assistants`。不要传 `prompts` 或任意集合名。
- 使用非空 q、从 `1` 开始的页码和合理的 pageSize；网页每页使用 `20` 条。
- 成功结果位于 `data.docs`，分页信息位于 `data.meta`，包含 `page`、`totalPages`、`totalDocs` 和 `limit`。
- 文章和助手的结果包含标题与 slug，技能包结果包含名称、slug 和 publicId；网页详情应优先使用返回的实际 slug。
- 该接口服务于网页搜索，不提供下载、投稿或助手运行功能。程序化的 Skill/Solution 分类、筛选、详情和下载请使用 [API Key 接口](https://skillpkg.com/api.md)。

Related: [分类浏览](https://skillpkg.com/categories.md)、[提示词](https://skillpkg.com/prompts.md)、[网站指南](https://skillpkg.com/index.md)。

---

# SkillPKG 分类浏览

Canonical pages: https://skillpkg.com/packages, https://skillpkg.com/prompts, https://skillpkg.com/assistants, https://skillpkg.com/posts

SkillPKG 的技能包、提示词、在线助手和文章分别使用自己的分类。分类入口位于网站导航、页脚及相应内容页面；本站没有统一的 `/categories` 浏览页面。

## 分类路径

| 内容 | 分类分页路径 | 等价查询形式 |
| --- | --- | --- |
| 技能包 | `/packages/categories/{slug}/page/{page}` | `/packages?category={slug}&page={page}` |
| 提示词 | `/prompts/categories/{slug}/page/{page}` | `/prompts?category={slug}&page={page}` |
| 在线助手 | `/assistants/categories/{slug}/page/{page}` | `/assistants?category={slug}&page={page}` |
| 文章 | `/posts/categories/{slug}/page/{page}` | `/posts?category={slug}&page={page}` |

`{slug}` 和 `{page}` 表示占位符，调用时替换为页面实际链接中的分类标识和从 `1` 开始的页码。不要猜测分类 slug，也不要跨模块复用同名分类的标识。

提示词库采用一级、二级分类。浏览一级分类可查看其下的内容，投稿应选择表单提供的二级分类。

## Agent 获取分类的方式

- 网页浏览：读取导航栏、页脚和对应内容页的分类链接，然后跟随链接。
- API 集成：使用需要 API Key 的 `GET /api/v1/skills/categories`，取得技能包分类的 `publicId`、`slug` 和 `name`。
- API 筛选使用 `categoryPublicId`，网页分类使用 slug。该分类接口不返回文章、提示词或助手的分类。

分类名称、层级和内容归属会随平台维护变化；这些指南不列出固定分类清单。首页或列表中的推荐展示也不是独立分类或新产品类型。

Related: [技能包](https://skillpkg.com/packages.md)、[提示词](https://skillpkg.com/prompts.md)、[API](https://skillpkg.com/api.md)。

---

# 向 SkillPKG 提交内容

Canonical pages: https://skillpkg.com/packages/submit, https://skillpkg.com/prompts/submit

网站提供技能包和提示词两种投稿流程，均需要登录并经过审核。请选择与内容匹配的入口；提交成功表示进入审核，不表示已经公开发布。

## 提交技能包

入口：[提交技能包](https://skillpkg.com/packages/submit)。

1. 登录，选择 `Skill`、`Solution` 或 `Claw`。
2. 选择或拖入 ZIP 文件，让页面完成文件校验和解析。
3. 核对解析结果，填写名称、简介、分类、唯一 slug；有来源时填写来源网站。
4. 按页面完成提交，等待审核。在 [我的技能包](https://skillpkg.com/account?tab=my-packages) 查看状态和管理版本。

当前文件要求：

- 使用有效、非空的 ZIP；大小必须小于 `100 × 1024 × 1024` 字节（页面显示为 100MB）。
- Skill 必须包含 `SKILL.md`；Solution 和 Claw 必须包含 `README.md`。将入口文件放在包根目录可使结构更明确。
- Skill 的 SKILL.md 须有 `---` 分隔的头部，包含 `name` 和 `description` 字段；正文不能为空且去除换行后超过 100 个字符，整个文件至少 500 个字符。头部 name 为 1–64 位小写英文字母、数字或连字符，不能以连字符开头、结尾或包含连续连字符。
- Solution 和 Claw 的 README 去除首尾空白后至少包含 200 个字符，并且入口文件之外还需至少一个有效文件。
- Skill 包可同时携带 README。网页可能将 README 作为展示说明，仍需保留实际的 SKILL.md。
- slug 为 2–60 位小写字母、数字和连字符，不能为纯数字，不能以连字符开头或结尾，且不能与已有标识重复。

网页上传的是实际能力包文件，不是仅填写一个 GitHub 链接的收录申请。依赖、配置、运行方法和适用 Agent 应写在包内说明中。以当前校验提示为准修正文件，不要仅根据上述摘要跳过校验。

## 提交提示词

入口：[提交提示词](https://skillpkg.com/prompts/submit)。

1. 登录，填写标题、简介、提示词正文并选择二级分类。
2. 按需添加封面和 HTTP/HTTPS 来源链接。
3. 提交后在 [我的提示词](https://skillpkg.com/account?tab=my-prompts) 查看和管理投稿。

当前表单要求：

| 字段 | 要求 |
| --- | --- |
| 标题 | 必填，最多 40 个字符 |
| 简介 | 必填，最多 300 个字符 |
| 提示词正文 | 必填，最多 20,000 个字符 |
| 分类 | 选择当前表单中的二级分类 |
| 来源链接 | 可选，有值时应为有效 HTTP 或 HTTPS URL |
| 封面 | 可选，JPEG、PNG 或 WebP，最多 500KB |

## 审核与后续操作

公开内容取决于审核和发布状态。草稿、待审核、拒绝或已归档内容不能视为公开内容；应以账户中显示的状态为准。技能包的新版本也需要按页面流程处理。

投稿文件与正文应来自用户准备分享的内容。Agent 可以整理文件、核对字段和协助填写，提交时应遵循用户授权的范围；本文档本身不授权发布内容。[对外 API](https://skillpkg.com/api.md) 仅描述分类、查询、详情与下载，不提供投稿接口。

Related: [技能包类型](https://skillpkg.com/packages.md)、[提示词](https://skillpkg.com/prompts.md)、[账户](https://skillpkg.com/account.md)。

---

# SkillPKG Studio

Canonical page: https://skillpkg.com/studio

SkillPKG Studio 是跨平台的 Agent Skills 桌面管理工具，用于集中管理技能包，并在多个 Agent 中复用。它将发现与导入、本地管理、编辑、安全扫描和安装组合为桌面工作流程。

## 网页与桌面工具的分工

- 网站的 [技能包](https://skillpkg.com/packages) 页面用于发现、阅读和下载能力包。
- [Studio 页面](https://skillpkg.com/studio) 用于了解桌面工具并下载安装包。
- Skills 的本地管理、扫描、编辑、成组切换和向 Agent 安装在 Studio 应用中进行。访问介绍页面不会执行这些本地操作。

## 获取安装包

1. 打开当前 Studio 页面。
2. 根据操作系统选择 Mac（Silicon）、Windows 或 Linux 版本。
3. 使用页面当前给出的下载链接；安装后按应用内流程发现或导入技能，再管理和安装。

网页下载地址来自当前发行配置，不应猜测文件名、版本号或长期保存旧链接。页面当前展示 Mac Silicon 下载入口，不应将其描述为 Intel Mac 安装包。移动端页面会提示在桌面端下载，桌面浏览器可查看下载按钮。

## 功能选择

需要统一管理、编辑或扫描本地 Skills，或向多个 Agent 安装时，可选择 Studio。网站也提供 [Skill/Solution API](https://skillpkg.com/api.md) 供程序查询和下载，它与桌面应用的本地操作是不同入口。

具体支持的 Agent、安装方式、系统要求和扫描配置以当前应用与发行说明为准。扫描结果应结合技能文件及执行环境判断，不能据此推断所有包可直接运行。

Related: [技能包指南](https://skillpkg.com/packages.md)、[API](https://skillpkg.com/api.md)、[网站指南](https://skillpkg.com/index.md)。

---

# SkillPKG 账户与作者主页

Canonical page: https://skillpkg.com/account

公开浏览与个人账户操作使用不同入口。需要登录时使用网站“登录”按钮并完成登录流程；账户页依赖当前用户会话，未登录直接访问可能返回首页。

## 哪些操作需要登录

技能包的网页下载、查看完整长提示词、启动助手、内容投稿，以及自己的内容、收藏、积分和 API Key 管理都需要登录。提示词的未登录复制按钮只复制当前预览，不能据此确认已经获取完整正文。

## 账户入口

| 页面 | 地址 |
| --- | --- |
| 我的技能包 | [查看](https://skillpkg.com/account?tab=my-packages) |
| 收藏技能包 | [查看](https://skillpkg.com/account?tab=fav-packages) |
| 我的提示词 | [查看](https://skillpkg.com/account?tab=my-prompts) |
| 订单记录 | [查看](https://skillpkg.com/account?tab=orders) |
| 积分记录 | [查看](https://skillpkg.com/account?tab=credit-entries) |
| 个人资料 | [查看](https://skillpkg.com/account?tab=personal-info) |

当前积分余额、充值和账户功能以登录后的页面为准。账户中的投稿状态与公开详情是不同视图；待审核或被拒绝内容不能当作公开作品链接。

## API Key

在账户页面使用“API Key 管理”创建、查看列表或删除密钥。完整 Key 仅在创建后显示一次，应立即保存到用户选择的安全位置。它用于 [对外 API](https://skillpkg.com/api.md) 的 `Authorization: Bearer ...` 请求头，不能用网页 Cookie 或内容 publicId 代替。

API Key 是用户凭证，不应写入公开页面、分享链接或投稿内容。创建和删除密钥应属于用户授权的账户操作范围。

## 公开作者主页

跟随详情页的提交人链接打开 `/u/{slug}`。主页默认展示已发布的技能包，提示词页签为 `/u/{slug}?tab=prompts`；分页使用 `page` 参数。主页还可提供个人介绍和外部网站。

作者主页是公开内容入口，不是该用户的账户控制台。使用页面提供的真实 slug，不要将显示昵称当作 URL 标识。

Related: [投稿](https://skillpkg.com/submit.md)、[提示词](https://skillpkg.com/prompts.md)、[API](https://skillpkg.com/api.md)。

---

# SkillPKG Skill/Solution API

Canonical API base: https://skillpkg.com/api/v1

对外 API 用于按分类、类型、推荐状态和名称查询 Skill/Solution，读取详情并获取 ZIP 的临时下载地址。以下接口全部需要 API Key。它们当前只返回已发布、已上架且发布版本审核通过的 `skill` 和 `solution`，不包含 `claw`、提示词、文章或助手会话。

## 鉴权与标识

在 [账户](https://skillpkg.com/account) 的“API Key 管理”创建密钥，然后在请求头中传递：

```http
Authorization: Bearer YOUR_SKILLPKG_API_KEY
```

Key 属于用户凭证。不要放入 URL 查询参数、公开代码或分享内容；网站登录会话不会替代 API Key。

- `publicId`：对外稳定标识，列表返回后用于详情和下载请求。
- `slug`：用于网页跳转，例如 `/packages/{slug}`。
- `categoryPublicId`：分类公开标识，来自分类接口，不是分类 slug 或内部数据库 id。

## 四个接口

| 方法 | 路径 | 返回内容 |
| --- | --- | --- |
| GET | `/api/v1/skills/categories` | `data.docs` 中的全部技能包分类，不分页 |
| GET | `/api/v1/skills` | `data.docs` 中的 Skill/Solution 列表及 `data.meta` 分页信息 |
| GET | `/api/v1/skills/{publicId}` | `data` 中的单个包详情 |
| GET | `/api/v1/skills/{publicId}/download` | `data.url` 中的临时 ZIP 下载链接，不直接返回 ZIP 字节 |

### 列表参数

| 参数 | 默认值 | 说明 |
| --- | --- | --- |
| `type` | Skill 和 Solution | 仅接受 `skill`、`solution`；可重复参数或用逗号分隔 |
| `categoryPublicId` | 所有分类 | 分类接口返回的 publicId；可重复参数或用逗号分隔 |
| `isFeatured` | 不筛选推荐状态 | 仅接受 `true` 或 `false`；false 表示仅非推荐项 |
| `q` | 不按名称筛选 | 名称模糊匹配，与网页搜索的范围不同 |
| `page` | `1` | 正整数 |
| `pageSize` | `20` | `1`–`100` 的整数 |

例如：

```text
/api/v1/skills?type=skill&isFeatured=true&page=1&pageSize=20
/api/v1/skills?type=skill&type=solution
/api/v1/skills?categoryPublicId=FIRST_CATEGORY_PUBLIC_ID,SECOND_CATEGORY_PUBLIC_ID
```

分类标识示例是占位符，须替换为分类接口实际返回的值。列表当前按创建时间倒序返回；没有匹配结果时 `data.docs` 为空，分页信息仍应读取响应。

## 推荐调用顺序

1. 获取分类列表，保存需要的分类 publicId。
2. 查询列表，根据 `data.meta.totalPages` 翻页，不要把第一页当作完整目录。
3. 使用候选项的 publicId 请求详情，读取说明、目录、版本、来源和风险等级。
4. 用户需要下载时，请求该 publicId 的 download 接口，再使用返回的 `data.url` 获取 ZIP。

curl 示例（由调用环境提供 `SKILLPKG_API_KEY`，不要把真实密钥写进文档）：

```sh
curl --fail-with-body 'https://skillpkg.com/api/v1/skills?type=skill&page=1&pageSize=20' \
  -H "Authorization: Bearer ${SKILLPKG_API_KEY}"

curl --fail-with-body 'https://skillpkg.com/api/v1/skills/ACTUAL_PUBLIC_ID' \
  -H "Authorization: Bearer ${SKILLPKG_API_KEY}"

curl --fail-with-body 'https://skillpkg.com/api/v1/skills/ACTUAL_PUBLIC_ID/download' \
  -H "Authorization: Bearer ${SKILLPKG_API_KEY}"
```

将 `ACTUAL_PUBLIC_ID` 替换为列表返回的标识。下载 URL 有时效，应在获取后尽快使用；失效时重新请求，不应当作永久资源链接。访问对象存储下载链接时不需要继续发送 SkillPKG 的 Authorization 请求头。

## 返回数据

成功响应的公共外层为：

```json
{
  "message": "successful",
  "code": 200,
  "data": {}
}
```

列表的 `data` 包含 `docs` 和 `meta`，meta 的字段为 `totalDocs`、`totalPages`、`page`、`limit`。

列表项包含 `publicId`、`slug`、`type`、`name`、`description`、`category`、`author`、`publisher`、`homepage`、`riskLevel`、`isFeatured`。其中部分说明、关联对象和风险信息可以为空。

详情还包含 `skillMd`、`fileStructure`、`version`、`downloadCount`、`createdAt`、`updatedAt`：

- `skillMd` 是发布版本所选展示入口文件的正文，字段名称不保证正文一定来自 SKILL.md；可能来自 README.md。
- `fileStructure` 是文件/目录节点数组，节点包括 `name`、`path`、`type`，可包含 `bytes` 和 `children`；解析失败可返回空数组。
- `riskLevel` 可为 `benign`、`suspicious`、`malicious` 或空值。未知风险不能解释为已通过审查。
- `author` 优先反映提交用户的信息，`publisher` 为另一个作者/发布者信息对象；需要署名或核对来源时应结合二者及原始链接。

下载成功时 `data` 为 `{ "url": "临时下载地址" }`。它没有独立版本选择参数，获取的是该记录当前发布文件的下载链接。

## 错误处理和时效

错误响应包含 `error` 字符串，按 HTTP 状态处理：

| 状态 | 下一步 |
| --- | --- |
| `400` | 修正页码、pageSize、类型或 isFeatured 参数 |
| `401` | 检查是否提供有效 API Key；不要改用网页登录凭证尝试绕过 |
| `404` | 详情不存在、未公开或下载文件不可用，重新确认实际 publicId 与当前列表 |
| `500` | 服务端错误，保留错误信息并稍后重试 |

分类和查询结果使用服务端缓存，因此不能作为实时变更通知。下载链接与发布状态应在需要下载时重新获取。这里描述的接口不支持投稿、内容修改、助手运行或本地安装。

Related: [技能包](https://skillpkg.com/packages.md)、[分类](https://skillpkg.com/categories.md)、[账户](https://skillpkg.com/account.md)、[搜索](https://skillpkg.com/search.md)。

---

# 关于 SkillPKG

Canonical page: https://skillpkg.com/

SkillPKG（技能包）以“能力，即服务”为定位，希望让知识工作者将经验沉淀为可复制、可扩展、可升级的能力资产，并通过 AI 提升工作效率和专业产出。

网站的主要内容为 [技能包](https://skillpkg.com/packages.md)、[提示词](https://skillpkg.com/prompts.md)、[在线助手](https://skillpkg.com/assistants.md) 和 [文章](https://skillpkg.com/posts.md)。[SkillPKG Studio](https://skillpkg.com/studio.md) 提供桌面端的本地 Skills 管理与多 Agent 复用。

部分技能内容来自互联网或用户上传，内容版权归原作者所有。平台提供发现、整理、审核和使用入口；包的具体许可、依赖、安装和维护信息应查阅原始来源与包内文件。平台推荐或审核并不意味着平台拥有所有内容的版权或负责所有来源项目的维护。

## 联系和条款

- 联系邮箱：support@skillpkg.com。版权问题可通过该邮箱反馈。
- [服务协议](https://skillpkg.com/terms-of-service)。
- [隐私政策](https://skillpkg.com/privacy-policy)。
- [提交内容指南](https://skillpkg.com/submit.md)。
- [Agent 文档索引](https://skillpkg.com/llms.txt)。

这些文件是网站使用说明。具体内容、可用功能、积分规则和下载版本以当前页面或接口为准。