CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ci-auto-fix

Diagnoses and fixes failing GitHub Actions CI, verifies locally, pushes, and confirms the checks pass on the new revision — never weakens checks. Triggers on "CI is failing", "fix the CI", "the build is red", "/ci-auto-fix".

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

85%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.

An exceptionally tight, well-sequenced workflow skill: lean prose, explicit validation gates, feedback loops, and hard stop conditions. Its one material defect is bundle integrity — every referenced rules/templates file is missing from the bundle (and the shared github-access rule lives outside it), so the otherwise excellent progressive-disclosure design fails at navigation time.

Suggestions

Ship the referenced bundle files alongside SKILL.md — rules/anti-patterns.md, rules/verdicts.md, rules/confidence-gate.md, rules/ci-verification.md, rules/regression-detection.md, rules/self-improvement-loop.md, and templates/plan-artifact.md are all cited but absent from the bundle, so every progressive-disclosure link dangles.

Remove or vendor the cross-bundle reference ../../../agents/shared/rules/github-access.md; a path escaping the skill directory breaks when the skill is installed standalone, and Phase 0 depends on it.

Inline one or two representative gh commands (e.g. fetching failed logs and watching PR checks) so the core diagnose-verify loop stays executable even when reference files are not loaded.

DimensionReasoningScore

Conciseness

Dense directive prose with no padding and no explanations of concepts Claude already knows — e.g. "Investigation scales with uncertainty and blast radius; completion checks apply to every path. Maximum four fix-push cycles per invocation." Every sentence carries instruction; there is nothing to trim, matching the 'every token earns its place' anchor.

5 / 5

Actionability

Guidance is concrete and decision-ready for an instruction-only skill — the mechanical-path checklist ("Logs identify the exact command... No assertion, public API, runtime behavior... needs a judgment call"), hard budgets ("resync and retry once; never force-push", "Maximum four fix-push cycles"), and enumerated report fields. It falls short of the 5 anchor because not a single executable command is shown ("Commands below show the `gh` path" yet no `gh` example appears), leaving the concrete command detail to reference files that are not present.

4 / 5

Workflow Clarity

Phases 0-9 are clearly sequenced with explicit validation checkpoints (Phase 5 local verification, Phase 7 CI verification on the pushed revision, "Missing, pending, or inaccessible checks are not green"), feedback loops for error recovery ("A local failure returns to diagnosis", rebase-conflict abort, non-fast-forward retry-once), and explicit stop conditions (four cycles, two regressions, no useful next check). This matches the top anchor including its checklist-and-recovery-loop criteria.

5 / 5

Progressive Disclosure

The on-page structure is well-designed — references are clearly signaled, one level deep, and load-pointed ("Read [anti-patterns](./rules/anti-patterns.md) first. Load other references only at the decision they support.") — but scoring against the actual bundle, none of the eight referenced files exist (rules/anti-patterns.md, rules/verdicts.md, rules/confidence-gate.md, rules/ci-verification.md, rules/regression-detection.md, rules/self-improvement-loop.md, templates/plan-artifact.md are all absent, and github-access.md resolves outside the bundle at ../../../agents/shared/rules/). Every navigation link dangles, so the structure cannot deliver easy navigation; this sits below the 4 anchor's 'minor organization gaps' and above the 2 anchor since the SKILL.md itself is well organized with nothing inlined that belongs elsewhere.

3 / 5

Total

17

/

20

Passed

Description

92%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.

A strong description: third-person voice, a complete what/when pairing, concrete triggers, and a niche clearly separated from adjacent skills. The only gap is a handful of missing natural trigger variants.

DimensionReasoningScore

Specificity

"Diagnoses and fixes failing GitHub Actions CI, verifies locally, pushes, and confirms the checks pass on the new revision" lists five concrete, distinct actions covering the complete fix loop; coverage is comprehensive rather than having the minor gaps of the 4 anchor, and it is far above the 1-2-action level of the 3 anchor.

5 / 5

Completeness

It explicitly answers both parts: the what is "Diagnoses and fixes failing GitHub Actions CI, verifies locally, pushes, and confirms the checks pass on the new revision — never weakens checks", and the when is the concrete trigger clause "Triggers on 'CI is failing', 'fix the CI', 'the build is red', '/ci-auto-fix'". Not the 4 anchor because the when-clause is explicit with concrete phrases, not merely implied or generic.

5 / 5

Trigger Term Quality

"CI is failing", "fix the CI", "the build is red", "/ci-auto-fix" are phrases a user would naturally say, giving good coverage; it stops short of the 5 anchor because common variants like "broken build", "build failing", or naming "GitHub Actions" as a trigger are absent.

4 / 5

Distinctiveness Conflict Risk

A clear niche — repairing failing GitHub Actions CI on a pushed revision — with distinct trigger vocabulary and a bounding guarantee ("never weakens checks") that separates it from generic debugging or build skills; minimal conflict risk, matching the 5 anchor rather than the 4 anchor's 'minor overlap with closely related skills'.

5 / 5

Total

19

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 7 missing, 1 suspicious

Warning

Total

13

/

16

Passed

Repository

mthines/agent-skills

Path

skills/delivery/ci-auto-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.