CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

solid-review

Review existing code or modules specifically through practical SOLID design risks: responsibility, extensibility, substitutability, interface capability, and dependency inversion. Use for SOLID-focused diagnosis. Do not use for broad architecture review or implementation refactoring.

Quality

78%

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/solid-review/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%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 delivers unusually actionable review guidance: a sequenced five-step workflow, per-principle false-positive gates, calibrated severity/confidence rules, and a strict output contract, with details correctly pushed to three real reference files. Weaknesses are noticeable token redundancy (routing rules stated three times, a long inline report template) and, more seriously, references to 'required' shared/ policy files that are absent from the bundle, which undermines both actionability and navigation.

Suggestions

Fix or remove the dangling 'required' links to shared/base/*.md and shared/workflow-contract.md — either package those files in the bundle or drop the policy-link scaffolding, since following them currently fails.

Consolidate the routing guidance currently spread across 'Purpose and activation', 'Routing Boundary', and 'Example routing' into a single routing section to reduce token cost.

Move the full report template (the ~35-line output contract) into a reference file and keep only the required-section summary inline.

DimensionReasoningScore

Conciseness

The body is dense and imperative with little textbook explanation of known concepts, but routing guidance is repeated across three sections ('Purpose and activation', 'Routing Boundary', 'Example routing'), the Base Framework policy block adds boilerplate, and the ~35-line output-contract template inflates the main file. This matches 'mostly efficient but... could be tightened' rather than the 4 anchor's minor trims.

3 / 5

Actionability

For an instruction-only skill the guidance is highly concrete: per-principle diagnostic questions with false-positive gates, explicit severity/confidence rubrics, a copy-paste output template, mode-specific rules, and named tooling. It falls short of fully executable because the 'Required packaged policies' (shared/base/*.md) are referenced as required but do not exist in the bundle, leaving a gap in the guidance.

4 / 5

Workflow Clarity

The five-step workflow is clearly sequenced (scope/trace, build design map, diagnose with false-positive gate, assess impact, propose safe path) with explicit validation checkpoints — the evidence -> change scenario -> impact -> improvement -> trade-off -> test chain, evidence classification tiers, tests-before-structural-advice rule, and a final quality checklist. This matches the 5 anchor's explicit validation steps and error-recovery guidance.

5 / 5

Progressive Disclosure

The three real reference files (principles-and-evidence.md, refactoring-and-language.md, examples.md) are one level deep, well-signaled, and loaded at point of need. However, ten referenced paths (nine shared/base/*.md policy files and shared/workflow-contract.md) do not exist in the bundle despite being labeled 'Required', and the long output-contract template could live in a reference file — structure is present but organization has real gaps.

3 / 5

Total

15

/

20

Passed

Description

78%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, tightly-scoped description that clearly states what the skill does and when to use it, with good boundary guidance against neighboring skills. Its main weaknesses are a thin when-clause that names a domain instead of concrete user trigger phrases, and missing common synonyms (SRP/LSP, coupling, cohesion) that users naturally say.

Suggestions

Expand the when-clause with concrete user trigger phrases, e.g. 'Use when the user asks whether classes or modules violate SOLID, have too many responsibilities, or are too tightly coupled.'

Add natural synonyms users actually say — 'SRP', 'single responsibility', 'LSP', 'coupling', 'cohesion' — alongside the formal principle names to improve trigger matching.

DimensionReasoningScore

Specificity

The description names one concrete action ("Review existing code or modules specifically through practical SOLID design risks") and enumerates five specific focus areas ("responsibility, extensibility, substitutability, interface capability, and dependency inversion"), giving concrete scope with only minor coverage gaps. It is noticeably more specific than the 3 anchor's '1-2 concrete actions', but lacks the multiple distinct action verbs of the 5 anchor.

4 / 5

Completeness

Both parts are present: a clear what ("Review existing code or modules... through practical SOLID design risks") and an explicit when ("Use for SOLID-focused diagnosis. Do not use for broad architecture review or implementation refactoring"). The when-clause names a domain rather than concrete user trigger phrases (e.g. "when the user asks whether these classes violate SOLID"), matching the 4 anchor where 'when' could be more explicit or specific.

4 / 5

Trigger Term Quality

Good natural-term coverage: "SOLID", "responsibility", "extensibility", "substitutability", "interface capability", "dependency inversion", "code", "diagnosis" — terms a user seeking this skill would say. Common synonyms such as "SRP", "LSP", "single responsibility principle", "coupling", and "cohesion" are missing, which keeps it below the comprehensive 5 anchor.

4 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche (SOLID-focused diagnosis) with explicit exclusions ("Do not use for broad architecture review or implementation refactoring") that separate it from adjacent skills. Trigger risk is minimal because the SOLID framing is highly specific, matching the 5 anchor's 'clear niche with distinct triggers'.

5 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 10 missing, 9 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

Noorkhalel/saas-ai-skills

Path

skills/solid-review/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.