下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/user_1a99cb00--anthropics-skills.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_1a99cb00/anthropics-skills。来源于 Anthropic 官方 Agent Skills 仓库(github.com/anthropics/skills,165k stars),Marvis 适配版。完整覆盖 Agent Skills 规范(agentskills.io)、设计方法论(渐进式披露/三层加载/领域变体模式)、17 个官方示例技能速查(算法艺术/MCP 构建/前端设计/文档处理/品牌规范/skill 创建器等),以及从零创建+发布 Skill 的完整工作流。
⚠️自动激活:设计/评估/创建/改进/审查 Agent Skill、写 SKILL.md、制定 skill 规范、skill 触发词设计、skill 目录结构、YAML frontmatter、渐进式披露、skill marketplace、agent 能力扩展、skill 模板、skill 验证、文档处理(Word/PPT/PDF/Excel)。
阅读全文 (展开查看完整说明)
概述
Anthropic Agent Skills Standard
来源: anthropics/skills (165k ⭐) · agentskills.io
适配目标: Marvis Skill 格式(保持 Anthropic 规范语义,适配 SkillHub 发布)
技能自动激活规则
触发矩阵
| 用户意图领域 | 阶段 | 匹配关键词 | 指引章节 |
|---|---|---|---|
| Skill 创建 | 设计/起草 | 创建 skill、写 SKILL.md、设计 skill、新建技能、skill 模板 | §3 Skill 创建方法论 |
| Skill 创建 | 规范校验 | skill 规范、YAML frontmatter、name 字段、description 字段、目录结构 | §2 规范速查 |
| Skill 优化 | 改进/迭代 | 改进 skill、优化 skill 描述、skill 触发不准、skill 调试 | §4 Skill 优化循环 |
| Skill 审查 | 评估 | 审查 skill、评估 skill、skill 质量 | §4 Skill 优化循环 |
| 文档技能 | 生成文档 | Word、docx、PPT、pptx、PDF、Excel、xlsx、生成文档、文档处理 | §6 技能速查 |
| 前端设计 | UI/UX | 前端设计、UI 设计、web component、页面设计 | §6 技能速查 |
| MCP 开发 | 协议开发 | MCP server、MCP 构建、MCP 工具 | §6 技能速查 |
自举哨兵
每当你被要求"设计/评估/改进一个 Agent Skill"但未显式加载本技能时,回顾本章的规范速查和设计方法论作为基线参考。
§1 架构概览
技能本质
Skill = 一个包含指令、脚本和资源的文件夹,AI Agent 动态加载以提升特定任务的执行质量。
skill-name/
├── SKILL.md (必需) ← YAML frontmatter + Markdown 指令体
├── scripts/ (可选) 可执行代码,确定性/重复任务
├── references/ (可选) 按需加载的参考文档
└── assets/ (可选) 静态资源(模板、图标、字体等)渐进式披露(Progressive Disclosure)
Agent 按三层加载,逐级深入:
| 层级 | 内容 | Token 预算 | 加载时机 |
|---|---|---|---|
| L1 元数据 | name + description | ~100 tokens | 启动时全部加载 |
| L2 指令体 | SKILL.md 正文 | <500 行建议 | 技能激活时加载 |
| L3 资源 | scripts/references/assets | 按需无上限 | 任务需要时才加载 |
核心设计原则:SKILL.md 控制在 500 行以内。超限时增加一层引用层级,指向 references/ 中的分文件。
§2 规范速查
SKILL.md 格式
---
name: my-skill-name # 必需。1-64字符,小写字母+数字+连字符
description: ... # 必需。1-1024字符。技能做什么 + 何时触发
license: Apache-2.0 # 可选
compatibility: ... # 可选。环境要求(仅在有特殊需求时)
metadata: # 可选。key-value 扩展字段
custom_key: value
allowed-tools: ... # 可选。预授权工具列表(实验性)
---
# 技能指令正文
(Markdown 格式,建议含:分步指令 / 输入输出示例 / 常见边界情况)name 字段约束
- 1-64 字符
- 仅小写字母 (a-z)、数字 (0-9)、连字符 (-)
- 不能以连字符开头或结尾
- 不能含连续连字符 (–)
- 必须与父目录名一致
有效: pdf, frontend-design, mcp-builder 无效: PDF, _pdf, pdf--tool, -pdf
description 字段——触发精确性
description 是技能的主要触发机制。编写要点:
- 双维度描述:技能做什么 + 何时使用
- 包含具体触发词:文件名后缀(
.pdf、.docx)、领域术语("deck"、"presentation")、用户意图("create"、"extract") - 偏向"过度触发"而非"触发不足":宁可多触发被忽略,也不错失使用时机
好示例(docx 技能):
Use this skill whenever the user wants to create, read, edit, or manipulate
Word documents (.docx files). Triggers include: 'Word doc', '.docx', '.dotx',
requests to produce professional documents, inserting images, tracked changes,
find-and-replace. If the user asks for a 'report', 'memo', 'letter', or
similar deliverable as a Word file, use this skill.差示例:
Helps with Word documents.文件引用
在 SKILL.md 中引用技能内其他文件时,使用相对路径(从技能根目录起算):
详见 [REFERENCE.md](references/REFERENCE.md)
运行 `python scripts/process.py input.pdf`保持引用层级为一级深度。避免深层嵌套引用链。
验证
使用 skills-ref 库校验 SKILL.md 是否符合规范。
§3 Skill 创建方法论
完整创建流程
意图捕获 → 访谈调研 → 编写草稿 → 测试评估 → 迭代优化 → 发布3.1 捕获意图
向用户确认四项基线:
| 问题 | 说明 |
|---|---|
| 技能做什么? | 明确输出和能力边界 |
| 何时触发? | 哪些用户短语/上下文应激活此技能 |
| 输出格式? | 期望的输出结构和格式 |
| 是否需要测试用例? | 可客观验证(文件转换、数据提取)→ 建议设测试;主观输出(风格、艺术)→ 通常不需要 |
3.2 访谈与调研
主动追问:
- 边界情况:空输入、超大文件、格式异常
- 输入输出格式:具体文件类型、期望结构
- 示例文件:是否可提供参考样例
- 成功标准:什么算"做对"?
- 依赖:外部工具、库、MCP 服务
3.3 编写 SKILL.md——写作规范
指令风格
- 使用祈使句(imperative form)
- 解释为什么而非堆砌 MUST(用"理论心智"让模型理解意图)
- 通用化,避免过度绑定特定示例
输出格式定义
## Report structure
ALWAYS use this exact template:
# [Title]
## Executive summary
## Key findings
## Recommendations示例模式
## Commit message format
**Example 1:**
Input: Added user authentication with JWT tokens
Output: feat(auth): implement JWT-based authentication3.4 测试用例
编写 2-3 个真实用户会说的测试 prompt(先不带断言):
{
"skill_name": "example-skill",
"evals": [
{
"prompt": "帮我把这份合同里的甲乙方信息提取出来",
"expected_behavior": "应输出结构化 JSON,含甲方/乙方名称、地址、联系方式"
}
]
}3.5 目录组织——领域变体模式
当技能支持多领域/多框架时,按变体组织:
cloud-deploy/
├── SKILL.md (工作流 + 选择逻辑)
└── references/
├── aws.md
├── gcp.md
└── azure.mdAgent 只加载相关的 reference 文件。
§4 Skill 优化循环
4.1 触发优化
Skill 存在"触发不足"倾向(undertrigger)。优化策略:
- description 中明确列出具体场景而非抽象描述
- 包含文件名模式:
.pdf、.docx、Dockerfile - 包含用户意图表述:不只是"处理 PDF",而是"提取 PDF 文本、合并 PDF、PDF 转图片、OCR PDF"
- 包含否定边界:"不要用于电子表格"、"不要用于网页"
4.2 质量评估维度
| 维度 | 检查项 |
|---|---|
| 触发精准度 | description 是否覆盖了目标场景?是否有明显的漏触发? |
| 指令清晰度 | 步骤是否可按顺序执行?歧义是否最小化? |
| 边界覆盖 | 常见错误路径是否被处理? |
| Token 预算 | SKILL.md 是否 <500 行?是否合理使用了 references 分流? |
| 可验证性 | 是否有明确的成功/失败判定标准? |
4.3 迭代流程
评估结果 → 定位问题(触发/指令/边界)→ 修改 SKILL.md → 重测 → 重复至满意§5 禁止事项
- 技能不得含恶意代码、漏洞利用或任何危及系统安全的内容
- 不得创建误导性技能(其意图与描述不符)
- 不得设计用于未授权访问、数据泄露的 skill
- "角色扮演"类技能——可以,但不鼓励用 skill 承载纯人格模拟
§6 Anthropic 官方技能速查
共 17 个官方示例技能:
创意与设计
| 技能 | 触发关键 | 说明 |
|---|---|---|
algorithmic-art | generative art, p5.js, algorithmic art, creative coding | p5.js 算法艺术生成 |
canvas-design | poster, design, canvas, visual design | 画布风格视觉设计(PNG/PDF) |
frontend-design | frontend, UI, web component, page, landing page, dashboard | 生产级前端界面构建,含 67 种 UI 风格和 21 色板 |
theme-factory | theme, color palette, style, visual theme | 主题/风格工厂,生成配色方案和视觉主题 |
slack-gif-creator | Slack GIF, animated GIF, Slack animation | Slack GIF 动图制作 |
开发与技术
| 技能 | 触发关键 | 说明 |
|---|---|---|
mcp-builder | MCP server, MCP tool, Model Context Protocol | MCP 服务器构建(Python/Node.js),含完整开发+测试+发布流程 |
web-artifacts-builder | artifact, web artifact, Claude artifact | 复杂 Web Artifact 构建(React + Tailwind + shadcn/ui) |
webapp-testing | web testing, Playwright, browser test | Web 应用 Playwright 测试,含登录态复用和 CI 集成 |
skill-creator | create skill, improve skill, skill eval | 技能创建/改进/评估全流程(本 repo 最完整的方法论 skill) |
claude-api | Claude API, Anthropic API, API integration | Claude API 集成指南 |
企业与沟通
| 技能 | 触发关键 | 说明 |
|---|---|---|
brand-guidelines | brand, brand guidelines, company colors, logo | 企业品牌规范应用 |
internal-comms | internal comms, company announcement, status report | 内部沟通文档(状态报告、公告、FAQ) |
doc-coauthoring | coauthor, collaborative writing, document co-writing | 文档协作写作(结构化流程:讨论→大纲→起草→迭代) |
文档处理(源可用,非开源)
| 技能 | 触发关键 | 说明 |
|---|---|---|
docx | Word, .docx, .dotx, document, report, memo, letter | Word 文档创建/编辑/读取(docx-js + OOXML 直接操作) |
pdf | PDF, .pdf, extract PDF, merge PDF, OCR, PDF form | PDF 全功能处理(pypdf + pdfplumber + reportlab) |
pptx | PPT, slides, presentation, deck, pitch, .pptx, .potx | PPT 幻灯片创建/编辑/分析(pptxgenjs + OOXML 直接操作) |
xlsx | Excel, spreadsheet, .xlsx, .csv, table, data | Excel 电子表格创建/编辑(OpenPyXL + xlsxwriter) |
核心设计模式总结
从官方 17 个技能中提取的通用模式:
1. "任务-方案"表格分流(pdf/docx/pptx/xlsx 通用)
| Task | Approach |
| Create | Write a library script |
| Edit | unzip → edit XML → zip |
| Read | command-line tool |2. "脚坑清单(Gotchas)"模式(pptx/docx 特色)列出框架/库的已知陷阱和纠正方式,每个条目一行:
- **Hex colors: never `#`, never 8 digits** — `color: "FF0000"`
- **`PageBreak` must be inside a `Paragraph`**3. "验证输出"自检模式
## Verify the output
After generating, run validation:
python scripts/validate.py output.file4. 脚本清单表格
| Script | What it does |
|---|---|
scripts/thumbnail.py input.pptx | 生成幻灯片缩略图网格 |
§7 实战:从零创建 Skill 的完整模板
模板文件
基于 Anthropic 官方 template:
---
name: my-skill-name
description: A clear description of what this skill does and when to use it.
Include specific trigger keywords and file patterns.
---
# My Skill Name
## Overview
Brief one-paragraph description of the skill's purpose.
## When to Use
- Scenario 1: when user mentions X
- Scenario 2: when files with .ext suffix appear
- Scenario 3: when user asks to do Y
## Instructions
### Step 1: ...
### Step 2: ...
### Step 3: ...
## Examples
**Example 1:**
Input: ...
Output: ...
## Guidelines
- Guideline 1
- Guideline 2
- Guideline 3发布到 SkillHub
cd /path/to/your-skill
skillhub publish§8 与 Marvis Skill 的适配差异
| 维度 | Anthropic 原版 | Marvis 适配 |
|---|---|---|
| 触发机制 | description 字段为主 | description 字段 + summary 触发词 + §自举哨兵 |
| 渐进式披露 | 平台原生支持 | 通过 references/ 拆分实现等效效果 |
| 脚本执行 | skills/ 内脚本可直接执行 | 通过 shell_executor 执行 |
| 发布方式 | Claude Code Plugin marketplace | SkillHub CLI (skillhub publish) |
| 兼容性 | Claude Code / Claude.ai / API | Marvis(Main Agent + Sub Agent) |