CtrlK
BlogDocsLog inGet started
Tessl Logo

trellis-break-loop

Deep bug analysis to break the fix-forget-repeat cycle. Analyzes root cause category, why fixes failed, prevention mechanisms, and captures knowledge into specs. Use after fixing a bug to prevent the same class of bugs.

62

Quality

78%

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 ./.pi/skills/trellis-break-loop/SKILL.md

The canonical home for this skill is trellis-break-loop in mindfold-ai/Trellis

SKILL.md
Quality
Evals
Security

Quality

Content

63%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 core 5-dimension analysis framework and output template are concrete and well-sequenced, and the post-analysis actions are unusually forceful and specific. The skill is dragged down by an inline generic Bayesian-reasoning section that re-teaches concepts Claude already knows and by the absence of any verification step after the mandated spec updates.

Suggestions

Move the 'Thinking Framework: Bayesian Reasoning' section (steps, confidence table, and fallacies) into a references/ file and keep a 3-5 line summary in SKILL.md, removing ~55 lines of concepts Claude already knows.

Trim the 'Core Philosophy' section to the one-line blockquote and cut the three-levels-of-insight list, which repeat ideas already stated in the description and framework.

Add a validation checkpoint to 'After Analysis: Immediate Actions' — e.g., verify the updated guide files exist and the sync to src/templates/markdown/spec/ produced changes before committing.

DimensionReasoningScore

Conciseness

The framework, category tables, and output template are efficient, but the ~55-line 'Thinking Framework: Bayesian Reasoning' section (and its 'Common Fallacies' table explaining base rate neglect, confirmation bias, and anchoring) restates reasoning concepts Claude already knows, and the 'Core Philosophy' section ('30 minutes of analysis saves 30 hours') is padding. This matches the 'mostly efficient but includes some unnecessary explanation' anchor rather than the lean anchor 4.

3 / 5

Actionability

Guidance is mostly executable for an instruction-only skill: concrete category tables, a copy-ready markdown output template with placeholder slots, and specific file paths (`.trellis/spec/guides/`, `cross-platform-thinking-guide.md`, `src/templates/markdown/spec/`). Minor gaps keep it from 5 — the Bayesian tables use unfilled placeholders with no worked example, and 'Create issue record (if applicable)' gives no command or procedure.

4 / 5

Workflow Clarity

Sequence is clear: numbered 5-dimension analysis → structured output → mandatory 'After Analysis: Immediate Actions' with explicit file targets and a sync step. Checkpoints are mostly present via the knowledge-capture checklist and P0/TODO-DONE status column, but there is no verification step (e.g., confirming the spec updates landed or that the sync succeeded) before committing, which is the minor validation gap of anchor 4.

4 / 5

Progressive Disclosure

The body is well-sectioned with headers and tables, but at ~185 lines it inlines a substantial self-contained topic (the Bayesian reasoning framework, roughly a third of the file) that is generic investigation guidance rather than post-fix analysis — content that clearly belongs in a separate reference file. This matches 'some structure but content that should be separate is inline' better than the good-structure anchor 4.

3 / 5

Total

14

/

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 in third-person voice with an explicit what-plus-when structure and a memorable signature phrase ('fix-forget-repeat cycle'). Its only weaknesses are mild: action wording is slightly abstract and a few natural trigger synonyms (postmortem, debugging retrospective) are missing.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Analyzes root cause category, why fixes failed, prevention mechanisms, and captures knowledge into specs" — which matches the anchor for several specific actions with minor gaps. It falls short of anchor 5 because the actions are somewhat abstract (e.g., 'captures knowledge into specs') and omit other capabilities the skill actually has (Bayesian hypothesis reasoning, structured output format).

4 / 5

Completeness

Both what and when are answered explicitly and concretely: what = "Analyzes root cause category, why fixes failed, prevention mechanisms, and captures knowledge into specs"; when = "Use after fixing a bug to prevent the same class of bugs." This matches the anchor-5 example structure exactly (capabilities sentence plus explicit 'Use when' trigger phrase).

5 / 5

Trigger Term Quality

Natural phrases a user would say are present — "bug", "fixing a bug", "root cause", "fix-forget-repeat cycle" — giving good keyword coverage. It misses common variations and synonyms users might say such as 'debugging', 'postmortem', 'retrospective', or 'why did this break', so it does not reach comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

The post-fix niche ("Use after fixing a bug") is distinct from debugging/fixing skills, which trigger before or during a fix. Minor overlap risk remains with general root-cause-analysis or postmortem skills, since 'Deep bug analysis' alone could plausibly fire when a user asks to analyze an unfixed bug — so not the clear-niche anchor 5.

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
mindfold-ai/Trellis
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.