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

75%

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 ./skills/auto-claude-troubleshooting/SKILL.md
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 lean, highly actionable troubleshooting cookbook: nearly every issue maps to a concrete, runnable fix. Its weaknesses are missing validation checkpoints around the destructive recovery commands (which the rubric caps at 3 for workflow clarity) and a bundle layout that neither links its one reference file nor splits an unusually long body.

Suggestions

Add validation checkpoints around destructive recovery operations: verify the backup exists before resetting the memory database, confirm 'git worktree remove' and 'git branch -D' succeeded before recreating the spec, and check the build actually resumed after removing the PAUSE file.

Signal the bundle's reference content from the body — either link references/RELEASE.md where version/release issues are discussed or remove it if it does not belong in a troubleshooting skill; currently it is unreachable from SKILL.md.

Make the few remaining prose-only fixes executable: give the exact allowlist syntax/location for the security hook rejection instead of 'Add command to allowlist in security.py', and show the config edit for max_thinking_tokens instead of describing it.

DimensionReasoningScore

Conciseness

The body is almost entirely executable commands with terse inline comments ("# Increase timeout", "# Remove pause") and explains no concepts Claude already knows, so it largely assumes competence. It is not anchor 5 because of minor redundancy: the system checks in "Quick Diagnostics" (python3 --version, node --version, claude --version, git --version) are repeated nearly verbatim in "Getting Help / Gather Diagnostics".

4 / 5

Actionability

Most sections are copy-paste-ready bash tied to a specific error (e.g., "API_TIMEOUT_MS=600000 python run.py --spec 001", "git worktree remove .worktrees/auto-claude/001-feature"), covering the common cases. A few fixes remain non-executable directions — "Add command to allowlist in security.py" and "Edit agent creation to use max_thinking_tokens=3000" — which are exactly the minor gaps of anchor 4, preventing a 5 ("fully executable").

4 / 5

Workflow Clarity

Sequences exist for recovery (Restart Clean: remove spec, remove worktree, delete branch, prune, recreate; Manual Intervention: pause, edit, resume), but validation checkpoints are missing or implicit — no verification that a backup succeeded before "mv ~/.auto-claude/memories ~/.auto-claude/memories.backup", no check that the worktree was removed before retrying. Per the rubric guideline, destructive/batch operations (rm -rf .auto-claude/specs/001-feature, git branch -D, database reset) without validation cap this dimension at 3.

3 / 5

Progressive Disclosure

Section headers (Installation, Authentication, Build Failures, Workspace, Memory, QA, Debug Mode, Recovery, Performance) give real structure, but the bundle's only reference file, references/RELEASE.md, is never mentioned or linked anywhere in the body — a reference present but not clearly signaled. At ~480 lines of issue catalog, several categories (e.g., Memory System Issues, Performance Issues) could also live in separate reference files. This matches anchor 3 rather than anchor 4's "references mostly clear", and is above anchor 2 because the in-body structure is good, not minimal.

3 / 5

Total

14

/

20

Passed

Description

75%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 solid, concise description with an explicit trigger clause and a named domain. Its main limitation is that the "what" stays at the level of issue categories rather than stating what the skill actually provides (diagnostic commands, fixes, recovery procedures), and it slightly overlaps sibling setup/optimization skills.

DimensionReasoningScore

Specificity

The description lists several concrete action categories ("fixing installation issues, debugging build failures, resolving agent errors, or diagnosing performance problems") tied to a named domain ("Auto-Claude debugging and troubleshooting guide"), matching the anchor for several specific actions with minor gaps. It falls short of anchor 5 because it never states what the guide concretely provides (e.g., diagnostic commands, fixes, recovery procedures) and is not a comprehensive operation list.

4 / 5

Completeness

Both parts are present: a "what" ("Auto-Claude debugging and troubleshooting guide") and an explicit "when" ("Use when fixing installation issues, debugging build failures, resolving agent errors, or diagnosing performance problems"). It is not anchor 5 because the "what" is thin — "guide" does not specify what it delivers (diagnostics, fixes, recovery steps) — leaving the 'when' more informative than the 'what'.

4 / 5

Trigger Term Quality

It includes natural phrases users would say when hitting these problems ("installation issues", "build failures", "agent errors", "performance problems", "debugging", "troubleshooting"), giving good keyword coverage. A few natural variations are missing (e.g., "crashes", "won't start", "stuck build", "authentication/token errors"), keeping it below anchor 5.

4 / 5

Distinctiveness Conflict Risk

It is scoped to a specific tool ("Auto-Claude") with distinct problem-domain triggers, so it is mostly distinct. There is minor overlap risk with the related skills the bundle itself names (auto-claude-setup for "installation issues", auto-claude-optimization for "performance problems"), which matches anchor 4 rather than the minimal-conflict anchor 5.

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

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.