pantheon-ai/github-actions-validator
Comprehensive toolkit for validating, linting, and testing GitHub Actions workflow files, custom local actions, and public actions. Use this skill when working with GitHub Actions YAML files (.github/workflows/*.yml), validating workflow syntax, testing workflow execution with act, or debugging workflow issues.
Overall
score
93%
Does it follow best practices?
Validation for skill structure
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 key criteria. It provides specific capabilities (validating, linting, testing), includes natural trigger terms users would actually say (GitHub Actions, workflow files, .yml), and explicitly states when to use it. The description is distinctive enough to avoid conflicts with other skills while being comprehensive.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'validating, linting, and testing GitHub Actions workflow files, custom local actions, and public actions' - covers distinct capabilities clearly. | 3 / 3 |
Completeness | Clearly answers both what ('validating, linting, and testing GitHub Actions workflow files') AND when ('Use this skill when working with GitHub Actions YAML files...') with explicit trigger guidance. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'GitHub Actions', 'workflow files', 'YAML files', '.github/workflows/*.yml', 'workflow syntax', 'act', 'debugging workflow issues' - includes file paths, tool names, and common user language. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with specific niche: GitHub Actions workflows, specific file paths (.github/workflows/*.yml), and unique tool reference (act). Unlikely to conflict with general YAML or CI/CD skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a high-quality skill with excellent actionability and workflow clarity. The 5-step mandatory workflow with error-to-reference mapping is particularly well-designed for guiding Claude through validation tasks. The main weakness is some verbosity and redundancy that could be trimmed without losing clarity.
Suggestions
Consolidate the 'Core Validation Workflow' and 'Quick Start' sections to reduce redundancy - the same commands appear in multiple places
Remove generic best practices that Claude already knows (e.g., 'Always validate locally first', 'Keep tools updated') to improve token efficiency
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is comprehensive but includes some redundancy (e.g., the validation workflow is explained multiple times in different sections). The worked example is valuable but adds significant length. Some sections like 'Best Practices' contain generic advice Claude already knows. | 2 / 3 |
Actionability | Excellent actionability with fully executable bash commands, complete YAML examples, and a detailed worked example showing the entire error-to-fix workflow. Commands are copy-paste ready with clear file paths. | 3 / 3 |
Workflow Clarity | Outstanding workflow clarity with explicit 5-step process, clear error-to-reference mapping table, validation checkpoints, and a complete worked example demonstrating the entire flow. The 'CRITICAL: Assistant Workflow (MUST FOLLOW)' section provides unambiguous sequencing. | 3 / 3 |
Progressive Disclosure | Well-structured with clear overview, quick start, and detailed sections. Reference files are clearly signaled in a summary table with one-level-deep navigation. The error-to-reference mapping provides excellent discoverability. | 3 / 3 |
Total | 11 / 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.
Install with Tessl CLI
npx tessl i pantheon-ai/github-actions-validator@0.1.0Reviewed
Table of Contents