CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

solid-principles

Apply SOLID principles (SRP, OCP, LSP, ISP, DIP) for tactical class design, method extraction, and interface definition. Use when reviewing class design, refactoring code for maintainability, or designing interfaces and abstractions.

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

75%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 well-structured, highly actionable skill body with clear sections, sequenced workflow, executable searches, and disciplined anti-pattern guidance. Its main weakness is redundancy: the checklist table, the five steps, and the reference file repeat the same signals and commands, inflating token cost without adding information.

Suggestions

Collapse the SOLID Checklist table and the five Workflow steps into a single form: keep the table for at-a-glance checks and move the per-principle questions and examples into references/review-checklist.md, which already mirrors them.

Remove the Quick Commands rg searches from the body (or the reference) — they are character-for-character duplicated; keeping them only in the reference and linking preserves one-level-deep disclosure with no token duplication.

Add an explicit validation/feedback step to the Workflow (e.g., 'after each refactor, re-run the candidate searches and confirm the signal is gone'), making the Validation line a workflow requirement rather than an example convention.

DimensionReasoningScore

Conciseness

The SOLID Checklist table, the five Workflow steps, and the reference file all restate the same per-principle checks, refactor signals, and rg commands (e.g., the identical "class.*Service.*Repository" search appears in both Quick Commands and references/review-checklist.md). Content is mostly efficient but the triple-stated signals are more than minor padding, fitting the could-be-tightened anchor.

3 / 5

Actionability

Guidance is fully executable: copy-paste rg commands in Quick Commands, per-principle refactor signals in the table, and concrete violation/refactor/validation example blocks for every step covering the common cases. This matches the 5 anchor for an instruction-plus-code skill.

5 / 5

Workflow Clarity

Five clearly sequenced steps each declare an Output, questions to ask, and an example including a Validation line. It stops short of the 5 anchor because the workflow itself lacks an explicit feedback loop (re-check after refactor, escalate on ambiguity) — validation is shown in examples and the reference's output format rather than as an instructed step.

4 / 5

Progressive Disclosure

The body is a well-organized overview with a References table giving a one-level-deep, real, well-signaled reference (references/review-checklist.md). It fits the 4 anchor rather than 5 because significant content (candidate searches, judgement guidance, step questions) is duplicated between SKILL.md and the reference instead of being split cleanly.

4 / 5

Total

16

/

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: explicit what and when clauses, third-person voice, named principles, and natural trigger phrases. Minor room to expand trigger synonyms and sharpen the distinctness of its triggers relative to adjacent refactoring/design skills.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Apply SOLID principles (SRP, OCP, LSP, ISP, DIP) for tactical class design, method extraction, and interface definition" — naming the domain and specific sub-activities. It falls short of the 5 anchor because the actions are framed at a design-activity level rather than a fully enumerated set of concrete operations.

4 / 5

Completeness

It explicitly answers both: what ("Apply SOLID principles... for tactical class design, method extraction, and interface definition") and when ("Use when reviewing class design, refactoring code for maintainability, or designing interfaces and abstractions"). Both are concrete and explicit, matching the 5 anchor exactly.

5 / 5

Trigger Term Quality

"Use when reviewing class design, refactoring code for maintainability, or designing interfaces and abstractions" provides natural phrases users would say, plus the SOLID acronym and principle abbreviations. A few common variations (e.g., "code review", "coupling", "testability") are missing, so it matches the good-coverage-with-gaps anchor rather than the comprehensive one.

4 / 5

Distinctiveness Conflict Risk

SOLID is a distinct, well-known niche with named principle triggers, giving minimal conflict risk. However, phrases like "refactoring code for maintainability" overlap with general refactoring and design skills, so it is mostly distinct rather than a clear isolated niche.

4 / 5

Total

17

/

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

pantheon-org/tekhne

Path

skills/software-engineering/design-principles/solid-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.