CtrlK
BlogDocsLog inGet started
Tessl Logo

code-formatter

Execute automatically formats and validates code files using Prettier and other formatting tools. Use when users mention "format my code", "fix formatting", "apply code style", "check formatting", "make code consistent", or "clean up code formatting". Handles JavaScript, TypeScript, JSON, CSS, Markdown, and many other file types. Trigger with relevant phrases based on skill purpose.

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

77%Weight 40%Scale 1-3

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

The body is highly actionable with a well-sequenced, validated formatting workflow. It loses points on conciseness and progressive disclosure due to duplication between inline content and the reference files, plus an orphaned placeholder examples.md that is never linked.

Suggestions

Eliminate duplication: replace the inline Error Handling table and the Examples section with one-line pointers to errors.md and examples.md, keeping the body lean.

Resolve the orphan examples.md — either populate it with real examples and link it from the Resources section, or remove it from the bundle.

Trim filler such as 'Trigger with relevant phrases based on skill purpose.' since triggers already live in the description.

DimensionReasoningScore

Conciseness

The body is mostly commands and steps, but the inline Error Handling table duplicates errors.md, the Examples section rehashes the Instructions, and the filler line 'Trigger with relevant phrases based on skill purpose' adds nothing. Not level 3 because of this redundancy; not level 1 because it does not explain concepts Claude already knows.

2 / 3

Actionability

Instructions give fully executable, copy-paste-ready commands such as `npx prettier --check "**/*.{js,jsx,ts,tsx,json,css,md}" --ignore-path .prettierignore` and `npx prettier --write`, with specific globs and paths. Not below 3 because the guidance is concrete and complete.

3 / 3

Workflow Clarity

A clear 7-step sequence with a validate-fix-revalidate loop: step 3 runs `--check` to identify files, step 4 applies `--write`, and step 7 runs a final `--check` to confirm compliance — appropriate validation for a batch write operation. Not level 2 because explicit validation checkpoints are present.

3 / 3

Progressive Disclosure

References are one level deep and listed in a Resources section, but content that should live only in references is duplicated inline (Error Handling table vs errors.md, Instructions vs implementation.md), and examples.md is an unreferenced placeholder ('Example usage patterns will be demonstrated in context.'). Not level 3 because the split is not clean; not level 1 because navigation and sectioning exist.

2 / 3

Total

10

/

12

Passed

Description

90%Weight 40%Scale 1-3

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 cleanly answers both what the skill does and when to use it, with strong natural-language trigger coverage and a distinct niche. Its main weakness is specificity: vague hedges ('other formatting tools', 'many other file types') and an ungrammatical opening ('Execute automatically formats') keep it from the top anchor.

Suggestions

Fix the ungrammatical opening 'Execute automatically formats' — use third-person voice such as 'Automatically formats and validates code files using Prettier.'

Replace the vague hedges 'and other formatting tools' and 'many other file types' with the concrete tool and file-type list already present in the body to raise specificity.

Remove the filler line 'Trigger with relevant phrases based on skill purpose.' — the explicit 'Use when...' list already covers triggers.

DimensionReasoningScore

Specificity

Names two concrete actions ('formats and validates code files using Prettier') plus specific file types, but hedges with vague phrases 'and other formatting tools' and 'many other file types', and opens with the ungrammatical 'Execute automatically formats'. Not the level-3 anchor because it does not list multiple specific concrete actions as comprehensively as the example; not level 2-below because it does name the tool and concrete verbs.

2 / 3

Completeness

Explicitly states what the skill does (formats and validates code files) and provides an explicit 'Use when users mention...' trigger clause, satisfying both the what and the when. Not level 2 because the when is explicit rather than implied.

3 / 3

Trigger Term Quality

The 'Use when' clause enumerates natural user phrasings — 'format my code', 'fix formatting', 'apply code style', 'check formatting', 'make code consistent', 'clean up code formatting' — giving good coverage of terms a user would actually say.

3 / 3

Distinctiveness Conflict Risk

Targets a clear niche (Prettier-based code formatting) with distinct formatting-specific triggers, making it unlikely to fire for unrelated skills. Not level 2 because the scope and triggers are specific enough to avoid overlap.

3 / 3

Total

11

/

12

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository
jeremylongshore/claude-code-plugins-plus-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.