Skip to content

Commit f78d0af

Browse files
committed
skills(security-scan): add reference.md
Progressive-disclosure reference per Anthropic's skill authoring best practices — loaded when triaging security-scan findings. Covers the AgentShield and zizmor rule catalogs (grouped by what each rule protects against, with default severity), common false positives (doc-listed token prefixes, excessive-permissions on workflow-level blocks, trusted-context template injection), a severity decision tree, four worked fix recipes (unpinned action, template injection, overly broad permissions, hardcoded token), and how to suppress rules correctly (with a *reason*, not just *that*). SKILL.md now links reference.md in its Reference section.
1 parent 2eb3c5c commit f78d0af

2 files changed

Lines changed: 415 additions & 0 deletions

File tree

.claude/skills/security-scan/SKILL.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -81,3 +81,9 @@ The agent:
8181
Output a HANDOFF block per `_shared/report-format.md` for pipeline chaining.
8282

8383
Update queue: `status: done`, write `findings_count` and final grade.
84+
85+
---
86+
87+
## Reference
88+
89+
For rule catalogs (AgentShield + zizmor), common false positives, severity decision tree, and fix recipes — load [reference.md](./reference.md) when triaging findings.

0 commit comments

Comments
 (0)