菜单
Best practices for writing effective OpenClaw / Claude Code compatible SKILL.md files. Use when the user wants to create a new skill, improve an existing skill's triggering accuracy, or review a skill draft.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
支付宝开放平台支付产品接入最佳实践。涵盖当面付、订单码支付、App 支付、JSAPI 支付、手机网站支付、电脑网站支付、预授权支付、商家扣款等全场景产品选型与集成指导。
高德地图综合服务，支持 POI 搜索、路径规划、旅游规划、周边搜索和热力图数据可视化。需要用户配置高德地图 API Key。
持续学习：自动记录错误、用户纠正和外部 API 失败，避免重复犯错。当用户说"记住错误"、"我之前说过"、"不要重复犯"时使用。
使用 summarize CLI 总结 URL、PDF、图片、音频、YouTube 视频。给定一个 URL 或本地文件，返回简洁的摘要。
Guide users through a structured workflow for co-authoring documentation, proposals, technical specs, decision docs, or similar structured content. Use when the user mentions writing docs, drafting a proposal, creating a spec, writing a PRD/RFC, or starting a substantial writing task.
Add or fix LLM provider integrations (OpenAI, Azure, Deepseek, MiMo, SGLang). Activates on provider, endpoint, API key, chat/completions, or files under the llm/ directory.
| name | skill-writing-guide |
| description | Best practices for writing effective OpenClaw / Claude Code compatible SKILL.md files. Use when the user wants to create a new skill, improve an existing skill's triggering accuracy, or review a skill draft. |
| tags | ["skill","meta","prompt-engineering","authoring","guidelines"] |
| priority | 55 |
| mode | advisory |
| triggers | {"keywords":["write a skill","create skill","skill authoring","skill writing","写 skill","创建 skill","skill 触发","skill description"]} |
帮助用户写出高质量、易触发、可维护的 OpenClaw / Claude Code 风格 SKILL.md 文件。
Skill 的核心是 description + frontmatter。Description 是主要触发机制，必须同时说明：
---
name: my-skill-name # 小写，连字符分隔
description: "做什么 + 什么时候用。描述要稍微主动一点（pushy），确保 skill 在相关场景下被触发。"
tags: [tag1, tag2]
priority: 60 # 0-100，越高越优先
mode: advisory # advisory | strict
triggers:
keywords:
- keyword1
- keyword2
---
Claude 有 "undertrigger" 倾向：即使在相关场景也可能不用 skill。因此 description 要主动：
❌ 不好：
"How to build a dashboard for internal data."
✅ 更好：
"How to build a dashboard for internal data. Use this skill whenever the user mentions dashboards, data visualization, internal metrics, or wants to display company data, even if they don't explicitly ask for a 'dashboard.'"
skill-name/
├── SKILL.md # 必需：YAML frontmatter + markdown 说明
├── references/ # 可选：按需加载的参考文档
├── scripts/ # 可选：确定性/重复性任务的脚本
└── assets/ # 可选：模板、图标、字体等输出资源
❌ 不要：
"You should consider using web_search first."
✅ 要：
"First, use web_search."
## 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 authentication
如果 skill 支持多个框架/平台，按 variant 组织：
cloud-deploy/
├── SKILL.md
└── references/
├── aws.md
├── gcp.md
└── azure.md
建议每个 skill 包含 5-15 个关键词，覆盖同义和变体。
| 问题 | 后果 | 修复 |
|---|---|---|
| Description 只讲功能不讲场景 | skill 不被触发 | 加入 "Use when..." |
| Body 超过 500 行 | 稀释注意力 | 拆分到 references/ |
| 关键词太少 | 匹配率低 | 加同义词和场景词 |
| 指令太抽象 | agent 执行不一致 | 给具体步骤和示例 |
| 包含恶意/意外行为 | 安全风险 | 遵循 "lack of surprise" 原则 |