CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

64

Quality

77%

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/software-engineering/design-principles/solid-principles/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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, actionable body with a clear five-step workflow, concrete examples, and executable search commands. Its main defects are duplicated question lists between the checklist table and the workflow steps, validation that appears only in examples rather than as explicit workflow checkpoints, and References pointing at bundle files that do not exist.

Suggestions

Fix the References section: either create references/detailed-examples.md and references/anti-patterns-and-frameworks.md, or remove the dangling paths and inline only what is needed.

Merge the SOLID Checklist table with the per-step questions — the table's 'Check' column and each step's 'Ask' list currently ask the same things twice, costing tokens without adding guidance.

Promote validation from the illustrative examples into explicit workflow steps (e.g., a final 're-run the checks from the SOLID Checklist' checkpoint) so each refactor is verified before the review concludes.

DimensionReasoningScore

Conciseness

The body is lean — terse tables, short text-block examples, no concept tutorials — and assumes Claude already knows what SOLID is. It falls short of anchor 5 because the five workflow steps substantially restate the SOLID Checklist table's questions (e.g., Step 1's 'Does it handle more than one concern' duplicates the SRP row), which could be tightened into one pass.

4 / 5

Actionability

Concrete throughout: each step declares an Output, specific checks, a violation→refactor example, and the Quick Commands section provides copy-paste-ready `rg` commands. Anchor 5 is not reached because the rg patterns are crude heuristics (e.g., 'class.*Service.*Repository' will not reliably surface multi-concern classes) and the per-step examples are illustrative rather than executable, leaving minor gaps.

4 / 5

Workflow Clarity

The five-step sequence is clearly ordered with a declared output per step, and several examples include validation lines ('Validation: Each class now has one reason to change'). It does not reach anchor 5 because validation lives only inside the illustrative examples — the workflow itself has no explicit checkpoint or re-check loop telling Claude to verify the refactor before moving on.

4 / 5

Progressive Disclosure

The body is well-sectioned with clear headers, but the References section points to 'references/detailed-examples.md' and 'references/anti-patterns-and-frameworks.md' — no references/ directory or bundle files exist in this skill, so both paths are dangling and navigation dead-ends. This matches anchor 3 (structure present, references not actually usable) rather than anchor 4, where references would be mostly clear and resolvable.

3 / 5

Total

15

/

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: third-person voice, explicit what-and-when structure, named principles, and natural trigger phrases. The only improvements are broader synonym coverage and slightly sharper differentiation from neighboring design/refactoring skills.

DimensionReasoningScore

Specificity

The description names the domain and several concrete actions — 'tactical class design, method extraction, and interface definition' — and enumerates all five principles (SRP, OCP, LSP, ISP, DIP). It stops short of anchor 5 because the 'what' is framed as applying principles rather than listing a comprehensive set of concrete operations.

4 / 5

Completeness

Both halves are explicit: the 'what' ('Apply SOLID principles (SRP, OCP, LSP, ISP, DIP) for tactical class design, method extraction, and interface definition') and a concrete 'Use when...' clause with three specific trigger scenarios. It clearly matches anchor 5 rather than anchor 4, where the 'when' would be less explicit or specific.

5 / 5

Trigger Term Quality

'reviewing class design', 'refactoring code for maintainability', and 'designing interfaces and abstractions' are natural phrases users would say, backed by the SOLID acronym itself as a strong trigger. A few common variations ('code smells', 'tight coupling', 'clean code') are missing, so it does not reach comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

SOLID and 'tactical class design' carve out a clear niche distinct from adjacent skills (clean-architecture, design-patterns), and the body's 'When Not to Use' section reinforces boundaries. Minor overlap risk remains with generic 'refactoring code' triggers that could pull in general refactoring or testability skills, keeping it below anchor 5.

4 / 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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

15

/

16

Passed

Repository
pantheon-org/tekhne
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.