CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ci-check-name-parity

Validate and align required-check names across GitHub workflows, .harness/ci-required-checks.json, harness.contract.json, and repo docs. Use this skill when CI check names or required-check policy changes.

Quality

85%

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

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

A well-structured, actionable skill body with strong progressive disclosure (all referenced bundle files exist and are clearly signaled) and a validation-backed workflow. The main weakness is token efficiency: a redundant Table of Contents and four sections restating the same no-drift rule could be consolidated.

Suggestions

Remove the Table of Contents and merge the overlapping Constraints, Philosophy, Anti-patterns, and Failure mode sections into one or two sections, keeping the no-silent-drift rule stated once.

Replace the hardcoded check-name list in the rg validation command with a pattern derived from the policy files, or move it to a reference, so the command does not go stale on renames.

Add one short example of a documented intentional mapping (e.g., a docs line mapping dependency-review to dependency-scan) so the mapping workflow step is copy-paste ready.

DimensionReasoningScore

Conciseness

The body includes a 12-line Table of Contents for a ~90-line document and restates the no-silent-drift rule across four sections ("Do not silently preserve mismatched names", "Treat check-name drift as a contract bug", "Accepting mismatches with no documented mapping rationale", "treat that as unresolved policy debt"). This is more than the minor trimmable instances of anchor 4 but stops short of anchor 2 because there is no over-explanation of concepts Claude already knows and every section is short.

3 / 5

Actionability

Concrete, executable commands are provided ("bash .codex/skills/ci-check-name-parity/scripts/report_check_name_drift.sh", "npm test", a full rg invocation) plus concrete workflow steps. It misses anchor 5 because the rg validation hardcodes a brittle, time-sensitive list of check names and no example shows what a documented intentional mapping should look like.

4 / 5

Workflow Clarity

The 5-step workflow has an explicit validation step ("Re-run repo validation after the rename or mapping change lands"), a fail-fast feedback loop ("stop at the first failed gate and fix it before continuing"), and error-recovery guidance in Failure mode ("If repo tests fail after a rename, do not claim the policy update is complete"), matching the anchor-5 pattern of validate -> fix -> re-validate rather than the minor-gaps profile of anchor 4.

5 / 5

Progressive Disclosure

The References section signals each bundle file with a purpose ("Read when: you need the source map and naming rule") and every referenced file exists one level deep (references/comparison-matrix.md, references/contract.yaml, references/evals.yaml, scripts/report_check_name_drift.sh), with the body staying a genuine overview. This matches anchor 5's clear overview with well-signaled one-level-deep references and exceeds anchor 4, which allows minor organization gaps.

5 / 5

Total

17

/

20

Passed

Description

87%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: concrete, third-person, with an explicit 'Use this skill when...' trigger clause and a well-scoped, distinctive niche. Main improvement room is broader trigger synonyms (GitHub Actions, branch protection, status checks) and mentioning the documented-mapping capability.

Suggestions

Add common trigger synonyms such as 'GitHub Actions', 'branch protection', or 'required status checks' to widen natural-term coverage.

Mention the documented-mapping output (writing intentional name mappings into docs) so the 'what' covers the skill's second concrete action, not just validation/alignment.

DimensionReasoningScore

Specificity

"Validate and align required-check names across GitHub workflows, .harness/ci-required-checks.json, harness.contract.json, and repo docs" names two concrete actions applied to a fully enumerated set of surfaces, matching the several-specific-actions-with-minor-gaps anchor (e.g., documenting intentional mappings is only covered in the body). It falls short of anchor 5, which expects multiple distinct concrete actions, but exceeds anchor 3 because coverage of the target surfaces is comprehensive rather than partial.

4 / 5

Completeness

The description explicitly answers both: what ("Validate and align required-check names across GitHub workflows, .harness/ci-required-checks.json, harness.contract.json, and repo docs") and when ("Use this skill when CI check names or required-check policy changes") with a concrete trigger clause. This matches the anchor-5 example pattern of explicit what plus explicit when with concrete triggers, exceeding anchor 4 whose 'when' is generic.

5 / 5

Trigger Term Quality

Natural phrases like "CI check names", "required-check policy", and "GitHub workflows" are present, giving good keyword coverage. It is not anchor 5 because common variations users would say — "GitHub Actions", "branch protection", "status checks" — are missing, but it clearly exceeds anchor 3, which requires missing common variations or synonyms.

4 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche — required-check name parity across specific named policy files — with triggers ("CI check names or required-check policy changes") that would not fire for unrelated skills. Conflict risk is minimal, matching anchor 5; anchor 4 would require some overlap with closely related skills, which is not the case here.

5 / 5

Total

18

/

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

jscraik/diagram-cli

Path

.codex/skills/ci-check-name-parity/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.