Content
79%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted skill with excellent actionability — the executable commands with complete JSON payloads are immediately usable. The confirmation gate before policy changes is a good safety measure. The main weaknesses are the lack of a post-creation validation step (important given the high-impact nature of policies that can block all PRs) and a reference to a bundle file that doesn't exist.
Suggestions
Add an explicit validation step after policy creation, e.g., list policies to confirm creation, then suggest testing against a specific project with /endor-validate-policy before relying on enforcement.
Either include the referenced 'references/data-sources.md' file in the bundle or remove the reference to avoid a dead link.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and well-structured. It uses tables for quick reference, provides only the necessary commands and JSON payloads, and doesn't explain concepts Claude already knows. Every section earns its place. | 3 / 3 |
Actionability | Provides fully executable, copy-paste ready bash commands with complete JSON payloads for each policy template. The list, create, and exception workflows all have concrete commands with real filter syntax. | 3 / 3 |
Workflow Clarity | The workflow covers list, create, and exception steps clearly, and includes a confirmation gate before creating policies. However, there's no explicit validation/verification step after policy creation (e.g., verify the policy was created correctly, test it against existing findings before it blocks real PRs). For a destructive/high-impact operation like blocking all PRs org-wide, a feedback loop is missing. | 2 / 3 |
Progressive Disclosure | References 'references/data-sources.md' and '/endor-findings' filter reference, but the bundle has no files. The content is reasonably organized with tables and sections, but the inline policy templates could potentially be split into a reference file, and the data-sources reference points to a non-existent file. | 2 / 3 |
Total | 10 / 12 Passed |