CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

codebase-alignment

Given a user-provided set of coding standards (either as direct text input or as a link to a file/URL), systematically review the codebase to identify violations, report findings, and optionally remediate them. The model MUST ask the user for the standards — never guess or assume them.

Quality

75%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/software-engineering/codebase-alignment/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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-engineered body: the workflow is explicitly sequenced with validation gates, feedback loops, and a verification checklist, and nearly all guidance is concrete and executable. The only real defects are mild redundancy in the core-constraint messaging and ripgrep commands written with grep-style flags.

Suggestions

Fix the Phase 3 scan commands: ripgrep uses '-g'/'--glob', not '--include' (e.g. rg -g '*.{js,ts,vue}' '\bvar\b'), so the commands are copy-paste executable.

State the 'must ask for standards' constraint once authoritatively (e.g. in Mindset or the first Rule of Engagement) and reference it elsewhere, and deduplicate the standards-to-tooling pointer between 'When to Use' and 'When NOT to Use'.

DimensionReasoningScore

Conciseness

The body is dense with earned content — tables, concrete commands, BAD/GOOD contrasts, a report template — and does not explain concepts Claude already knows. Minor trimming opportunities exist: the 'MUST ask for the standards' constraint is repeated in Mindset, Phase 1, and the first Rule of Engagement, and the standards-to-tooling pointer appears at the end of both 'When to Use' and 'When NOT to Use'. This fits anchor 4 ('efficient; minor instances that could be trimmed') rather than 5.

4 / 5

Actionability

Phase 2's standard-to-check-method table, Phase 3's scan commands, the exact remediation prompt ('Would you like me to fix the auto-fixable violations? [Yes] [No] [Pick files]'), and the Troubleshooting table's verbatim suggested phrasings are highly concrete. It stops short of anchor 5 because the Phase 3 ripgrep invocations use '--include', which is GNU grep syntax rather than ripgrep's '-g', so the commands are not quite copy-paste executable as written.

4 / 5

Workflow Clarity

Five clearly sequenced phases with gates ('Before any code review begins, the model MUST explicitly ask', 'Collect ALL standards before proceeding'), feedback loops ('pause and re-scan affected files', the Troubleshooting table covering inaccessible links, conflicting standards, >1000-file scoping, and mid-review additions), and an explicit Verification checklist. The destructive/batch cap does not apply because confirmation before fixes and report-before-fix ordering are mandated, matching anchor 5 exactly.

5 / 5

Progressive Disclosure

Against the actual bundle structure: references/edge-cases.md exists, is genuinely relevant (deep-dive on non-prose standards formats, language mismatches, scoping), is one level deep, and is clearly signaled with a one-line description under 'Reference files'. Structure is good with clear section headers throughout, fitting anchor 4; not anchor 5 because the SKILL.md is a full ~220-line guide rather than an overview pointing at references — sections like the five WHY/BAD/GOOD Rules of Engagement could arguably be split out, and only one reference file exists.

4 / 5

Total

17

/

20

Passed

Description

58%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 solid description with a clear, concrete 'what' and a distinctive core constraint, held back by a missing 'when to use' clause and thin natural-language trigger coverage. The trigger phrases that would fix this already exist in the body's 'When to Use' section but were not surfaced into the frontmatter.

Suggestions

Add an explicit 'Use when...' clause with natural trigger phrases, e.g. 'Use when the user asks to audit a codebase, align code with their conventions, or check it against a style guide or coding standards.'

Include the synonyms users naturally say — 'conventions', 'style guide', 'audit' — which currently only appear in the body's 'When to Use' section.

Briefly name the kinds of standards handled (naming, style, framework conventions) to sharpen the 'what' toward anchor 5 specificity.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'systematically review the codebase to identify violations, report findings, and optionally remediate them' — plus the input modalities ('direct text input or as a link to a file/URL'). It falls short of anchor 5's comprehensive coverage because it does not hint at the scope of standards handled (naming, style, framework) or how non-checkable standards are treated; it clearly exceeds anchor 3's '1-2 concrete actions.' Voice is third person ('The model MUST ask'), so no person penalty applies.

4 / 5

Completeness

The 'what' is clear and concrete, but there is no 'Use when...' clause or equivalent explicit trigger guidance; the 'when' is only weakly implied (when the user has standards to check). Per the rubric guideline, a missing 'Use when' clause caps completeness at 3, and anchor 3 ('clear what but when missing or only weakly implied') fits exactly.

3 / 5

Trigger Term Quality

It contains some natural keywords users would say — 'coding standards', 'review the codebase', 'identify violations' — but misses the common variations and synonyms ('conventions', 'style guide', 'audit', 'align', 'lint') that the body's own 'When to Use' section lists. This matches anchor 3 ('Some relevant keywords but missing common variations or synonyms') and is below anchor 4, which requires only 'a few natural terms missing.'

3 / 5

Distinctiveness Conflict Risk

The 'user-provided set of coding standards' qualifier and the 'MUST ask the user for the standards' constraint give it a fairly distinct niche versus generic review skills, matching anchor 4 ('mostly distinct; minor overlap risk'). It is not a 5 because 'review the codebase to identify violations, report findings' is generic code-review phrasing that could still pull triggers meant for a general code-review skill.

4 / 5

Total

14

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

pantheon-org/tekhne

Path

skills/software-engineering/codebase-alignment/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.