CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ci-fix

Investigate and fix failing CI. Takes a PR reference, one or more CI run/job URLs, or freeform text describing where the failures are, then enumerates failing workflows/jobs/steps, determines the root cause (often one shared cause behind several red checks), proposes a fix plan, applies code changes, commits, pushes, watches the new runs, and repeats until checks pass. Use when the user says "fix CI", "CI is red", "checks are failing", "the build is broken on my PR", "fix the failing jobs", or pastes a failing CI run URL. Do NOT use for authoring new workflows, or for read-only diagnosis with no fix intent — use gha-log-reader for that.

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

68%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a minimal generated shim: perfectly lean and unambiguous as a pointer, but it carries none of the skill's actual operational content — everything depends on the external shared file resolving. The description frontmatter does the heavy lifting for triggering; the body's sole job is delegation, which it does cleanly but with an environment-dependent absolute reference. Suggestions focus on making the delegation robust and self-sufficient.

Suggestions

Make the delegation robust: state what to do if `~/.agents/skills/ci-fix/SKILL.md` is missing (e.g., fall back to bundled instructions or surface an explicit error), since the body is otherwise empty and the skill fails silently without that file.

Add one line of orientation (e.g., "Full workflow: enumerate failures → diagnose root cause → fix → commit/push → watch runs → repeat") so the body is not entirely dependent on the external file for the skill's core loop and validation checkpoints.

If the bundle is meant to be portable, ship the shared SKILL.md (or a copy) in a references/ directory and reference it bundle-relative instead of via an absolute home-directory path.

DimensionReasoningScore

Conciseness

The body is two lines — an HTML generation comment and "Load and follow the shared skill at `~/.agents/skills/ci-fix/SKILL.md`" — with zero padding and no explanation of things Claude already knows. Not 4: there is literally nothing that could be trimmed; every token earns its place.

5 / 5

Actionability

The single directive is concrete (a specific path and a specific action), but all task-executable guidance — how to enumerate failures, apply fixes, commit, push, watch runs — is delegated to the referenced file, so the body itself is incomplete guidance for the task. Not 4: an executable pointer is not executable task guidance; the body contains no steps, commands, or examples of its own.

3 / 5

Workflow Clarity

The delegation action itself is unambiguous, but the body exposes no sequence and no validation checkpoints for the multi-step fix→commit→push→watch→repeat loop it fronts; the simple-skill exception doesn't apply because the underlying task is a complex, risky (push-triggering) workflow whose checkpoints are invisible here. Not 1: the one step written is coherent and unambiguous rather than missing.

3 / 5

Progressive Disclosure

One clearly-signaled, one-level-deep reference — exactly the right shape for a wrapper — and no inlined content that belongs elsewhere. Not 5: the pointer targets an absolute machine-local path (`~/.agents/skills/ci-fix/SKILL.md`) outside this bundle (no references/ directory exists, and the path does not resolve in this environment), so navigation depends on environment setup rather than bundled files.

4 / 5

Total

15

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

Excellent description: specific, third-person, comprehensive trigger coverage, and explicit both-ways scoping (when to use and when not to use, naming the alternative skill). It models exactly what a strong trigger description should look like. No changes needed.

DimensionReasoningScore

Specificity

Enumerates many concrete actions — "enumerates failing workflows/jobs/steps", "determines the root cause", "proposes a fix plan, applies code changes, commits, pushes, watches the new runs, and repeats until checks pass" — giving comprehensive, concrete coverage of the workflow. Not 4: there are no gaps in coverage; the full pipeline from diagnosis to green checks is explicitly listed.

5 / 5

Completeness

Explicitly answers both what (the full investigate→fix→push→re-run loop) and when ("Use when the user says 'fix CI'..."), with concrete trigger phrases. Not 4: the 'when' is fully explicit with quoted user utterances and input forms, plus negative scoping ("Do NOT use for authoring new workflows, or for read-only diagnosis with no fix intent — use gha-log-reader for that").

5 / 5

Trigger Term Quality

Covers natural user phrasings comprehensively: "fix CI", "CI is red", "checks are failing", "the build is broken on my PR", "fix the failing jobs", plus the input pattern "pastes a failing CI run URL". Not 4: it includes multiple synonym phrasings and an input-format trigger, not just a few good keywords.

5 / 5

Distinctiveness Conflict Risk

Clear niche (fixing failing CI) with explicit disambiguation against adjacent skills — read-only diagnosis is routed to "gha-log-reader" and workflow authoring is excluded — minimizing wrong-skill triggering. Not 4: the negative triggers don't just reduce overlap risk, they name the competing skill.

5 / 5

Total

20

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

phatblat/dotfiles

Path

.claude/skills/ci-fix/SKILL.md

Reviewed

Table of Contents

Is this your skill?

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.