← 文档Markdown登录

技能与示例

创建、复制并整理技能与示例。

Skillkren 遵循 Claude、Codex、Cursor 等所用的开放 Agent Skills 格式。一个技能就是一个文件夹:

pdf-processing/
├── SKILL.md        instructions (required)
├── LICENSE.txt     license terms (optional)
├── references/     docs the agent reads only when needed
├── scripts/        code the agent can run
└── assets/         templates and data

技能

  • 标题:导出时成为文件夹的 name(小写、短横线)。
  • 描述(必填):技能做什么,以及何时使用。智能体先读这段来决定是否加载该技能,因此请写明场景和关键词。
  • 说明:SKILL.md 的正文,使用 Markdown。尽量控制在约 500 行以内,长内容放到 references。
  • 标签(可选)。
  • 许可证(可选):MIT、Apache 2.0、CC BY 4.0、CC0、Proprietary,或其他。添加完整条款后会导出为 LICENSE.txt。
  • 要求(可选):仅当技能需要特定工具或访问权限时填写,例如 "Needs Python 3.12 and internet access"。导出为 compatibility。
  • 可见性:Private(默认)、某个团队、Unlisted 或 Public。详见 /docs/visibility。

创建技能时粘贴完整的 SKILL.md,标题、描述和许可证会从前言(frontmatter)自动填入。

稳定 URL:/u/<username>/skills/<uuid>

参考文件与其他文件

打开技能的 References 标签,在 references/、scripts/ 或 assets/ 下添加文件。在 SKILL.md 中按路径提及每个文件(例如 "For the full style rules, read references/style-guide.md"),以便智能体知道何时打开。仅支持文本文件,每个最多 100 KB,每个技能最多 30 个。

示例

示例属于某个技能,展示真实输出。它们让技能可信:队友或智能体能准确看到「好」的结果是什么样。

  • 列表:/app/skills/<uuid>/examples
  • 详情:/app/skills/<uuid>/<example-slug>

版本历史

对说明、描述、标签或许可证的每次编辑都会保存为带编号的版本。Free 方案显示最近 2 个;Pro 和 Team 显示全部。

复制、下载、安装

  • 复制技能 复制完整的 SKILL.md 说明。
  • 下载 .zip 提供整个文件夹(带 frontmatter 的 SKILL.md、LICENSE.txt、references)。

安装下载内容:

  • Claude(应用): Settings → Capabilities → Skills → 上传 zip。
  • Claude Code: 解压到 ~/.claude/skills/(或项目中的 .claude/skills/)。
  • Codex / Cursor / 其他: 解压到应用的 skills 文件夹(例如 ~/.codex/skills/)。

也可以跳过下载,通过 MCP 连接智能体,让它始终读取最新版本。详见 /docs/connectors。