Content
75%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A disciplined, rule-dense instruction skill: concrete tool usage, exact key/link schemas, a forced write-as-you-go cadence with per-step checklists and error-recovery paths, and well-organized sections. The gaps are modest — some repetition across sections and no worked example of a complete fact payload.
Suggestions
Add one worked example of a full upsert_project_fact call (fact_key, summary, body, links JSON) to make the write spec copy-paste concrete.
Deduplicate the links rules — state them once in 写入规范 and reference that section from the 原语 table and 节奏 rules to trim repeated tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is rule-dense with zero concept-explanation padding ('同 fact_key 覆盖更新', the tool quick-reference table) and assumes competence, but has minor repetition — the links requirement appears in the 原语 table, the dedicated links section, and the 节奏 rules, and '摘要不足必须 get_project_fact' is stated twice — placing it at the 'efficient with minor trims' anchor rather than 5. | 4 / 5 |
Actionability | Concrete guidance throughout: exact key formats ('target/primary_domain', 'finding/sqli-login'), enumerated edge types with minimums ('finding 至少 1 条 {from: target/*, type: discovered_on}'), and a forbidden-summary example ('禁止只写「存在 SQLi」'). It stops short of 5 because there is no worked example of a complete upsert payload or links JSON. | 4 / 5 |
Workflow Clarity | The 强制节奏 is a clear numbered sequence with immediate-write checkpoints, per-mode guidance, and 每步必检 checklists with explicit error-recovery paths (拒绝→换路 fallback order, 卡住时 recovery, 违反判定 criteria). The 3-cap for destructive/batch operations without validation does not apply (writes are idempotent upserts with a pre-write dedup check), but a post-write verification loop is absent, so it sits at 4 rather than 5. | 4 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent), and the ~100-line body is well-sectioned with clear headers and one-level, clearly signaled cross-skill references ('详见 pentest-verification'). It is not 5 because the detailed 写入规范/links schema is fully inline where a separate reference file would keep SKILL.md a leaner overview. | 4 / 5 |
Total | 16 / 20 Passed |