Skills

一次保存、随时运行的可复用 AI 提示词，支持模板变量、自带 Anthropic 或 OpenAI 密钥（BYOK），并完整记录每次执行日志。

什么是 Skill？

Skill 是存储在项目中的命名提示词模板。每个 Skill 包含以下信息：

名称与描述

说明 Skill 的用途，显示在列表和选择器中。

主体（Body）

提示词模板，运行时将 {{variables}} 替换为实际值。

提供商与模型

Anthropic 或 OpenAI，以及具体模型（如 claude-sonnet-4-6、 gpt-5-mini）。

输入参数模式（可选）

说明 Skill 期望接收哪些参数，从 MCP 运行时尤为有用。

保存到 Space（可选）

自动将每次执行的输出作为 Knowledge Item 持久化到指定 Space。

执行历史

每次执行均记录输入参数、输出内容、Token 数量、费用及时间戳。

使用自己的密钥（BYOK）

Skills 在你自己的 Anthropic 或 OpenAI 账户上运行。每个项目独立存储密钥，方便将个人项目与客户项目分开计费。

1. 在仪表盘中打开项目并点击 Settings。
2. 向下滚动到 LLM API Keys (BYOK)。
3. 点击 Anthropic 或 OpenAI 旁的 Add key，粘贴密钥并保存。
4. 密钥在项目级别加密存储，保存后不会返回到界面——你可以随时替换或删除。

注意：若 Skill 配置为使用 openai，而项目未设置 OpenAI 密钥，则执行将失败，反之亦然。

创建 Skill

可从仪表盘创建 Skills，也可通过 MCP 直接在 Claude 中创建。

从仪表盘创建

1. 打开项目，在侧边栏点击 Skills。
2. 点击 New Skill。
3. 填写名称和描述。
4. 选择提供商（Anthropic 或 OpenAI）和模型。
5. 编写提示词主体，用 {{topic}} 标记运行时传入的变量。
6. （可选）选择一个 Space 用于自动保存每次执行的输出。
7. 点击 Create。

从 Claude（MCP）创建

# 让 Claude 创建一个 Skill

"Create a skill called 'Tweet draft' that writes a 280-char tweet about {{topic}} with one emoji"

"Add an OpenAI gpt-5-mini skill called 'Daily standup' that writes 3 bullets of yesterday's progress about {{date}}"

运行 Skill

从仪表盘运行

打开 Skill，点击 ▶ Run，粘贴包含变量的 JSON 对象（编辑器会自动格式化和修复粘贴的 JSON），再点击 Execute。结果将出现在 Execution history 中，附带 Token 数量和费用。

{
  "topic": "the Mars 2026 mission"
}

从 Claude（MCP）运行

按名称运行 Skill（Claude 会自动查找 ID），或直接传入 UUID：

"Run the 'Tweet draft' skill with topic 'launching Skills v1'"

"Execute skills_run with skill_id abc-123 and input { topic: 'Mars rover' }"

仪表盘和 MCP 的执行记录均保存在同一份执行历史中——唯一的数据来源。

变量模板

在主体的任意位置使用 {{name}} 标记变量。运行时，Skills 会用输入参数中对应的键值替换占位符：

主体（Body）

Write a friendly LinkedIn post about {{feature}}.
Audience: {{audience}}.
Tone: {{tone}}.

输入参数

{
  "feature": "Skills v1",
  "audience": "developers",
  "tone": "excited"
}

输入参数中缺失的键将在提示词中原样保留（如字面量 {{tone}}），Skill 仍会执行，但模型会看到占位符文本。

执行历史

每次执行——无论来自仪表盘、MCP 还是（未来的）Routine——都会在 Skill 的执行历史中创建一行记录，包含以下内容：

状态

completed 或 failed。失败记录同样保存在历史中，附带错误信息。

触发来源

manual、 mcp ——记录执行的来源。

Token 与费用

输入 Token 数、输出 Token 数，以及基于模型定价的 USD 估算费用。

输入 / 输出

点击任意行的 Show output / input 可查看发送的 JSON 参数及模型的回复。

MCP 工具参考

Skills 是 MCP 的一等公民。以下六个工具暴露给 Claude 及所有兼容 MCP 的客户端：

skills_list新

列出项目中的所有 Skills。

参数

名称	必填	描述
project_id	是	项目 UUID

skills_get新

按 ID 获取单个 Skill，包含完整主体内容。

参数

名称	必填	描述
id	是	Skill UUID

skills_create新

在项目中创建新的 Skill。

参数

名称	必填	描述
project_id	是	项目 UUID
name	是	Skill 名称
body	是	提示词模板
llm_provider	是	`anthropic` 或 `openai`
model	是	模型标识符
description	否	简短摘要
save_to_space_id	否	自动将输出保存到该 Space

skills_update新

更新已有 Skill（名称、主体、模型、提供商、描述或保存目标）。

skills_run新

对已配置的 LLM 执行 Skill，返回输出并记录执行行。

参数

名称	必填	描述
skill_id	是	Skill UUID
input_params	否	代入主体的 JSON 对象

skills_delete危险操作

永久删除 Skill。执行历史行保留用于审计，但 Skill 本身将无法再运行。

使用场景

每日内容草稿

一个"LinkedIn 帖子"Skill，接收 {{feature}} 并生成 3 段式公告，自动将每次输出保存到 Marketing Space。

标准化 PR 摘要

接收 {{diff}} 并按团队格式生成结构化 PR 摘要的 Skill。

客户支持回复

接收 {{ticket}} 并起草语气匹配的回复草稿，供团队编辑后发送。

定期研究

"每周竞品扫描"Skill——即将通过 Routines（第二阶段）支持计划执行——汇总竞品动态并保存结果供审阅。

限制与定价

Skills 使用你自己的 LLM 密钥运行，因此每次执行的费用直接支付给 Anthropic 或 OpenAI——ContextForge 不对 Token 加价。仪表盘在每行执行记录中显示 USD 估算费用，方便你掌控支出。

执行一次 Skill 计入你当月 ContextForge 计划配额中的一次查询。