CtrlK
BlogDocsLog inGet started
Tessl Logo

commitlint

When setting up commit message validation for a project. When project has commitlint.config.js or .commitlintrc files. When configuring CI/CD to enforce commit format. When extracting commit rules for LLM prompt generation. When debugging commit message rejection errors.

54

Quality

61%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/commitlint/skills/commitlint/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The content is highly actionable with executable code, concrete CLI commands, and an explicit validation feedback loop, but it is long and monolithic: bulky reference tables and dated external links are inlined in SKILL.md with no progressive disclosure to separate reference files, capping conciseness and progressive_disclosure.

Suggestions

Move the full Rule Reference tables (Type/Subject/Scope/Header/Body/Footer) and the complete configuration schema into a separate references file (e.g., references/rules.md) and link to it from the body, improving both conciseness and progressive_disclosure.

Remove the 'accessed 2025-01-15' date annotations from the external links, or relocate them to a deprecated/versioned section, since time-sensitive annotations penalize conciseness.

Trim the duplicated rule information between the @commitlint/config-conventional table and the per-category Rule Reference tables to reduce redundancy.

DimensionReasoningScore

Conciseness

The body is mostly efficient domain-specific reference material (severity tables, CLI flags, rule arrays) that Claude would not already know, but the full inline rule reference (Type/Subject/Scope/Header/Body/Footer rule tables) plus dated external links ('accessed 2025-01-15') are tightening candidates that could be trimmed or split out, fitting the 'mostly efficient but includes some unnecessary explanation or could be tightened' anchor rather than the lean 4.

3 / 5

Actionability

It provides fully executable, copy-paste-ready guidance across the common cases: install commands for npm/yarn/pnpm, concrete CLI invocations ('npx commitlint --last'), complete JS/TS config examples, and working Python (extract_rules_for_prompt, validate_with_commitlint), matching the 'fully executable; copy-paste ready; covers common cases' anchor and clearly above the mostly-executable 4.

5 / 5

Workflow Clarity

The LLM Integration 'Validation loop pattern' is an explicit validate -> feed errors back -> retry -> return sequence with a feedback loop, satisfying the validation-checkpoint requirement for the risky validation path, but other sections (configuration setup, CLI usage) are listed without consistent checkpoints, fitting 'clear sequence with most checkpoints present; minor validation gaps' rather than the fully checkpointed 5.

4 / 5

Progressive Disclosure

The ~500-line body is well-structured with clear section headers, but it is monolithic: no bundle files exist (references/scripts/assets absent) and large reference content (the full rule tables, CLI reference, programmatic usage) that would naturally live in separate one-level-deep files is inlined, matching the 'some structure but could be better organized; content that should be separate is inline' anchor rather than the well-split 4.

3 / 5

Total

15

/

20

Passed

Description

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

The description is trigger-rich and distinct but structurally one-sided: it lists many 'when' scenarios while omitting any explicit 'what does this skill do' statement, capping completeness. Trigger-term quality and distinctiveness are strong, while specificity is adequate but not comprehensive.

Suggestions

Lead the description with a concise declarative 'what' clause (e.g., 'Validates commit messages against Conventional Commits format using commitlint configuration and rules.') before the 'when' triggers to satisfy the completeness 'what AND when' requirement.

Keep the existing 'When ...' clauses but consolidate them into a single explicit 'Use when ...' sentence to preserve trigger coverage without fragmenting the what/when structure.

Add the bare keyword 'commitlint' as a noun and '.commitlintrc' synonyms to push trigger-term coverage toward comprehensive.

DimensionReasoningScore

Specificity

The description names the domain (commit message validation) and several concrete actions ('setting up commit message validation', 'configuring CI/CD to enforce commit format', 'extracting commit rules for LLM prompt generation', 'debugging commit message rejection errors'), but the actions are framed only as triggers rather than a comprehensive capability list, matching the anchor that names the domain with 1-2+ actions but is not comprehensive.

3 / 5

Completeness

The description is composed entirely of 'When ...' trigger clauses with no declarative 'what does this skill do' statement, which matches the anchor 'only when is present without what'. It is not a 3 because there is no clear standalone 'what' (the validating capability appears only in the body, not the description), and not a 1 because the when clauses are specific rather than extremely vague.

2 / 5

Trigger Term Quality

It includes natural, relevant trigger terms users would say ('commit message validation', 'CI/CD to enforce commit format', 'commit rules', 'LLM prompt generation') plus concrete file signals ('commitlint.config.js', '.commitlintrc'), giving good keyword coverage with only minor natural variations missing, fitting the 'good keyword coverage; a few natural terms missing' anchor rather than the fully comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

It targets a clear niche (commitlint specifically) with distinct triggers like 'commitlint.config.js or .commitlintrc files' that are unlikely to fire for unrelated skills, leaving only minor overlap risk with a broader Conventional Commits skill, which fits the 'mostly distinct; minor overlap risk' anchor rather than the minimal-risk 5.

4 / 5

Total

13

/

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (505 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository
Jamie-BitFlight/claude_skills
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.