Agent Skills
› aiming-lab/MetaClaw
› technical-writing-clarity
technical-writing-clarity
GitHub提供技术文档写作指南,涵盖README、规范及运行手册的撰写原则与结构,强调清晰表达、主动语态和具体示例,旨在提升面向工程师的技术沟通质量。
触发场景
编写技术文档或README
撰写系统说明或运行手册
安装
npx skills add aiming-lab/MetaClaw --skill technical-writing-clarity -g -y
SKILL.md
Frontmatter
{
"name": "technical-writing-clarity",
"category": "communication",
"description": "Use this skill when writing documentation, READMEs, technical specs, runbooks, or any text that explains a system or process to other engineers. Apply before writing any developer-facing document."
}
Technical Writing for Clarity
Principles:
- Lead with the purpose: What is this document for and who is it for?
- One idea per paragraph. Long paragraphs hide key information.
- Use active voice:
Run the scriptnotThe script should be run. - Concrete over abstract: Show an example rather than describing it abstractly.
- Avoid jargon you have not defined unless the audience definitely knows it.
Structure for runbooks/how-tos:
- Overview (1–2 sentences)
- Prerequisites
- Steps (numbered, imperative)
- Verification / expected output
- Troubleshooting
Anti-patterns: Documenting what without why, outdated examples, walls of text without headers.
版本历史
- 922caf3 当前 2026-07-25 11:08


