CtrlK
BlogDocsLog inGet started
Tessl Logo

ac-code-validator

Validate code quality and standards. Use when running linting, checking types, validating code style, or performing static analysis.

63

Quality

79%

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 ./.claude/skills/ac-code-validator/SKILL.md

The canonical home for this skill is ac-code-validator in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

72%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 lean, highly actionable API-overview skill whose examples match its real implementation and whose structure and file split are exemplary. The main gap is workflow guidance: the validate -> fix loop lacks an explicit re-validation checkpoint, which is material because auto-fix batch-modifies files.

Suggestions

Add an explicit feedback loop for auto-fix, e.g., "After auto_fix(), re-run validate() and only proceed when result.valid is true", to earn the validation checkpoint the batch operation requires.

State where the configuration file is read from (e.g., .claude/validator-config.json) so the Configuration section is directly usable.

Remove the redundant "## Purpose" section and collapse the per-check tool comments or the Language Support table, since they duplicate each other.

DimensionReasoningScore

Conciseness

The body is code- and example-dominated with no explanations of concepts Claude already knows; every token-earning example (Quick Start, per-check calls, result JSON, config JSON, auto-fix) carries information. Not 5 because of minor trimmable redundancy: the "## Purpose" section restates the frontmatter description, and the per-check tool comments ("# ESLint for JS/TS", "# Ruff/Flake8 for Python") duplicate the Language Support table.

4 / 5

Actionability

The code examples are executable and verified against the real bundle: CodeValidator(project_dir), await validator.validate(), per-check methods, and auto_fix(types=[...]) all match scripts/code_validator.py, and the result/config JSON examples are concrete. Not 5 because of minor gaps: Quick Start leaves project_dir undefined, and the Configuration section never states where the config file lives (the script hardcodes .claude/validator-config.json).

4 / 5

Workflow Clarity

The implied sequence (validate -> inspect result JSON -> auto-fix) is present but checkpoints are implicit: there is no stated loop of re-validating after auto_fix or checking result.valid / summary.blocking before proceeding. Per the rubric's scoring notes, auto-fix rewrites files across the project (a batch/semi-destructive operation) and the absence of a fix -> re-validate feedback loop caps this dimension at 3 even though the skill is single-purpose.

3 / 5

Progressive Disclosure

The body is a well-sectioned overview with a clear one-level-deep reference ("See scripts/code_validator.py for full implementation") pointing to a real bundle file, and no nested references. Implementation detail is appropriately delegated to the script rather than inlined, and navigation via section headers is easy.

5 / 5

Total

16

/

20

Passed

Description

75%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 well-formed description in third person with an explicit and concrete "Use when" trigger clause covering four actions. Its main weakness is the generic "what" statement and missing coverage of the skill's full capability set (formatting, security scanning, auto-fix).

Suggestions

Strengthen the "what" clause by enumerating the concrete operations, e.g., "Runs linting, type checking, formatting checks, and security scans, with auto-fix for correctable issues."

Add natural trigger variations such as "formatting", "security scan", "run the linter", and tool names (eslint, ruff, mypy, bandit) to improve trigger-term coverage.

DimensionReasoningScore

Specificity

"Use when running linting, checking types, validating code style, or performing static analysis" lists several concrete actions, matching the anchor for several specific actions with minor gaps. It is not 5 because "Validate code quality and standards" is generic phrasing and the description omits capabilities the skill actually has (formatting checks, security scanning, auto-fix); it is above 3 because four distinct concrete actions are named rather than just 1-2.

4 / 5

Completeness

Both parts are present: "Validate code quality and standards" answers what, and an explicit "Use when..." clause with concrete trigger phrases answers when. Not 5 because the "what" half is abstract compared to the anchor-5 example, which enumerates concrete operations; the "when" half alone reaches anchor-5 quality.

4 / 5

Trigger Term Quality

Natural developer phrasings like "running linting", "checking types", "validating code style", and "static analysis" give good keyword coverage. Not 5 because common variations and synonyms are missing (e.g., "formatting", "security scan", "run the linter", tool names like eslint/ruff/mypy); not 3 because multiple natural trigger phrases users would actually say are present.

4 / 5

Distinctiveness Conflict Risk

The niche (static analysis / lint / type-check validation) is mostly distinct with trigger terms unlikely to grab unrelated skills. Not 5 because "code quality" is broad enough to overlap with generic code-review or testing skills; not 3 because the enumerated triggers (linting, type checking, static analysis) anchor it firmly to this skill's function.

4 / 5

Total

16

/

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
fernandezbaptiste/Skrillz
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.