CtrlK
BlogDocsLog inGet started
Tessl Logo

coding-standards

Baseline cross-project coding conventions for naming, readability, immutability, and code-quality review. Use detailed frontend or backend skills for framework-specific patterns. Use when reviewing code quality or naming with no framework-specific skill that applies.

61

Quality

73%

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 ./skills/coding-standards/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 dense, example-driven conventions catalog that is highly actionable but overlong for a SKILL.md body. It re-explains basic programming principles Claude already knows and inlines framework-specific content that contradicts its own scope boundaries, with no bundle files to offload detail into.

Suggestions

Cut the generic principle explanations (the KISS/DRY/YAGNI definitions, "Code is read more than written", Promise.all parallelism) — Claude already knows these; keep only the project-specific PASS/FAIL rules.

Move the React Best Practices and API Design Standards sections into separate reference files (or remove them, since the scope boundary already defers to frontend-patterns/backend-patterns), keeping SKILL.md as a lean overview.

Fix or remove the reference to "rules/common/coding-style.md" — no such file exists in this bundle, so the pointer is currently dangling.

DimensionReasoningScore

Conciseness

The bulk is concrete PASS/FAIL examples, but sections re-teach concepts Claude already knows: "Code is read more than written", the KISS/DRY/YAGNI principle definitions ("Don't build features before they're needed", "Avoid copy-paste programming"), and standard React/async knowledge like using Promise.all for parallel fetches. Mostly efficient with some unnecessary explanation, matching the 3 anchor rather than 2 since the padding is a minority of the ~550 lines.

3 / 5

Actionability

Nearly every standard is encoded as executable copy-paste TypeScript (naming, immutability spread patterns, zod validation, early returns), which is the right form for a conventions skill. Minor gaps keep it below 5: several examples are placeholders rather than runnable code ("function getMarket... { // Implementation }", "// 100 lines of code"), so the guidance is mostly but not fully executable.

4 / 5

Workflow Clarity

This is a single-purpose conventions/review skill with no multi-step procedure, and the single action — apply the PASS/FAIL standards — is unambiguous thanks to the "When to Activate" and "Scope Boundaries" sections. It does not reach 5 because the skill frames itself around "Reviewing code for quality" yet never sequences that review action (no order of checks, no reporting format), a minor gap for a simple skill.

4 / 5

Progressive Disclosure

Section headers give real structure, but ~550 lines are inlined monolithically, including whole "React Best Practices" and "API Design Standards" sections that the skill's own scope boundary defers to frontend/backend skills — content that clearly belongs in separate reference files. The one file reference, "rules/common/coding-style.md", points to a path that does not exist in this bundle (no references/ directory at all), so references are present but not clearly verifiable/signaled.

3 / 5

Total

14

/

20

Passed

Description

83%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 strong description that clearly states what the skill covers and when to use it, with explicit de-scoping against framework-specific sibling skills. Trigger term coverage and action specificity have minor room for improvement, but nothing is vague or padded.

DimensionReasoningScore

Specificity

The description lists several concrete areas — "coding conventions for naming, readability, immutability, and code-quality review" — going beyond naming the domain alone. It falls short of the 5 anchor because it names topic areas rather than multiple distinct concrete actions, leaving minor coverage gaps.

4 / 5

Completeness

It explicitly answers both questions: the "what" is "Baseline cross-project coding conventions for naming, readability, immutability, and code-quality review", and the "when" is the concrete "Use when reviewing code quality or naming with no framework-specific skill that applies". Both are explicit with concrete trigger phrases, matching the 5 anchor.

5 / 5

Trigger Term Quality

Natural trigger phrases like "coding conventions", "naming", "code quality", "readability", and "reviewing code quality or naming" map well to what a user would actually say. Common variations such as "best practices", "clean code", or "style guide" are missing, so it is not the comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

The explicit routing — "Use detailed frontend or backend skills for framework-specific patterns" and the "no framework-specific skill that applies" condition — carves out a clear baseline niche. Minor overlap risk remains with generic code-review/clean-code skills triggered by "code quality".

4 / 5

Total

17

/

20

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.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

metadata_version

'metadata.version' is missing

Warning

Total

14

/

16

Passed

Repository
affaan-m/ECC
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.