← 文档Markdown登录

智能体手册

面向通过 MCP 使用编码智能体的简明说明。

你已连接到 Skillkren,这是一个可复用 AI 技能及其产出示例的库。技能遵循开放的 Agent Skills 格式:一份 SKILL.md(带 name 和 description frontmatter 的说明),以及可选的 references/、scripts/ 和 assets/ 文件。

品牌名: 一律 Skillkren。域名:skillkren.tech。

第一步

  1. 如需回顾,调用 get_docs,topic 为 agent(或读取资源 https://skillkren.tech/docs/agent.md)。
  2. 创建前先用 list_skills 检查用户的技能及其团队库,避免重复。要打开他人分享的技能,用 get_skill 并传入链接中的 id。
  3. Free 方案用户最多可保存 25 个技能;达到上限时 upsert_skill 会返回错误。不要绕过。
  4. 用清晰的标题调用 upsert_skill。它会更新同标题的自有技能,或创建新技能。传入 team 以在团队库中操作。
  5. 发布新技能时始终附加至少一个 示例(add_example)。

使用技能

  1. 用 get_skill 加载并遵循其说明。
  2. get_skill 按路径列出捆绑的 files。仅当说明指向该文件或任务需要时,才用 get_skill_file 读取。
  3. 以技能的示例作为格式、语气和质量的参考。

编写好技能

  • 描述: 技能做什么,以及何时使用,使用用户实际会说的话。智能体仅凭这段决定是否加载。
  • 说明(content):原始 Markdown,不是 HTML。步骤、规则,以及优质输出的样子。尽量控制在约 500 行以内。
  • 参考文件: 用 put_skill_file 把长内容(风格指南、API 说明、清单)放到 references/,并在说明中按路径点名,例如 "For banned words, read references/banned-words.md"。模板和数据放在 assets/,可运行代码放在 scripts/。
  • 许可证: 仅在用户选择时设置 license(例如 MIT、Apache-2.0、CC-BY-4.0、Proprietary)。询问用户;不要替他们选择。
  • 要求: 仅当技能需要特定工具或访问权限时设置 compatibility。

上传技能文件夹

当用户要求你上传本地技能(例如 ~/.claude/skills/pdf-processing/)时:

  1. 读取 SKILL.md。使用其 name(作为可读标题)、description 和 license;frontmatter 之后的正文是 content。
  2. 用这些字段调用 upsert_skill。如果文件夹有 LICENSE 文件,将其文本作为 licenseText 传入。
  3. 对 references/、scripts/ 和 assets/ 下的每个文件,用相同的相对路径调用 put_skill_file,例如 references/forms.md。
  4. 仅支持每个最多 100 KB 的文本文件,每个技能最多 30 个,深度一层子文件夹。跳过二进制文件(图片、PDF),并告知用户跳过了哪些文件。
  5. 完成后把技能链接给用户。

反向操作时,用户可从技能页面下载 zip,并解压到应用的 skills 文件夹。

可见性

新技能为 Private(仅所有者)。Unlisted 技能任何有链接的人都可以打开;Public 技能还会列在所有者的个人主页 https://skillkren.tech/u/<username>。

你无法更改可见性。如果用户想分享技能,引导他们打开技能页面,并使用标题旁的开关。切勿建议分享含有密钥的技能。

身份上下文

你的连接属于一个用户。你创建的一切归该用户所有,且你只能更改该用户有权更改的内容。

可引用的 URL

  • 应用:https://skillkren.tech/app
  • 技能:使用工具返回的 url。形如 https://skillkren.tech/u/<username>/skills/<id>。
  • 示例:技能 URL 加上 /examples。参考文件:技能 URL 加上 /references。
  • 文档:https://skillkren.tech/docs
  • 智能体文档(原始):https://skillkren.tech/docs/agent.md

不要做的事

  • 除非用户确认,否则不要删除技能或文件。
  • 不要把密钥粘贴到技能、文件或示例中。
  • 不要依赖客户端渲染;存储 Markdown 源文件。