CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

fix-bug

Guide for fixing bugs in ClaudeBar following Chicago School TDD and rich domain design. Use this skill when: (1) User reports a bug or unexpected behavior (2) Fixing a defect in existing functionality (3) User asks "fix this bug" or "this doesn't work correctly" (4) Correcting behavior that violates the user's mental model

64

Quality

80%

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 ./.claude/skills/fix-bug/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

73%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 strong, concrete bug-fixing workflow with excellent TDD sequencing and validation checkpoints. The main costs are the decorative ASCII workflow diagram, two comment-only Swift blocks that add bulk without executable guidance, and reliance on a sibling skill's bundle for supporting material.

Suggestions

Replace the ~27-line ASCII box diagram with a one-line flow (Reproduce → Red → Green); the phase headings already carry the same information.

Delete the comment-only "Domain Invariants" block or make it concrete — e.g. name the actual invariants (selectedProviderId always points to an enabled provider) as checkable statements.

Convert the "Domain Design Principles" comment-only Swift snippet into a compact rule list (validate on construction; private invariant maintenance; no external ensure calls) to save tokens and match the surrounding prose style.

DimensionReasoningScore

Conciseness

The body is dense and project-specific (e.g. "The log: ~/Library/Logs/ClaudeBar/ClaudeBar.log", "tuist test Providers"), but the ~27-line ASCII box diagram merely restates the three phase headings that follow it, and the "Domain Invariants" section is a comment-only Swift block ("// Example: QuotaMonitor should maintain selection invariants") with no content. This is more trimmable material than the "minor instances" of anchor 4, but far from the padding of anchor 2.

3 / 5

Actionability

Mostly copy-paste ready: a complete Swift test template with a real fixture (stub.answerRPC feeding a captured rateLimits response), exact commands ("xcodebuild test -workspace ClaudeBar.xcworkspace -scheme ClaudeBar-Workspace -destination 'platform=macOS,arch=arm64'"), specific fields ("account.lastFailedStep"), and named test modules. Not a 5 because the Domain Invariants block and the "Domain Design Principles" block are comment-only pseudo-structure offering no executable guidance — minor gaps against anchor 5's "fully executable".

4 / 5

Workflow Clarity

A clear three-phase Red/Green sequence ("Reproduce & Understand" → "Write Failing Test (Red)" → "Fix & Verify (Green)") with explicit validation checkpoints at every phase: "Test should FAIL before fix", "Test now PASSES", "All existing tests still pass", the full xcodebuild run, and a closing checklist. This matches anchor 5's explicit validation steps plus checklist; anchor 4 would require some implicit checkpoint, which is not the case here.

5 / 5

Progressive Disclosure

Well-signaled, one-level-deep references throughout ("[Naming tests](../implement-feature/references/tdd-patterns.md#naming-tests)", "[MODULAR_DESIGN.md](../../../docs/architecture/MODULAR_DESIGN.md)", "[domain-shape.md](../implement-feature/references/domain-shape.md)"), and the core workflow is appropriately kept inline. Not a 5: the skill ships no bundle of its own and leans on a sibling skill's reference files and repo docs for core material, and the inlined ASCII diagram duplicates what headers already say — minor organization gaps per anchor 4.

4 / 5

Total

16

/

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 well-formed description with an explicit, well-enumerated trigger list and quoted user phrasing — exactly the pattern the rubric rewards. Its only real gap is that the capability side compresses to a single action (fix bugs), and common bug-report synonyms are not covered.

DimensionReasoningScore

Specificity

It names the domain and essentially one concrete action — "Guide for fixing bugs in ClaudeBar following Chicago School TDD and rich domain design" — with the remaining clauses ("Fixing a defect", "Correcting behavior") restating that same action. Anchor 3 ("names domain and 1-2 concrete actions, but not comprehensive") fits; anchor 4 requires several distinct listed actions, which this does not have.

3 / 5

Completeness

Explicitly answers both parts: the "what" ("Guide for fixing bugs in ClaudeBar following Chicago School TDD and rich domain design") and a dedicated "Use this skill when:" clause enumerating four concrete trigger situations with quoted user phrasing. This is a direct match for anchor 5; anchor 4's weaker "when" does not apply.

5 / 5

Trigger Term Quality

Good natural coverage including direct user quotes ("fix this bug", "this doesn't work correctly") and phrases like "reports a bug", "unexpected behavior", "violates the user's mental model". Not a 5: common variations users actually say — "broken", "crash", "error", "regression" — are missing, which is exactly anchor 4's "a few natural terms missing".

4 / 5

Distinctiveness Conflict Risk

The ClaudeBar scope plus the explicit TDD framing carves a clear niche distinct from feature implementation. Not a 5: triggers like "User reports a bug or unexpected behavior" and "this doesn't work correctly" would equally claim a general debugging/troubleshooting skill, leaving minor overlap risk per anchor 4.

4 / 5

Total

16

/

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 10 suspicious

Warning

Total

15

/

16

Passed

Repository

tddworks/ClaudeBar

Path

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