CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

coding-guidelines

Behavioral guidelines to reduce common LLM coding mistakes. Use when writing, modifying, or reviewing code — implementation tasks, code changes, refactoring, bug fixes, or feature development. Do NOT use for architecture design, documentation, or non-code tasks.

69

Quality

87%

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

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

An exemplary lean behavioral-guidelines body: every section is terse, concrete, and immediately usable, with explicit verification-oriented guidance in the goal-driven section and no filler. Its only limitation is that its plan/verify pattern is a generic template rather than a worked concrete workflow, which is acceptable for a guidelines skill.

DimensionReasoningScore

Conciseness

The body is uniformly lean imperative guidance ("Touch only what you must", "If you write 200 lines and it could be 50, rewrite it") with no padding and no explanation of concepts Claude already knows — every token earns its place, matching anchor 5 rather than anchor 4's minor over-explanation.

5 / 5

Actionability

Concrete, directly usable guidance throughout: worked task-to-goal transformations ("'Add validation' → 'Write tests for invalid inputs, then make them pass'"), a per-step plan template with verify clauses, and testable heuristics ("Every changed line should trace directly to the user's request"). For an instruction-only skill this is fully actionable, matching anchor 5.

5 / 5

Workflow Clarity

Section 4 explicitly defines success criteria and verification loops ("Loop until verified", plan steps with "→ verify: [check]"), but the plan format is a generic template rather than concrete validation steps, and sections 1–3 are parallel checklists rather than a sequenced workflow — anchor 4 fits better than anchor 5, and there are no destructive or batch operations that would cap the score.

4 / 5

Progressive Disclosure

The 65-line body is entirely self-contained with clear section headers and no bundle files, and nothing in it belongs in a separate reference file — the content is appropriately placed and easy to navigate, matching anchor 5 for a skill that needs no external references.

5 / 5

Total

19

/

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 with explicit what/when/negative-boundary structure and natural trigger phrasing, weakened only by a single generic capability statement and a very broad positive trigger that overlaps the entire coding domain. It comfortably matches the rubric's good-overall examples in structure.

Suggestions

Replace the single generic capability statement with a brief enumeration of the concrete behaviors the skill applies (e.g., surfacing assumptions, keeping changes surgical, defining verification criteria before implementing) to raise specificity.

Add boundary phrasing that distinguishes it from dedicated task skills (e.g., note it supplements rather than replaces code-review or test-writing skills) to reduce conflict risk.

Include one or two additional natural trigger terms users commonly say, such as "debugging" or "implementing a function", to round out trigger coverage.

DimensionReasoningScore

Specificity

"Behavioral guidelines to reduce common LLM coding mistakes" names the domain and function but offers only one generic capability statement rather than several enumerated concrete actions, matching anchor 3; it is more concrete than anchor 2's bare domain-naming but does not list the specific behaviors the skill applies to reach anchor 4.

3 / 5

Completeness

The description explicitly answers both what ("Behavioral guidelines to reduce common LLM coding mistakes") and when ("Use when writing, modifying, or reviewing code — implementation tasks, code changes, refactoring, bug fixes, or feature development"), and adds a negative boundary ("Do NOT use for architecture design, documentation, or non-code tasks") — an exact match for anchor 5.

5 / 5

Trigger Term Quality

Triggers like "writing, modifying, or reviewing code — implementation tasks, code changes, refactoring, bug fixes, or feature development" use natural user phrasing with good synonym coverage (refactoring, bug fixes, feature development), fitting anchor 4; common variations such as "debugging" or "review a PR" are missing, so it falls short of anchor 5's comprehensive coverage.

4 / 5

Distinctiveness Conflict Risk

The positive trigger spans essentially all code work, so it could overlap with any code-related skill (code review, refactoring, testing skills), while the "Do NOT use" clause only excludes non-code tasks — fitting anchor 3 (could still overlap with similar skills) 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

tech-leads-club/agent-skills

Path

packages/skills-catalog/skills/(development)/coding-guidelines/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.