Content
77%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 strong orchestration skill: the workflow is unambiguous, validation and retry loops are explicit, and guidance is concrete enough to execute directly. The main weaknesses are moderate redundancy (Critical Rules, Example Execution) and a monolithic single-file layout with external script references that are not shipped in the bundle.
Suggestions
Move the per-agent Task prompt templates and evidence-request dispatch rules into a references/ file (e.g., references/agent-prompts.md) so SKILL.md stays a lean overview.
Trim the 'Critical Rules' section, which restates constraints already embedded in the phase specifications, and shorten the Example Execution recap.
Either ship the referenced scripts (init_investigation.py, raptor-may-ask) in the bundle's scripts/ directory or document where they come from, so the skill is self-contained and verifiable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The phases are lean, assume Claude's competence, and explain no background concepts — no padding about what GitHub or forensics is. Not a 5 because the 'Critical Rules' section restates constraints already enforced by the phase specs, and the 'Example Execution' recap plus Python-flavored loop pseudocode add redundant tokens that could be trimmed. | 4 / 5 |
Actionability | Mostly executable: an exact init-script command, concrete per-agent Task prompt templates with workdir/targets placeholders, flags with defaults ('--max-followups 3 --max-retries 3'), and a per-case error-handling table. Minor gaps: the loop logic is pseudocode ('find_latest_file', 'evidence_request_file_exists') rather than executable code, and paths like '.claude/skills/oss-forensics/github-evidence-kit/scripts/init_investigation.py' and 'libexec/raptor-may-ask' reference components outside this bundle that cannot be verified here. | 4 / 5 |
Workflow Clarity | A clearly sequenced 8-phase pipeline with explicit validation checkpoints and feedback loops: Phase 0 stops if prerequisites fail, Phase 4 runs a dedicated evidence verifier, Phase 5 is a confirm/rebuttal retry loop with limits, and there is a concrete Error Handling section. This matches the top anchor — clear sequence, explicit validation, error-recovery loops, and a Critical Rules checklist. | 5 / 5 |
Progressive Disclosure | No bundle files exist (no references/, scripts/, or assets/), so this 288-line skill is fully inline with well-organized phase sections — but content that would naturally live in separate files (agent prompt templates, evidence-request dispatch rules, error-handling matrix) is inlined in the overview, and the scripts it does reference (init_investigation.py, raptor-may-ask) are not part of this bundle. Structure is present but organization into one level-deep references is not. | 3 / 5 |
Total | 16 / 20 Passed |