CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

solve-problem

This skill should be used when the user says "solve problem", "solve this problem", or invokes /solve-problem. Applies a methodical, evidence-first approach to diagnosing a problem - understand intent, observe the problem first-hand, form multiple hypotheses, gather discriminating evidence to eliminate them, propose an evidenced solution, and verify the fix actually resolves the original symptom. Do NOT use for general how-to questions, explanations, or building new features.

Quality

88%

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

85%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 method skill: the six moves are clearly sequenced with validation checkpoints, explicit feedback loops on failure, and a concrete output template, while worked examples are appropriately deferred to real, well-labeled reference files. The main costs are mild redundancy between the moves and the anti-rush rules and some abstract directives that would benefit from a concrete illustration inline.

DimensionReasoningScore

Conciseness

The body is efficient and assumes competence — no basic-concept padding — but the anti-rush rules restate constraints already established in the moves ("At least two hypotheses before testing any" repeats move 3; "Not solved until re-observed gone" repeats move 6), so minor trimming is possible, fitting the 4 anchor rather than "every token earns its place".

4 / 5

Actionability

Guidance is concrete and executable for an instruction-only skill: numeric thresholds ("at least two" hypotheses), a falsification-oriented evidence rule, a default stop point ("Propose — do not implement — unless the user asks"), and a copy-paste-ready output template. It stays at 4 rather than 5 because some inherently abstract directives ("escalate to direct observation with more instrumentation") lack concrete examples of what to do, and no worked example is inline.

4 / 5

Workflow Clarity

The six moves are clearly sequenced with explicit validation checkpoints (move 2 confirms the problem is real before cause-hunting; move 6 re-verifies the symptom under the original conditions) and genuine feedback loops for error recovery ("If the symptom persists... return to move 2 with more instrumentation"), plus a checklist-style anti-rush rules section — matching the 5 anchor's "explicit validation steps; feedback loops; checklists".

5 / 5

Progressive Disclosure

The body keeps the core method while offloading heavy end-to-end traces to references, which are one level deep, clearly signaled ("Read one when you are stuck and want a model to follow"), described by content, and both link targets exist as real files in references/. This matches the 5 anchor's clear overview with well-signaled one-level-deep references.

5 / 5

Total

18

/

20

Passed

Description

88%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 explicitly answers what (the six-move evidence-first diagnostic method) and when (concrete user phrases plus a slash command and negative scope). The only gap is trigger coverage: natural synonyms like "debug", "troubleshoot", or "diagnose" are missing, which slightly limits discoverability and distinctiveness from adjacent debugging skills.

DimensionReasoningScore

Specificity

The description enumerates the full method concretely: "understand intent, observe the problem first-hand, form multiple hypotheses, gather discriminating evidence to eliminate them, propose an evidenced solution, and verify the fix actually resolves the original symptom" — multiple specific actions with comprehensive coverage of the workflow.

5 / 5

Completeness

Both what and when are explicitly answered: the what is the enumerated evidence-first method, and the when is stated with concrete trigger phrases ("when the user says 'solve problem'... or invokes /solve-problem") plus explicit negative scope ("Do NOT use for general how-to questions, explanations, or building new features").

5 / 5

Trigger Term Quality

Triggers are natural phrases a user would say ("solve problem", "solve this problem", "/solve-problem"), but common synonyms like "debug this", "troubleshoot", "why is X broken", or "diagnose" are absent — a few natural terms are missing, matching the 4 anchor rather than the comprehensive synonym coverage of 5.

4 / 5

Distinctiveness Conflict Risk

The explicit exclusion clause distinguishes it from adjacent Q&A and feature-building skills, but the domain-neutral framing ("diagnosing a problem") leaves minor overlap risk with closely related debugging or code-review skills, fitting "mostly distinct; minor overlap risk".

4 / 5

Total

18

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository

dwmkerr/claude-toolkit

Path

plugins/toolkit/skills/solve-problem/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.