CtrlK
BlogDocsLog inGet started
Tessl Logo

adr-check

Run ADR conformance checks, explain failures, and identify required ADR/doc updates for the current change.

68

Quality

83%

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

100%

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

The content is exemplary: concise, fully actionable, and clearly sequenced with validation feedback loops. It needs no improvement within its current scope.

DimensionReasoningScore

Conciseness

The body is lean — a trigger line, numbered steps with concrete commands, and a compact output list — with no padding or explanation of concepts Claude already knows, matching the lean-and-efficient anchor.

3 / 3

Actionability

It provides fully executable commands (git diff, the adr_guard.py invocations), explicit file paths, and concrete waiver fields, giving copy-paste-ready guidance rather than vague direction.

3 / 3

Workflow Clarity

The six-step sequence is clearly ordered with a validate→fix→re-run feedback loop in step 3 and a final CI validation pass in step 6, satisfying the explicit-validation-and-feedback-loops anchor.

3 / 3

Progressive Disclosure

No bundle files exist, and the skill is a concise single file under 50 lines with well-organized sections, so it qualifies for the top score under the rubric's simple-skill guidance.

3 / 3

Total

12

/

12

Passed

Description

67%

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 is specific and occupies a distinct niche, but it omits explicit trigger guidance and natural keyword variations. Adding a "Use when..." clause would raise both completeness and trigger-term quality.

Suggestions

Add a 'Use when...' clause naming the change types that should invoke the skill (e.g., changes to architecture, workflows, hooks, or guardrail files).

Broaden trigger terms with natural phrasings a user would say, such as 'architecture decision records', 'ADR violations', or 'ADR exceptions'.

Keep the existing concrete action list intact while appending the trigger clause so completeness moves from 2 to 3.

DimensionReasoningScore

Specificity

The description lists three concrete actions — "Run ADR conformance checks", "explain failures", and "identify required ADR/doc updates" — matching the anchor for multiple specific concrete actions rather than the partial coverage at level 2.

3 / 3

Completeness

It clearly states what the skill does but provides no "Use when..." clause or equivalent trigger guidance, so the "when" is missing and completeness is capped at 2 per the rubric guidelines.

2 / 3

Trigger Term Quality

It includes relevant domain terms ("ADR conformance checks", "failures", "ADR/doc updates") but lacks the common natural variations a user would actually say (e.g., "architecture decision records", "ADR violations"), so it falls short of broad keyword coverage at level 3.

2 / 3

Distinctiveness Conflict Risk

The ADR-governance niche ("ADR conformance checks", "ADR/doc updates") is specific and distinct, making it unlikely to trigger for unrelated skills, matching the clear-niche anchor at level 3.

3 / 3

Total

10

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 2 missing, 2 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository
PaloAltoNetworks/shifter
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.