CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

auto-claude-troubleshooting

Auto-Claude debugging and troubleshooting guide. Use when fixing installation issues, debugging build failures, resolving agent errors, or diagnosing performance problems.

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 ./.claude/skills/auto-claude-troubleshooting/SKILL.md

The canonical home for this skill is auto-claude-troubleshooting in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

65%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 highly actionable, token-efficient troubleshooting catalog whose commands are mostly copy-paste ready. Its weaknesses are the missing safety/validation checkpoints around destructive recovery commands (which caps workflow clarity) and a monolithic single-file structure that ignores the available references directory.

Suggestions

Add validation or backup steps before destructive recovery commands — e.g., back up or archive spec state before `rm -rf .auto-claude/specs/001-feature` in 'Restart Clean', and verify the branch/worktree is safe before `git branch -D` and `git worktree remove --force`.

Split the issue catalog into per-category reference files (e.g., references/installation.md, references/build-issues.md, references/memory-qa.md) and keep SKILL.md as a diagnostics-first overview linking to them, instead of inlining ~480 lines.

Link the existing references/RELEASE.md from the body (it is currently orphaned) and convert vague entries such as 'Add command to allowlist in security.py' into concrete executable commands.

DimensionReasoningScore

Conciseness

The body is lean error-to-fix command blocks with almost no prose padding and no explanations of concepts Claude already knows. It is not 5 because of redundancy (e.g., `claude --version` appears in Quick Diagnostics, Check Configuration, and Getting Help; `python run.py --spec 001` repeats throughout) and near-empty sections like "Subscription Issues"; it is not 3 because there is essentially no over-explanation to trim.

4 / 5

Actionability

Nearly all entries are copy-paste-ready bash with the triggering error as a comment (e.g., "# Error: Invalid OAuth token" followed by `claude setup-token`). It is not 5 because a few entries are directional only — "Add command to allowlist in security.py", "Edit agent creation to use max_thinking_tokens=3000" — and "Subscription Issues" contains no commands; it is not 3 because the vast majority is fully executable with concrete specifics.

4 / 5

Workflow Clarity

Diagnostic sequencing is present (system requirements → verify installation → check configuration) and recovery steps are ordered (e.g., Manual Intervention 1-2-3), but destructive operations lack validation checkpoints: "Restart Clean" runs `rm -rf .auto-claude/specs/001-feature` and `git branch -D` with no backup or pre-verification, and the embedding fix deletes `~/.auto-claude/memories/embeddings` unchecked. Per the rubric's cap for destructive operations without validation, this cannot exceed 3; it is not 2 because sequences are coherent and well defined.

3 / 5

Progressive Disclosure

Clear ##/### section headers make the catalog navigable, but ~480 lines of issue-by-issue detail are inlined in SKILL.md rather than split into per-category reference files, and the one bundle file present (references/RELEASE.md) is never referenced from the body. It is not 4 because content that belongs in separate files is inline and the existing bundle reference is orphaned; it is not 2 because the internal structure is well organized, not a headerless wall of text.

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 that clearly states what the skill does and gives an explicit, concrete 'Use when...' clause covering four trigger scenarios. The main weaknesses are missing synonyms/variations in trigger terms and minor overlap risk with sibling Auto-Claude skills on generic trigger phrases.

DimensionReasoningScore

Specificity

The description lists several concrete actions across four problem areas — "fixing installation issues, debugging build failures, resolving agent errors, or diagnosing performance problems" — matching the anchor for several specific actions with minor gaps. It is not 5 because coverage omits issue categories the body actually handles (authentication, workspace/worktree, memory system, QA loops); it is not 3 because it goes well beyond naming a domain with 1-2 actions.

4 / 5

Completeness

It explicitly answers both: what ("Auto-Claude debugging and troubleshooting guide") and when ("Use when fixing installation issues, debugging build failures, resolving agent errors, or diagnosing performance problems") with concrete trigger phrases, matching the anchor-5 pattern. Not 4 because the 'when' clause is explicit and specific rather than needing more precision.

5 / 5

Trigger Term Quality

Natural user phrases like "installation issues", "build failures", "agent errors", "performance problems", "debugging", and "troubleshooting" give good keyword coverage. It is not 5 because common variations users would say are missing (e.g., "setup problems", "stuck build", "auth/token errors", "won't start"); it is not 3 because coverage is well beyond just some relevant keywords.

4 / 5

Distinctiveness Conflict Risk

The "Auto-Claude" scoping carves out a clear niche, but generic triggers like "build failures", "performance problems", and "installation issues" carry minor overlap risk with general debugging skills and the related auto-claude-setup skill. Not 5 due to that overlap with closely related skills; not 3 because the product-specific framing makes it mostly distinct.

4 / 5

Total

17

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

.claude/skills/auto-claude-troubleshooting/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.