CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

053-design-simple-rules

Use when Java design, refactoring, or implementation tradeoffs should be evaluated with Kent Beck's simple design rules, including passes the tests, reveals intention, has no duplication, and has the fewest elements. This should trigger for requests such as Apply simple design rules; Review this design with Beck's rules; Choose between these refactoring options; Keep this Java design simple. Part of Plinth Toolkit

65

Quality

82%

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

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.

The body is well-structured with a clear ordered workflow and excellent progressive disclosure to a single real reference file. Its main weakness is redundancy: the rule ordering is restated across three sections and the trigger list duplicates the frontmatter description.

Suggestions

Trim the restatement of the four-rule ordering so it appears once authoritatively (e.g., in Constraints) and is only referenced elsewhere, cutting the 'What is covered' bullets or the workflow step titles.

Drop or shorten the 'When to use this skill' section, which duplicates the frontmatter description's trigger phrases verbatim.

Add an explicit validation step to the workflow (e.g., re-run the named verification signal after applying the recommended option) to close the loop between recommendation and confirmation.

DimensionReasoningScore

Conciseness

The ordered rules are restated three times — in the 'What is covered' bullets, the MUST-constraints, and the five workflow steps — and 'When to use this skill' duplicates the frontmatter description's trigger phrases. Mostly efficient but could be tightened; not 4 because the redundancy spans several sections, not minor instances.

3 / 5

Actionability

Concrete, instruction-specific guidance such as 'tests, characterization checks, build checks, or manual evidence', 'repeated knowledge, policy, mappings, validation, queries', and 'unnecessary classes, methods, parameters, branches, layers'. Mostly actionable with minor gaps since all worked detail is deferred to the reference file; not 5 because the body alone gives a skeletal procedure.

4 / 5

Workflow Clarity

Five clearly sequenced steps mirroring the rule priority order, with step 1 requiring identification of the verification signal and step 5 requiring the report to name it. Not 5 because there is no explicit re-validation loop after applying a recommended change; not a destructive/batch skill so no cap applies.

4 / 5

Progressive Disclosure

The body is a tight overview with a single real, one-level-deep reference (references/053-design-simple-rules.md, verified present) that is clearly signaled both in the MUST-read constraint and a dedicated 'Reference' section. This matches the top anchor for structure and navigation.

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

The description is strong: it names the domain and the four ordered rules, uses an explicit 'Use when' clause with concrete natural-language trigger phrases, and stays in third person. Distinctiveness is good, with only minor overlap risk on generic refactoring-option requests.

DimensionReasoningScore

Specificity

Names the domain (Java design, refactoring, implementation tradeoffs) and enumerates the concrete method — 'passes the tests, reveals intention, has no duplication, and has the fewest elements' — with only minor gaps in coverage. Not 3 because it goes beyond 1-2 generic actions; not 5 because the capability list centers on a single evaluate action rather than multiple distinct actions.

4 / 5

Completeness

Explicitly answers both what ('evaluated with Kent Beck's simple design rules, including passes the tests, reveals intention, has no duplication, and has the fewest elements') and when ('Use when Java design... This should trigger for requests such as...') with concrete trigger phrases, matching the top anchor.

5 / 5

Trigger Term Quality

Natural trigger phrases are provided ('Apply simple design rules; Review this design with Beck's rules; Choose between these refactoring options; Keep this Java design simple') with synonym coverage. Not 5 because common variations such as 'Does this design pass the simple design rules?' appear only in the body, not the description.

4 / 5

Distinctiveness Conflict Risk

'Kent Beck's simple design rules' establishes a clear niche with distinct triggers, but 'Choose between these refactoring options' overlaps with generic refactoring/review advisors, giving minor conflict risk. Not 5 due to that overlap; not 3 since the core triggers are firmly tied to this skill.

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

jabrena/plinth

Path

skills/053-design-simple-rules/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.