Content
88%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, disciplined workflow document: executable commands with placeholders, a five-phase process with explicit validation and stop conditions, and thorough cleanup/reporting guidance. The only weaknesses are mild — a few sentences could be trimmed and some detail could move to reference files for a leaner overview.
Suggestions
Move the GitHub Actions discovery/download command blocks (sections 1–2) into a references file (e.g., references/github-actions.md), keeping one short example inline in SKILL.md, so the overview stays lean.
Tighten the stacked prohibitions in sections 1 and 3 by merging related 'Do not...' clauses (e.g., combine the substitution/bypass and retry/assertion-weakening rules into single compact lines).
Trim explanatory rationale sentences like 'Busy Repositories can push the desired artifact off that page' to their operative instruction ('List artifacts for the selected run, not the repository-wide latest-artifacts page').
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and assumes Claude's competence (no explanation of what GitHub Actions or CI is; every section carries non-obvious operational knowledge such as merge-commit provenance and artifact layout). Not a 5 because a few rationale-heavy sentences ('Busy Repositories can push the desired artifact off that page', several stacked 'Do not...' clauses) could be tightened; not a 3 because there is no over-explanation of known concepts. | 4 / 5 |
Actionability | The gh CLI examples are copy-paste ready with variables defined and placeholders explicitly flagged ('replace the illustrative values'): 'gh pr view "$pr" --repo "$repo" --json url,state,headRefOid,baseRefOid', 'gh run download "$run_id" --repo "$repo" --name "$artifact_name" --dir "$artifact_dir"', plus the commit-parents provenance check. Non-code guidance is equally concrete (e.g., 'Restore permissions only on identified executables'). Not a 4 because the command path covers the common GitHub Actions case completely end to end. | 5 / 5 |
Workflow Clarity | A clear five-step sequence (identify, verify provenance/download, select, compare, restore/report) with explicit validation checkpoints and error-recovery guidance: 'Stop or qualify the result when source provenance cannot be established', 'Record its actual failure; a startup error or fixture mismatch is not the original regression', 'Repeat lifecycle- or timing-sensitive scenarios at least twice', 'Check the final diff/status against the starting state'. Not a 4 because checkpoints are explicit at every phase, including the restore phase. | 5 / 5 |
Progressive Disclosure | No bundle files exist, so everything is inline; sections are well organized and sibling-skill links ('[integration-test](../integration-tests/SKILL.md)', '[azure-pipelines](../azure-pipelines/SKILL.md)') are clearly signaled and one level deep. Not a 5 because at ~95 lines the body exceeds a single-screen overview — the GitHub Actions discovery command blocks and the artifact-layout/permissions detail would fit naturally in a references file; not a 3 because navigation is easy and nothing is buried or nested. | 4 / 5 |
Total | 18 / 20 Passed |