CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

coding-principles

Language-agnostic coding principles for maintainability, readability, and quality. Use when implementing features, refactoring code, or reviewing code quality.

Quality

71%

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 ./dev-workflows-fullstack/skills/coding-principles/SKILL.md

The canonical home for this skill is coding-principles in shinpr/claude-code-workflows

SKILL.md
Quality
Evals
Security

Quality

Content

53%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 body is a well-organized, topically structured principles document with real, clearly signaled one-level-deep bundle references. It is held back by duplicated or generic bullets that restate knowledge Claude already has, the total absence of illustrative examples, and abstract prose sections that dilute actionable guidance.

Suggestions

Merge the duplicated bullets (early returns, descriptive naming, measurable-bottleneck optimization) into single statements and delete bullets that restate universally known basics (single responsibility, grammar and formatting, high cohesion/low coupling) so every remaining line carries non-obvious guidance.

Add one compact before/after example per major theme (e.g., a parameter-object refactor, a boundary-validation snippet) to convert abstract principles into concrete, actionable patterns.

Tighten the 'Reference Representativeness' prose into a short checklist or move it into a reference file, keeping SKILL.md as a lean overview that points to the detailed method.

DimensionReasoningScore

Conciseness

The bullet style is dense and assumes competence, but there is noticeable duplication (e.g., "Use early returns to reduce nesting" beside "Use early returns or extraction when nesting obscures..."; "After identifying actual bottlenecks through profiling" beside "Optimize only after measurable bottlenecks are identified") and several bullets restate basics Claude already knows ("Each function should do one thing well", "Use proper grammar and formatting"), fitting anchor 3 (mostly efficient but could be tightened) more than anchor 2's padded sections or anchor 4's minor trims.

3 / 5

Actionability

Many directives are concrete ("Inject external dependencies as parameters", "Use parameterized queries (prepared statements) for all database access"), but there are no illustrative examples at all and sections like "Reference Representativeness" remain abstract prose, matching anchor 3 (some concrete guidance but incomplete, missing key details) rather than anchor 4's mostly-executable guidance with only minor gaps.

3 / 5

Workflow Clarity

This is a principles reference with no multi-step process to sequence and no risky operations requiring validation, so no cap applies, but the simple-skill exception (under 50 lines, single task) does not apply to a ~170-line multi-topic document; topical organization is clear yet no workflow or checkpoints exist, landing on anchor 3.

3 / 5

Progressive Disclosure

Both bundle files (references/security-checks.md, references/frontend.md) exist, are referenced one level deep, and carry clear signals (inline pointer in the Security section; a References section with a when-to-read trigger), matching anchor 4; dense fully-inlined sections like "Reference Representativeness" and generic inline security principles keep it from anchor 5's clean overview split.

4 / 5

Total

13

/

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 concise, well-structured description that clearly answers both what the skill provides and when to use it, with natural trigger phrases. Its main weaknesses are the absence of concrete capability actions and the broad "implementing features" trigger, which creates overlap risk with general coding and code-review skills.

DimensionReasoningScore

Specificity

The description names the domain ("coding principles") and three concrete focus areas ("maintainability, readability, and quality") but states no concrete actions the skill performs, matching anchor 3 (domain plus some specifics, not comprehensive) rather than anchor 2's bare domain naming or anchor 4's list of specific actions.

3 / 5

Completeness

It explicitly answers both questions: the what is "Language-agnostic coding principles for maintainability, readability, and quality" and the when is an explicit "Use when..." clause listing three concrete triggers, matching anchor 5; anchor 4 would require the when to be less explicit or specific, which it is not.

5 / 5

Trigger Term Quality

"Use when implementing features, refactoring code, or reviewing code quality" supplies natural phrases users would say, but common synonyms such as "clean code", "code smells", or "best practices" are absent, fitting anchor 4 (good keyword coverage, a few natural terms missing) rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The domain is somewhat specific (quality/maintainability principles with a code-review trigger), but "implementing features" would fire for nearly any coding request and the skill overlaps with code-review and language-specific style skills, matching anchor 3 rather than anchor 4's minor overlap risk.

3 / 5

Total

15

/

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

shinpr/claude-code-workflows

Path

dev-workflows-fullstack/skills/coding-principles/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.