CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

68

Quality

84%

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

81%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 focused, well-structured TDD improvement skill with a clear Red/Green workflow, explicit validation checkpoints, and executable Swift examples. Minor gains are available by tightening the ASCII diagrams and replacing placeholder templates with concrete examples.

Suggestions

Replace the `{Component}` / `{describes improved behavior}` placeholders in the TDD pattern with one fully concrete, copy-paste-ready Swift example to push actionability toward 5.

Tighten the ASCII workflow boxes or collapse them into a concise numbered list to recover tokens without losing the step sequence.

Consolidate the repeated 'Examples:' fenced blocks under each improvement type into tighter inline lists to reduce verbosity.

DimensionReasoningScore

Conciseness

Lean body that assumes Claude's knowledge of TDD and Swift with no concept padding; the ASCII workflow boxes and repetitive 'Examples:' blocks are minor trim opportunities keeping it just below a 5.

4 / 5

Actionability

Provides executable Swift test examples and the concrete `swift test` command, but the TDD pattern template uses placeholders like `{Component}` and `{describes improved behavior}` rather than a fully concrete example.

4 / 5

Workflow Clarity

Clear three-step Red/Green TDD sequence with explicit validation checkpoints (test FAILS before implementation, PASSES after, existing tests still pass) and a final checklist with feedback expectations.

5 / 5

Progressive Disclosure

Well-organized sections with a single one-level-deep architecture reference link and no nested references; structure is strong though a couple of inline example blocks could arguably live elsewhere.

4 / 5

Total

17

/

20

Passed

Description

87%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, well-structured description that concretely states what the skill does and gives explicit numbered trigger conditions plus routing guidance. It uses appropriate third-person voice and natural user phrasing.

DimensionReasoningScore

Specificity

Lists several specific actions ('Enhancing existing features', 'Improving UX, performance, or code quality') with a scope caveat ('not adding new ones'), covering the domain concretely with only minor gaps.

4 / 5

Completeness

Explicitly answers both 'what' (improvements to existing functionality using TDD) and 'when' via four numbered trigger conditions, plus a routing exclusion for new features.

5 / 5

Trigger Term Quality

Includes natural user phrasing like 'improve X', 'make Y better', or 'enhance Z' that users would actually say, giving good keyword coverage though a few synonyms are absent.

4 / 5

Distinctiveness Conflict Risk

Clear niche scoped to existing-feature improvement with explicit disambiguation ('For NEW features, use implement-feature skill instead'), minimizing conflict risk with sibling skills.

5 / 5

Total

18

/

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

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository
tddworks/ClaudeBar
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.