Agent skill

Trellis Break Loop

by anjiemo in anjiemo/SunnyBeach

Deep bug analysis to break the fix-forget-repeat cycle. An agent skill from anjiemo/SunnyBeach.

Apache-2.0Auto-check passedDevelopment

Install Trellis Break Loop

skills CLI
$ npx skills add anjiemo/SunnyBeach --skill trellis-break-loop -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install anjiemo/SunnyBeach trellis-break-loop --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/anjiemo/SunnyBeach.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/trellis-break-loop .claude/skills/trellis-break-loop && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
trellis-break-loop
GitHub stars
178
Used in
7 other repos
Token cost
~1.3k tokens
SKILL.md length
472 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
Apache-2.0

At a glance

Deep bug analysis to break the fix-forget-repeat cycle. An agent skill from anjiemo/SunnyBeach.

  • Works in 5 steps: Root Cause Category → Why Fixes Failed (if applicable) → Prevention Mechanisms → …
  • Tasks that involve Root cause analysis
  • SKILL.md covers Analysis Framework, Output Format, Core Philosophy and After Analysis: Immediate…
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Trellis Break Loop is an agent skill from anjiemo/SunnyBeach. 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.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Root cause analysis. The repository describes itself as: 这是一款基于 Kotlin、MVVM 和 Jetpack 构建的【阳光沙滩】社区开源Android客户端。我们的使命是让编程学习更简单,欢迎贡献!. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Root cause analysis

Example prompts

  • “/trellis-break-loop”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Root Cause Category
  2. Why Fixes Failed (if applicable)
  3. Prevention Mechanisms
  4. Systematic Expansion
  5. Knowledge Capture

What it can do on your machine

Read from SKILL.md and the folder at commit ec2bf56. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Trellis Break Loop loads about 1.3k tokens when it runs. Until then it costs about 60 tokens; SKILL.md has 472 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~60
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from anjiemo/SunnyBeach at commit ec2bf56, republished under its Apache-2.0 licence (© anjiemo). 472 words, ~1,322 tokens.

Download SKILL.mdSave it as .claude/skills/trellis-break-loop/SKILL.md (or your agent's skills folder).
name
trellis-break-loop
description
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.

Break the Loop - Deep Bug Analysis

When debug is complete, use this for deep analysis to break the "fix bug -> forget -> repeat" cycle.


Analysis Framework

Analyze the bug you just fixed from these 5 dimensions:

1. Root Cause Category

Which category does this bug belong to?

CategoryCharacteristicsExample
A. Missing SpecNo documentation on how to do itNew feature without checklist
B. Cross-Layer ContractInterface between layers unclearAPI returns different format than expected
C. Change Propagation FailureChanged one place, missed othersChanged function signature, missed call sites
D. Test Coverage GapUnit test passes, integration failsWorks alone, breaks when combined
E. Implicit AssumptionCode relies on undocumented assumptionTimestamp seconds vs milliseconds
2. Why Fixes Failed (if applicable)

If you tried multiple fixes before succeeding, analyze each failure:

  • Surface Fix: Fixed symptom, not root cause
  • Incomplete Scope: Found root cause, didn't cover all cases
  • Tool Limitation: grep missed it, type check wasn't strict
  • Mental Model: Kept looking in same layer, didn't think cross-layer
3. Prevention Mechanisms

What mechanisms would prevent this from happening again?

TypeDescriptionExample
DocumentationWrite it down so people knowUpdate thinking guide
ArchitectureMake the error impossible structurallyType-safe wrappers
Compile-timeStrict type checking, no escape hatchesSignature change causes compile error
RuntimeMonitoring, alerts, scansDetect orphan entities
Test CoverageE2E tests, integration testsVerify full flow
Code ReviewChecklist, PR template"Did you check X?"
4. Systematic Expansion

What broader problems does this bug reveal?

  • Similar Issues: Where else might this problem exist?
  • Design Flaw: Is there a fundamental architecture issue?
  • Process Flaw: Is there a development process improvement?
  • Knowledge Gap: Is the team missing some understanding?
Show full SKILL.md (193 more words)Show less
5. Knowledge Capture

Solidify insights into the system:

  • Update .trellis/spec/guides/ thinking guides
  • Update relevant .trellis/spec/ docs
  • Create issue record (if applicable)
  • Create feature ticket for root fix
  • Update check guidelines if needed

Output Format

Please output analysis in this format:

markdown
## Bug Analysis: [Short Description]

### 1. Root Cause Category
- **Category**: [A/B/C/D/E] - [Category Name]
- **Specific Cause**: [Detailed description]

### 2. Why Fixes Failed (if applicable)
1. [First attempt]: [Why it failed]
2. [Second attempt]: [Why it failed]
...

### 3. Prevention Mechanisms
| Priority | Mechanism | Specific Action | Status |
|----------|-----------|-----------------|--------|
| P0 | ... | ... | TODO/DONE |

### 4. Systematic Expansion
- **Similar Issues**: [List places with similar problems]
- **Design Improvement**: [Architecture-level suggestions]
- **Process Improvement**: [Development process suggestions]

### 5. Knowledge Capture
- [ ] [Documents to update / tickets to create]

Core Philosophy

The value of debugging is not in fixing the bug, but in making this class of bugs never happen again.

Three levels of insight:

  1. Tactical: How to fix THIS bug
  2. Strategic: How to prevent THIS CLASS of bugs
  3. Philosophical: How to expand thinking patterns

30 minutes of analysis saves 30 hours of future debugging.


After Analysis: Immediate Actions

IMPORTANT: After completing the analysis above, you MUST immediately:

  1. Update spec/guides - Don't just list TODOs, actually update the relevant files:

    • If it's a cross-platform issue → update cross-platform-thinking-guide.md
    • If it's a cross-layer issue → update cross-layer-thinking-guide.md
    • If it's a code reuse issue → update code-reuse-thinking-guide.md
    • If it's domain-specific → update backend/*.md or frontend/*.md
  2. Sync templates - After updating .trellis/spec/, sync to src/templates/markdown/spec/

  3. Commit the spec updates - This is the primary output, not just the analysis text

The analysis is worthless if it stays in chat. The value is in the updated specs.

© anjiemo, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/trellis-break-loop of anjiemo/SunnyBeach.

Open the folder on GitHubat commit ec2bf56

Used in 7 other repositories

We found 25 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 7 other GitHub owners. This page covers the copy in anjiemo/SunnyBeach, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Trellis Break Loop next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Trellis Break Loop compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Trellis Break Loop this skillanjiemo/SunnyBeach1787 repos~1.3kAutomated safety check: PassApache-2.0
AppsFlyer Unity Bridge DebuggingAppsFlyerSDK/appsflyer-unity-plugin178—~492Automated safety check: PassMIT
iOS Memgraph Leaksomarshahine/HomeClaw1761 repos~1kAutomated safety check: PassMIT
MAUI Regression Tracerdotnet/maui23k—~3.8kAutomated safety check: PassMIT
Error Diagnose FixUniClipboard/UniClipboard1.9k—~3.4kAutomated safety check: WarnAGPL-3.0
Uipath InsightsUiPath/skills167—~6.4kAutomated safety check: NotesMIT

Similar skills

  • AppsFlyer Unity Bridge Debugging

    AppsFlyerSDK/appsflyer-unity-plugin

    Traces a failing call or callback between C# and the native Android or iOS wrappers of the AppsFlyer Unity plugin to find the first broken link.

    178 GitHub stars~492 tokensUpdated 4 days ago
    DevelopmentAuto-check passed
  • iOS Memgraph Leaks

    omarshahine/HomeClaw

    Capture, inspect, compare, and root-cause iOS memory graph leaks using Apple's leaks and memgraph tools.

    176 GitHub starsUsed in 1 repo~1k tokens
    DevelopmentAuto-check passed
  • Official

    Traces a reported dotnet/maui issue back to the commit or pull request that introduced it, separating confirmed causes from likely candidates.

    23k GitHub stars~3.8k tokensUpdated today
    DevelopmentAuto-check passed
  • Error Diagnose Fix

    UniClipboard/UniClipboard

    Agent Loop for build/compilation errors: run the build yourself, collect ALL errors at once, find root causes via dependency analysis, fix in order, revert failed hypotheses, loop until green.

    1.9k GitHub stars~3.4k tokensUpdated today
    DevelopmentAuto-check: warnings
  • Uipath Insights

    UiPath/skills

    UiPath Insights monitoring via uip insights: job metrics, failure analysis, and process performance; queue totals, SLA risk, timelines, and failure drill-down; machine availability, fault ranking…

    167 GitHub stars~6.4k tokensUpdated today
    DevelopmentAuto-check: notes
  • Official

    Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.

    10k GitHub starsUsed in 9 repos~2.6k tokens
    DevelopmentAuto-check passed

More from anjiemo/SunnyBeach

  • Trellis Brainstorm

    anjiemo/SunnyBeach

    Guides collaborative requirements discovery before implementation.

    178 GitHub starsUsed in 7 repos~4k tokens
    Auto-check passed
  • Trellis Check

    anjiemo/SunnyBeach

    Comprehensive quality verification: spec compliance, lint, type-check, tests, cross-layer data flow, code reuse, and consistency checks.

    178 GitHub starsUsed in 7 repos~666 tokens
    Auto-check passed
  • Trellis Update Spec

    anjiemo/SunnyBeach

    Captures executable contracts and coding conventions into .trellis/spec/ documents.

    178 GitHub starsUsed in 7 repos~2.8k tokens
    Auto-check passed
  • Trellis Spec Bootstarp

    anjiemo/SunnyBeach

    Bootstrap project-specific Trellis coding specs with a platform-neutral single-agent workflow.

    178 GitHub starsUsed in 7 repos~740 tokens
    Auto-check passed
  • Trellis Before Dev

    anjiemo/SunnyBeach

    Discovers and injects project-specific coding guidelines from .trellis/spec/ before implementation begins.

    178 GitHub starsUsed in 8 repos~398 tokens
    Auto-check passed
  • Trellis Meta

    anjiemo/SunnyBeach

    Understand and customize the local Trellis architecture inside a user project.

    178 GitHub starsUsed in 2 repos~1.4k tokens
    Auto-check passed

Questions about Trellis Break Loop

What does Trellis Break Loop do?

Deep bug analysis to break the fix-forget-repeat cycle. An agent skill from anjiemo/SunnyBeach. Trellis Break Loop is an agent skill from anjiemo/SunnyBeach. Deep bug analysis to break the fix-forget-repeat cycle.

When should I use Trellis Break Loop?

Trellis Break Loop fits situations like: tasks that involve Root cause analysis.

How do I install Trellis Break Loop in Claude Code?

Run `npx skills add anjiemo/SunnyBeach --skill trellis-break-loop -a claude-code`. Or copy the skill folder (.agents/skills/trellis-break-loop in anjiemo/SunnyBeach) into .claude/skills/trellis-break-loop in your project. Claude Code loads it when a task matches its description.

How do I install Trellis Break Loop in Codex?

Run `npx skills add anjiemo/SunnyBeach --skill trellis-break-loop -a codex`. Or copy the skill folder (.agents/skills/trellis-break-loop in anjiemo/SunnyBeach) into .agents/skills/trellis-break-loop in your project. Codex loads it when a task matches its description.

Can I use Trellis Break Loop in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add anjiemo/SunnyBeach --skill trellis-break-loop -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/trellis-break-loop, .gemini/skills/trellis-break-loop, .github/skills/trellis-break-loop and .opencode/skills/trellis-break-loop in your project.

What does Trellis Break Loop need to run?

SKILL.md names no scripts, command-line tools or credentials: Trellis Break Loop is instructions for the agent only.

Does Trellis Break Loop access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Trellis Break Loop safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Trellis Break Loop use?

Trellis Break Loop is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Trellis Break Loop use?

About 1.3k tokens (SKILL.md is roughly 5.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Trellis Break Loop?

Skills that share tags, products or a category with Trellis Break Loop: AppsFlyer Unity Bridge Debugging (AppsFlyerSDK/appsflyer-unity-plugin, 178 stars), iOS Memgraph Leaks (omarshahine/HomeClaw, 176 stars), MAUI Regression Tracer (dotnet/maui, 23k stars) and Error Diagnose Fix (UniClipboard/UniClipboard, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Trellis Break Loop?

anjiemo (a GitHub user) maintains it in anjiemo/SunnyBeach, which has 178 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on September 11, 2026.

Source: anjiemo/SunnyBeach on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.