writing-offensive-skills

提供本仓库中编写/编辑 offensive-skills 的规范、模板与要求

给在仓库里编写或修改 offensive-skills 的人一套规范和模板，包括 SKILL.md 字段、触发说明、技术地图、可运行脚本、OPSEC/检测注意事项和红旗表格等。新增技能、更新说明或准备可执行示例时会用到。特点是沿用 superpowers 的约定并强调测试驱动，使技能易被发现、验证并规范记录，方便团队协作与审计。

# Writing Offensive Skills

## Overview

Conventions for authoring skills in this repo so the dispatcher can find them and operators can
trust them. This adapts superpowers' skill conventions to offensive security.

**REQUIRED BACKGROUND:** superpowers:writing-skills (the general conventions) and
superpowers:test-driven-development (skills are tested like code — baseline failure first).

## Description = triggers only

The `description:` field decides whether the dispatcher loads the skill. Write **`Use when…`**
triggering conditions and symptoms ONLY — never summarize the skill's workflow (a workflow summary
makes Claude follow the description instead of reading the skill).

```yaml
# BAD