GitHub Actions agent skill - helps create, review, and optimize workflows with up-to-date action versions and best practices
100
100%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that hits all the marks. It provides rich, specific capabilities, includes a comprehensive set of natural trigger terms users would actually say, explicitly states when to use it, and carves out a distinct niche around GitHub Actions workflows. The description is information-dense without being padded, and correctly uses third-person voice throughout.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: creates/debugs/optimizes workflow YAML files, recommends action versions with SHA pinning, configures matrix builds, dependency caching, reusable workflows, OIDC authentication, secrets management, runner selection, and includes a workflow-analyzer agent. | 3 / 3 |
Completeness | Clearly answers both 'what' (creates/debugs/optimizes workflows, recommends versions, configures various features, analyzes workflows) and 'when' with an explicit 'Use when...' clause listing specific trigger scenarios. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'GitHub Actions', 'workflows', 'CI/CD', '.github/workflows', specific action names like 'actions/checkout', 'setup-node', 'setup-python', and 'workflow analysis'. These are all terms users would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a clear niche around GitHub Actions specifically. The mention of SHA pinning, specific action names, .github/workflows directory, and the workflow-analyzer agent make it very unlikely to conflict with generic CI/CD or YAML editing skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an exceptionally well-crafted skill that maximizes token efficiency while providing comprehensive, actionable guidance. The structure elegantly separates quick-reference patterns from detailed references, the jq query examples are immediately executable, and the security guidance (especially the SHA pinning warning) is appropriately emphatic. The agent routing for analysis vs. creation is cleanly delineated.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient. It avoids explaining what GitHub Actions is or how YAML works. The SHA pinning warning is emphatic but justified given the security-critical nature. Every section earns its place with actionable content rather than background explanation. | 3 / 3 |
Actionability | Provides fully executable jq commands, copy-paste ready YAML snippets, concrete CLI commands for actionlint and act, and specific examples for matrix builds, caching, permissions, and job dependencies. The guidance on querying actions-index.json is immediately usable. | 3 / 3 |
Workflow Clarity | The validation section provides a clear 4-step sequence (lint → test locally → check logs → validate secrets) with specific commands at each step. The creation vs. review routing is explicit (SKILL.md for creation, agent for review). The agent dispatch instruction is unambiguous. | 3 / 3 |
Progressive Disclosure | Excellent progressive disclosure with a concise overview in SKILL.md and well-organized one-level-deep references to 16+ reference files, examples directory, and the actions-index.json. Tables clearly signal what each reference covers and when to use it. No nested reference chains. | 3 / 3 |
Total | 12 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
Reviewed
Table of Contents