Find failing PR checks, inspect logs or external check links, and apply focused fixes
66
57%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./cursor-team-kit/skills/fix-ci/SKILL.mdQuality
Discovery
42%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description does a good job listing specific actions related to PR check failures, but it lacks a 'Use when...' clause which is critical for Claude to know when to select this skill. It also misses common trigger terms users would naturally use like 'CI', 'pipeline', 'build failure', or 'GitHub Actions'.
Suggestions
Add an explicit 'Use when...' clause, e.g., 'Use when the user mentions failing CI checks, broken builds, PR pipeline errors, or needs help debugging pull request failures.'
Include common trigger term variations such as 'CI', 'CI/CD', 'pipeline', 'build failure', 'GitHub Actions', 'test failures', 'pull request checks', and 'status checks'.
Clarify the scope of 'apply focused fixes' to distinguish this skill from general debugging or code-fixing skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Find failing PR checks', 'inspect logs or external check links', and 'apply focused fixes'. These are distinct, actionable capabilities. | 3 / 3 |
Completeness | Describes what the skill does but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per rubric guidelines, a missing 'Use when...' clause caps completeness at 2, and since the 'when' is entirely absent, this scores 1. | 1 / 3 |
Trigger Term Quality | Includes relevant terms like 'PR checks', 'logs', 'failing', and 'fixes', but misses common user variations such as 'CI', 'pipeline', 'build failure', 'GitHub Actions', 'CI/CD', 'test failures', or 'pull request'. | 2 / 3 |
Distinctiveness Conflict Risk | The focus on PR checks and logs is somewhat specific, but 'apply focused fixes' is broad enough to overlap with general debugging or code-fixing skills. The PR check context helps but isn't fully distinctive without explicit trigger terms. | 2 / 3 |
Total | 8 / 12 Passed |
Implementation
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A concise, well-structured skill that clearly defines the CI-fixing workflow at a high level. Its main weakness is limited actionability—it tells Claude what to do conceptually but provides few concrete commands or examples beyond the initial `gh pr checks` invocation. Adding specific examples of log inspection commands and common fix patterns would significantly improve it.
Suggestions
Add concrete commands for inspecting failed job logs, e.g., `gh run view <run-id> --log-failed` or how to parse the check link output.
Include a brief example showing a common failure scenario (e.g., a lint error) with the specific fix applied, to make 'apply the smallest safe fix' more actionable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line serves a purpose. No unnecessary explanations of what CI is, how GitHub works, or what PR checks are. Assumes Claude's competence throughout. | 3 / 3 |
Actionability | Provides one concrete command (`gh pr checks --json name,bucket,state,workflow,link`) but the rest is directional rather than executable. Steps like 'extract the first actionable error' and 'apply the smallest safe fix' lack specific commands or examples (e.g., how to fetch and parse logs, common fix patterns). | 2 / 3 |
Workflow Clarity | The workflow has a clear sequence and an implicit feedback loop (push, re-check, repeat until green), but lacks explicit validation checkpoints or error recovery guidance. For an iterative process involving pushes to a remote branch, more explicit verification steps (e.g., confirming the push succeeded, waiting for checks to start) would strengthen it. | 2 / 3 |
Progressive Disclosure | This is a simple, single-purpose skill under 50 lines with well-organized sections (Trigger, Workflow, Guardrails, Output). No external references are needed, and the structure is clean and navigable. | 3 / 3 |
Total | 10 / 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.
7dd9fea
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.