CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

improvement

Guide for making improvements to existing ClaudeBar functionality using TDD. Use this skill when: (1) Enhancing existing features (not adding new ones) (2) Improving UX, performance, or code quality (3) User asks "improve X", "make Y better", or "enhance Z" (4) Small enhancements that don't require full architecture design For NEW features, use implement-feature skill instead.

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

92%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 excellent process-oriented skill body: executable commands and test examples, an explicit red/green workflow with validation checkpoints and a checklist, and well-signaled one-level-deep references for deep material. The only real cost is minor duplication between the ASCII workflow diagram, the prose phase descriptions, and the checklist.

DimensionReasoningScore

Conciseness

The body is dense with project-specific rules Claude cannot know (CANONICAL §5/§6, provider JSON rules, CHANGELOG line format) and never explains general concepts, so it broadly assumes competence. Not 5 because the 36-line ASCII workflow diagram restates Phases 0-3 that are described again in prose, and the checklist restates already-stated workflow steps — minor duplication that could be trimmed.

4 / 5

Actionability

Fully executable guidance throughout: copy-paste commands ('tuist test Providers', complete xcodebuild invocations, 'scripts/demo-screenshots.sh'), executable Swift test examples, per-type test approaches naming real fixtures (StubbedProvider, design-concept/), and an exact CHANGELOG line spec. Not 4 because no section relies on pseudocode or vague direction.

5 / 5

Workflow Clarity

The 0-3 phase sequence (design check, understand, red, green) is clearly ordered with explicit validation checkpoints ('Test should FAIL initially', 'New test PASSES', 'All existing tests still pass', 'Full xcodebuild test green') and a closing checklist. Not 4 because every checkpoint is explicit rather than implied, and no destructive or batch operation lacks validation.

5 / 5

Progressive Disclosure

The main body stays an overview and routes deep material to clearly signaled, one-level-deep references (domain-shape.md, tdd-patterns.md, MODULAR_DESIGN.md, the implement-feature architecture map), each stated with its purpose. No bundle files exist to verify, but the body's structure and navigation are clean with no nested or buried references. Not 4 because there is no content inlined that clearly belongs in a separate file.

5 / 5

Total

19

/

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 description with explicit what/when structure, concrete quoted trigger phrases, and a clear routing boundary to implement-feature. Its main weaknesses are generic action verbs (improve/enhance rather than specific capabilities) and unaddressed overlap with a fix/refactor-style sibling skill.

Suggestions

Replace generic verbs with 2-3 concrete capabilities, e.g. 'moves a rule onto its owning type, improves provider definitions, speeds up existing behavior paths' so the what reads like specific actions rather than categories.

Add one boundary line for the fix case (e.g. 'For broken behavior, use fix-bug instead') to close the remaining overlap risk with closely related skills.

Add the synonyms users also say ('optimize', 'refactor', 'tweak') to the trigger list to broaden natural keyword coverage.

DimensionReasoningScore

Specificity

The description names the domain (improvements to existing ClaudeBar functionality) and enumerates improvement categories ('Enhancing existing features', 'Improving UX, performance, or code quality'), but the actions themselves stay at the generic improve/enhance level rather than listing several specific concrete actions. Fits anchor 3 (domain plus limited concrete scope), not 4, because no concrete capabilities like specific test approaches or improvement types are named.

3 / 5

Completeness

Explicitly answers both questions: 'Guide for making improvements to existing ClaudeBar functionality using TDD' (what) and a numbered 'Use this skill when:' list with concrete quoted trigger phrases (when), plus a routing boundary for the new-feature case. Matches the anchor-5 example structure exactly; not below because neither what nor when is vague or implied.

5 / 5

Trigger Term Quality

Quoted natural phrases 'improve X', 'make Y better', or 'enhance Z' plus 'enhancing existing features' give good coverage of the improve/better/enhance family users would actually say. Not 5 because common synonyms like 'optimize', 'refactor', 'polish', or 'tweak' are missing.

4 / 5

Distinctiveness Conflict Risk

Clear niche (existing-feature improvements) with an explicit boundary against the nearest competing skill ('For NEW features, use implement-feature skill instead') and trigger phrasing distinct from fix-type requests. Not 5 because no boundary against a fix-bug or refactoring neighbor is stated, leaving minor overlap risk with closely related skills.

4 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 11 suspicious

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

tddworks/ClaudeBar

Path

.claude/skills/improvement/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.