jnMetaCode/superpowers-zh / skills/writing-skills
writing-skills
Verified当创建新技能、编辑现有技能或在部署前验证技能是否有效时使用
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 15.6 KB |
| anthropic-best-practices.md | markdown | 41.5 KB |
| examples/CLAUDE_MD_TESTING.md | markdown | 5.3 KB |
| graphviz-conventions.dot | other | 5.8 KB |
| persuasion-principles.md | markdown | 5.3 KB |
| references/bulletproofing.md | markdown | 2.0 KB |
| references/discovery.md | markdown | 5.8 KB |
| references/flowcharts.md | markdown | 1.2 KB |
| references/skill-template.md | markdown | 1.2 KB |
| render-graphs.jsexecutable | script | 5.5 KB |
| testing-skills-with-subagents.md | markdown | 12.1 KB |
references/skill-template.md
View on GitHub## SKILL.md 结构
**Frontmatter(YAML):**
- 两个必需字段:`name` 和 `description`(完整支持字段参见 [agentskills.io/specification](https://agentskills.io/specification))
- 总计最多 1024 字符
- `name`:只使用字母、数字和连字符(不要用括号、特殊字符)
- `description`:第三人称,仅描述何时使用(不是做什么)
- 以"Use when..."开头,聚焦于触发条件
- 包含具体的症状、场景和上下文
- **绝不总结技能的流程或工作流**(参见 SDO 章节了解原因)
- 尽量控制在 500 字符以内
```markdown
---
name: Skill-Name-With-Hyphens
description: Use when [具体的触发条件和症状]
---
# 技能名称
## 概述
这是什么?用 1-2 句话说明核心原则。
## 何时使用
[如果决策不明显,使用小型内联流程图]
症状和用例的要点列表
不适用的场景
## 核心模式(技术/模式类)
前后代码对比
## 快速参考
用于快速浏览常见操作的表格或要点
## 实现
简单模式内联代码
大量参考或可复用工具链接到文件
## 常见错误
常见问题 + 修复方法
## 实际效果(可选)
具体结果
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |