troubleshooting-app

troubleshooting-app is a skill for Claude Code from wayne930242/straw-boss. It costs 48 tokens per session (823 once invoked), scanned A, original, MIT.

A troubleshooting workflow for finding and fixing failures in managed applications. It first identifies the affected application, then determines whether the cause is in the app code, infrastructure, configuration, data, or another connected service.

In plain words
What is it for?
Use it when something is broken and the cause is unknown, especially when multiple applications or infrastructure components may be involved. It is also used to prepare evidence for later work between connected services.
Why use it?
It gives a defined path for investigating failures that cross application or service boundaries, instead of stopping at a diagnosis.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the straw-boss plugin — 17 skills, 2 hooks shipped together

Good fit Use it when something is broken and the cause is unknown, especially when multiple applications or infrastructure components may be involved. It is also used to prepare evidence for later work between connected services.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/wayne930242/straw-boss/troubleshooting-app
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add wayne930242/straw-boss --skill troubleshooting-app
Clone the repo
git clone --depth 1 https://github.com/wayne930242/straw-boss

Made for: Claude Code.

Or install straw-boss, the plugin that ships this one along with the rest of its 17 skills, 2 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for troubleshooting-app

README.md
[![agentmods](https://agentmods.dev/badge/skills/wayne930242/straw-boss/troubleshooting-app/github.svg)](https://agentmods.dev/skills/wayne930242/straw-boss/troubleshooting-app)
Your own site
<a href="https://agentmods.dev/skills/wayne930242/straw-boss/troubleshooting-app"><img src="https://agentmods.dev/badge/skills/wayne930242/straw-boss/troubleshooting-app/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for troubleshooting-app

Your own site · 80×15
<a href="https://agentmods.dev/skills/wayne930242/straw-boss/troubleshooting-app"><img src="https://agentmods.dev/badge/skills/wayne930242/straw-boss/troubleshooting-app.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 48 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 823 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00048 $0.00823
Opus 5 $0.00024 $0.00411
Sonnet 5 $0.00010 $0.00165
Haiku 4.5 $0.00005 $0.00082

Measured 8d ago against content hash 15c70eea0400, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

troubleshooting-app scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/troubleshooting-app/SKILL.md · 58 lines

How it starts

The opening of the file, as written. The whole thing — 58 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Overview

See docs/roles.md for the cast of characters and the authority framework this skill operates under — not redefined here.

A reported failure is expected to end fixed, not merely explained. Diagnosis and repair stay in one shipping-task single-loop so the same agent preserves the evidence and context it discovers.

An integration preflight is useful only when both conditions hold: the failure crosses an integration boundary, and its explanatory conclusion is needed to shape or schedule later dispatches. It supplies evidence-backed coordination input. A symptom that one resolved app can diagnose and repair stays in the same worker.

The fix runs through shipping-task's git lifecycle and mode decision.

When the continuous loop locates the cause in data, configuration, infrastructure, or another app, its root-cause account and evidence supply the next route.

Task 1: Resolve the app

Invoke work-on now. Even for a live incident, you need the target app before digging in.

Verification: the target app is established before Task 2.

Task 2: App-code or infrastructure?

Classify from evidence the user already supplied. Symptoms such as environment-only failure, failure without an app change, or an unexplained server response can point to infrastructure.

  • Clearly infrastructure: hand off to the project's infrastructure/ops owner with the supplied evidence.
  • App-level or uncertain: continue to Task 3 so the target-app loop can distinguish an app cause from an external dependency.

Verification: the classification cites supplied evidence and uncertainty continues to the target-app loop.

Task 3: Choose the continuous or preflight branch

Use an integration preflight only when the supplied evidence already shows the integration boundary and the later routing decision it must enable. Run it through dispatching-work in the resolved app and require an explanatory, falsifiable root-cause account with evidence references to logs, tests, commands, files, or artifacts. Its reality anchor is an independent agent's adversarial review of the account.

Read the full file on GitHub · 58 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 58 lines · 48 tokens per session scan A 15c70eea0400

Subscribe to this mod's changes

troubleshooting-app is a skill published in the GitHub repository wayne930242/straw-boss (3 stars, last pushed yesterday), licensed MIT. It adds 48 tokens to every session and 823 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

issue-analyze

GitHub Issue and PR review thread deep analysis with Codex blind verdict. Use when: analyzing issue root cause, classifying problems, investigation planning, triaging PR review comments for actionability. Not for: fixing bugs (use bug-fix), code exploration (use code-explore). Output: classified analysis + verdict…

sd0xdev/sd0x-harness · 73 tokens

debug

Interactive debugging workflow with hypothesis-driven probe loop. Use when: unknown bugs, script errors, silent failures, troubleshooting. Not for: known bugs (use bug-fix), GitHub issue analysis (use issue-analyze), code understanding (use code-explore). Output: debug report with probe journal + root cause + fix.

sd0xdev/sd0x-harness · 67 tokens

code-explore

Pure Claude code investigation. Use when: tracing execution paths, understanding architecture, diagnosing issues. Not for: dual-perspective review (use code-investigate), code review (use codex-code-review). Output: analysis report with findings.

sd0xdev/sd0x-harness · 51 tokens

code-investigate

Dual-perspective code investigation. Use when: deep code analysis needing both Claude and Codex perspectives. Not for: quick exploration (use code-explore), code review (use codex-code-review). Output: integrated findings from dual analysis.

sd0xdev/sd0x-harness · 52 tokens

bug-fix

Bug fix workflow. Use when: fixing bugs, resolving issues, regression fixes. Not for: new features (use feature-dev), understanding code (use code-explore). Output: fix + regression test + review gate.

sd0xdev/sd0x-harness · 48 tokens

git-investigate

Git history investigation. Use when: tracking code changes, finding where bugs were introduced, root cause analysis. Not for: code exploration (use code-explore), issue analysis (use issue-analyze). Output: history trace + root cause report.

sd0xdev/sd0x-harness · 53 tokens