CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

troubleshooting

Triage router for all Luzmo problems. Use first whenever anything is broken, not working, or behaving unexpectedly. Triggers on: "not working", "broken", "why is X failing", "debug", chart "0 height", "chart not loading", "wrong data showing", API errors. Diagnoses root cause by symptom and routes to the right implementation skill. Does NOT implement fixes. Use this skill first - even if you think you know the fix - for any Luzmo error, rendering failure, data anomaly, or unexpected behavior.

68

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

75%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 well-structured triage router: symptom tables are dense and highly actionable with exact error strings and route targets, and the security-first checkpoint with explicit STOP is a genuine validation step. The main costs are redundancy — the Hand Off section and CORS prose duplicate the tables and cited reference files — and a top-level workflow that must be inferred rather than followed as an explicit sequence.

Suggestions

Merge the 'Hand Off' WHEN-list into the per-symptom route tables (or replace the tables' Route To column with it) — the two currently state the same routing twice, which is the largest source of avoidable tokens.

Trim the CORS section to symptom + root cause + pointer to 'core/references/local-development-proxy.md' and the CNAME/support path, moving the proxy and appServer configuration detail into the referenced file instead of restating it inline.

Cut or compress generic advice in 'Still Stuck?' (e.g. 'Read error messages carefully', 'Check for recent changes', 'Isolate the issue') that Claude already knows, keeping only the support-contact specifics.

DimensionReasoningScore

Conciseness

Mostly dense, scannable tables, but there is noticeable duplication and padding: the 'Hand Off' WHEN-list re-states routes already given in every symptom table, the CORS section inlines the full proxy/CNAME recipe while simultaneously pointing to 'core/references/local-development-proxy.md', and 'Still Stuck?' offers generic advice Claude already knows ('Read error messages carefully', 'Isolate the issue'). This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' better than the leaner anchors.

3 / 5

Actionability

Every symptom row gives a specific fix direction and target skill; exact error strings ('Action 'search' not found', 'Invalid localized string', 'no access to the analytics dataset'), exact env vars, exact paths ('proxy root paths /0.1.0 and /realtime'), exact support contact, and 10 concrete checklist items. As an instruction-only skill the guidance is fully actionable and covers the common cases.

5 / 5

Workflow Clarity

Strong checkpoints exist — the 'Security Checkpoint (First Diagnostic)' with an explicit STOP condition, the Emergency Debugging Checklist, and explicit WHEN escalation rules. Not a 5 because the top-level flow is not explicitly sequenced: 'Doc Retrieval' and 'Bundled References' sections appear before the 'First Diagnostic' checkpoint without stated placement, and the reader must infer the overall triage flow (checkpoint → symptom match → questions → route) from section conventions rather than an explicit step sequence.

4 / 5

Progressive Disclosure

Both bundle files (references/diagnostic-workflows.md, references/error-codes.md) exist and are clearly signaled with one-line purpose descriptions under 'Bundled References', one level deep, and the 'Canonical Sources' section defers spec content to developer.luzmo.com rather than duplicating. Not a 5 because the CORS section inlines implementation detail that already lives in the cited core reference file, so content splitting is only mostly appropriate.

4 / 5

Total

16

/

20

Passed

Description

91%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: explicit what and when, natural trigger terms with synonyms, and clear router positioning with a well-defined boundary ('Does NOT implement fixes'). Slight deductions for not enumerating the symptom categories it routes on and for generic trigger terms that carry minor conflict risk outside the Luzmo context.

DimensionReasoningScore

Specificity

Concrete actions are explicitly stated: 'Triage router for all Luzmo problems', 'Diagnoses root cause by symptom and routes to the right implementation skill', 'Does NOT implement fixes'. Not a 5 because the action list is thin relative to the symptom breadth it claims ('rendering failure, data anomaly, API errors') — the specific symptom categories it triages on are not enumerated, leaving minor coverage gaps.

4 / 5

Completeness

Both 'what' and 'when' are explicit with concrete trigger phrases: what — 'Diagnoses root cause by symptom and routes to the right implementation skill. Does NOT implement fixes'; when — 'Use first whenever anything is broken... Use this skill first - even if you think you know the fix - for any Luzmo error, rendering failure, data anomaly, or unexpected behavior.' The forced-first-usage guidance is unusually explicit.

5 / 5

Trigger Term Quality

Triggers on natural user phrasing with good synonym coverage: 'not working', 'broken', 'why is X failing', 'debug', chart '0 height', 'chart not loading', 'wrong data showing', API errors, plus 'rendering failure, data anomaly, or unexpected behavior'. These are phrases a user would naturally say when they need this skill.

5 / 5

Distinctiveness Conflict Risk

The Luzmo branding and explicit router role ('Does NOT implement fixes') give it a clear niche, but the generic trigger terms ('broken', 'not working', 'debug') carry minor overlap risk with general debugging skills outside the Luzmo ecosystem, and as a router for 'all Luzmo problems' it intentionally overlaps every sibling Luzmo skill — mitigated but not eliminated by the explicit first-use framing.

4 / 5

Total

18

/

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

luzmo-official/agent-skills

Path

skills/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.