CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

problem-solving

Systematic problem-solving techniques for stuck-ness. Techniques: simplification cascade (complexity spirals), collision-zone thinking (innovation blocks), meta-pattern recognition (recurring issues), inversion exercise (assumption constraints), scale game (uncertainty). Actions: simplify, analyze, recognize patterns, invert assumptions, scale thinking. Keywords: problem solving, complexity spiral, innovation block, stuck, simplification, meta-pattern, assumption inversion, scale uncertainty, breakthrough thinking, root cause, systematic analysis, Microsoft Amplifier, debugging approach, creative solution. Use when: complexity spiraling, hitting innovation blocks, seeing recurring patterns, constrained by assumptions, uncertain about scale, generally stuck on problems.

Quality

85%

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

78%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 overview for an instruction-only skill: lean technique summaries, a symptom-to-reference dispatch table, and clean one-level-deep references that all resolve to real files. Minor gaps are the redundant 'When to Use' section, the vague 'apply systematically' process step, and the absence of any worked example or validation checkpoint in the body.

Suggestions

Merge the 'When to Use' bullet list into the Quick Dispatch table to remove redundancy and save tokens.

Add one short worked example (symptom → technique → insight gained) in the body or a shared reference so the Application Process's 'apply systematically' step has a concrete model to follow.

Add an explicit verification step to the Application Process, e.g., 'Confirm the stuck-type diagnosis before loading a reference; if two techniques match, start with the one whose red flag you observed.'

DimensionReasoningScore

Conciseness

The body is lean: each technique gets only a one-line method, key insight, and red flag (e.g., "Test at extremes (1000x bigger/smaller, instant/year-long)"), with no padding explaining concepts Claude already knows. It sits at 4 rather than 5 because the 'When to Use' bullet list substantially duplicates the Quick Dispatch table, which is redundancy that could be trimmed to one section.

4 / 5

Actionability

For an instruction-only skill the guidance is mostly concrete: each technique has a specific heuristic with parameters ("Spot patterns appearing in 3+ domains", "Force unrelated concepts together"), plus diagnostic red flags ("Just need to add one more case...") that tell Claude exactly what to look for. It stops short of 5 because the Application Process steps like 'Apply systematically - Follow technique's process' are high-level, and no worked example appears in the body (details are correctly deferred to references).

4 / 5

Workflow Clarity

The Application Process is a clear five-step sequence (identify stuck-type, load reference, apply, document insights, combine if needed) fronted by a symptom-to-technique dispatch table, which is above the 3 anchor's implicit checkpoints. It is not 5 because there are no explicit validation checkpoints for whether a technique actually resolved the stuck-ness — step 4's 'Record what worked/failed' is a soft reflection step rather than a verify-then-proceed gate.

4 / 5

Progressive Disclosure

This is a textbook progressive-disclosure structure: a lean ~90-line overview with a Quick Dispatch table mapping each symptom to a specific reference file, all seven referenced files exist in ./references/, and the references are one level deep (when-stuck.md's dispatch table points to sibling technique files, not nested chains). This matches the 5 anchor's clear overview with well-signaled one-level-deep references.

5 / 5

Total

17

/

20

Passed

Description

87%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 covers what (five named techniques with actions) and when (a concrete 'Use when' clause), with comprehensive natural trigger terms. Its main weakness is broad keywords that overlap with general debugging/troubleshooting skills.

Suggestions

Narrow the generic trigger keywords (e.g., 'root cause', 'debugging approach', 'creative solution') toward phrases tied to this skill's specific techniques, such as 'simplification cascade', 'collision zone', or 'stuck on problem framing', to reduce conflict risk with debugging/troubleshooting skills.

Replace the generic action verbs ('analyze', 'recognize patterns') with more distinctive concrete actions like 'collapse duplicate implementations into one pattern' or 'test assumptions at 1000x scale'.

DimensionReasoningScore

Specificity

The description names the domain and several concrete techniques with their paired problem patterns ("simplification cascade (complexity spirals), collision-zone thinking (innovation blocks)...") plus an explicit action list ("simplify, analyze, recognize patterns, invert assumptions, scale thinking"). It falls just below the 5 anchor because the listed action verbs are somewhat generic ("analyze", "recognize patterns") compared to fully concrete actions, while clearly exceeding the 3 anchor's 1-2 actions.

4 / 5

Completeness

It explicitly answers both questions: the "what" via named techniques and actions, and the "when" via a literal "Use when: complexity spiraling, hitting innovation blocks, seeing recurring patterns, constrained by assumptions, uncertain about scale, generally stuck on problems" clause with concrete trigger phrases. This matches the 5 anchor exactly; the 4 anchor's weaker/'could be more explicit' when-clause does not apply.

5 / 5

Trigger Term Quality

The keyword list is comprehensive and natural for the domain: "problem solving, complexity spiral, innovation block, stuck, simplification, meta-pattern, assumption inversion, scale uncertainty, breakthrough thinking, root cause, systematic analysis, Microsoft Amplifier, debugging approach, creative solution" — covering synonyms and the colloquial phrases ("stuck", "root cause") a user would actually say. Not the 4 anchor since no common natural variations are obviously missing.

5 / 5

Distinctiveness Conflict Risk

The technique names ("collision-zone thinking", "scale game") are distinctive, but the trigger keywords "problem solving", "stuck", "root cause", "debugging approach", "creative solution" are broad and would overlap with debugging, root-cause-analysis, or general troubleshooting skills. It is somewhat specific but still carries overlap risk with closely related skills — the 3 anchor — rather than the mostly-distinct 4 anchor, because several keywords are not unique to this skill's niche.

3 / 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

samhvw8/dot-claude

Path

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