Content
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, concise skill that clearly communicates the intent and decision criteria for upgrading GitHub Actions off deprecated Node 20 runtimes. Its main weakness is the lack of executable commands or scripts for inspecting action.yml metadata and validating changes, and the absence of an explicit step-by-step workflow with verification checkpoints after applying updates.
Suggestions
Add a concrete command or code snippet for inspecting an action's `action.yml` to confirm `runs.using: node24` (e.g., fetching the raw file from GitHub or using `gh api`).
Restructure the Patterns section into an explicit numbered workflow with a validation step at the end (e.g., 'Run the workflow and confirm no deprecation warnings remain').
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section is lean and purposeful. No unnecessary explanations of what GitHub Actions are or how Node.js runtimes work. The example mapping is a compact lookup table, and anti-patterns are terse but informative. | 3 / 3 |
Actionability | The example mapping provides concrete before/after references, and the patterns give clear decision criteria. However, there are no executable commands (e.g., grep/sed commands, or a script to inspect action.yml for `runs.using: node24`), and the workflow relies on Claude inferring the exact steps to check upstream tags and composite action internals. | 2 / 3 |
Workflow Clarity | The patterns imply a sequence (start from warnings → inspect candidate → confirm node24 → change workflow → check composites → report unresolved), but it's not presented as an explicit ordered workflow with validation checkpoints. There's no feedback loop for verifying the updated workflows actually pass after changes. | 2 / 3 |
Progressive Disclosure | The skill is under 50 lines, single-purpose, and well-organized into four clearly labeled sections (Context, Patterns, Example mapping, Anti-Patterns). No bundle files are needed, and the structure is easy to scan. | 3 / 3 |
Total | 10 / 12 Passed |