writing-skills
编写高质量 AI Agent 技能
也可从以下获取: Cygnusfear,Cycleaddict,ZhanlinCui,davila7,obra,Dimon94,DYAI2025,CodingCossack
此技能提供创建和改进 AI agent 技能的模板、决策树和最佳实践。它帮助用户避免常见错误并遵循标准化模式。
下载技能 ZIP
在 Claude 中上传
前往 设置 → 功能 → 技能 → 上传技能
开启并开始使用
测试它
正在使用“writing-skills”。 我想创建一个处理 API 错误的技能
预期结果:
一个完整的 SKILL.md，包含：name: api-error-handler，description: '当 API 请求失败或返回错误状态时使用'，带有 triggers: api-error, network-failure, 503 的元数据，以及 references/ 文件夹用于详细的处理程序
正在使用“writing-skills”。 我的技能描述是'此技能帮助进行文件操作' - 未触发
预期结果:
优化后的描述：'当用户要求读取、写入或修改文件时使用。触发词：file-create, file-edit, file-delete, touch, mkdir, rm command'
安全审计
安全This is a documentation and reference skill providing guidance on writing AI agent skills. All static findings are false positives - the scanner detected patterns in markdown documentation (code formatting with backticks, mentions of cryptographic terms, URLs in documentation) rather than actual executable code. The render-graphs.js is a build script for documentation generation, not runtime functionality.
质量评分
你能构建什么
创建新技能
使用决策树选择合适的架构层级和模板来创建新技能，然后按照模板结构进行。
改进现有技能
诊断技能未被触发或被 agent 忽略的原因，然后应用反合理化或 CSO 技术。
标准化团队技能
确保所有团队技能遵循一致的命名规范、元数据标准和目录结构。
试试这些提示
我需要创建一个名为 [skill-name] 的新技能。它应该 [功能描述]。使用 writing-skills 参考中的 Tier 1 模板。
我的技能 [skill-name] 未被 Claude 触发。描述是：[description]。应用 writing-skills 中的 CSO 优化。
我有一个纪律技能，其中包含 Claude 经常忽略的规则。规则是：[rules]。应用反合理化技术。
我需要创建一个包含多个概念的复杂技能（200-1000 行）。使用具有适当引用的 Tier 2 扩展架构。
最佳实践
- 始终以'当...时使用'开头描述，后跟具体触发条件
- 在 metadata.triggers 中至少包含 3 个关键词以提高可发现性
- 单文件技能保持在 200 行以内；较长内容使用 references/
- 使用层级系统将单一技能拆分为多个文件
避免
- 描述工作流程而非触发条件（例如'此技能帮助创建文件'而非'当用户想要创建文件时使用'）
- 使用通用技能名称如'helper'或'utility'而非描述性的动名词
- 缺少 metadata.triggers 字段或触发关键词少于 3 个
- 创建冗长的单一 SKILL.md 文件而非模块化的 references/