CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

figure-it-out

Design an auditable playbook when no narrower one fits: a large migration, an ambitious multi-part change, or work a human reviews after stepping away. Scales rigor to the task, runs a hypothesis loop, and logs decisions. Use for /figure-it-out or 'figure it out'.

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

92%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.

The body is an exemplary instruction-only skill: a tightly sequenced five-phase workflow with explicit validation checkpoints and feedback loops, written in dense directive prose with zero padding. Its only gap is the absence of worked examples for key artifacts (predicate, log row) and its reliance on external sibling skills for sub-step detail.

DimensionReasoningScore

Conciseness

The body is lean, directive prose that assumes competence throughout — it never explains what a hypothesis loop, worktree, or todolist is, and lines like 'Rigor is gates and artifacts, not "try harder"' compress policy into single sentences. Matches 'lean and efficient; every token earns its place'; the only candidate for trimming is the intro sentence restating the description.

5 / 5

Actionability

Phases give concrete directives ('Open a todolist whose first item is...', 'State the hypothesis, make the smallest change, measure against the predicate', verdicts 'VERIFIED, NOT VERIFIED, or INCONCLUSIVE'), so guidance is mostly executable. Not 5 because there are no worked examples (of a falsifiable predicate, a log row, or a framing) and sub-steps delegate to external skills without local detail.

4 / 5

Workflow Clarity

A clear Start-then-Phase-A-through-E sequence with explicit validation ('verifying each unit before starting the next', 'Check the whole against the Phase A predicate on the real product') and feedback loops ('keep it if it advanced, revert it if it didn't'; harden the gate when a worker games it). Matches the top anchor; no destructive/batch cap applies.

5 / 5

Progressive Disclosure

The body is under 50 lines with well-organized sections (Start, Phases A-E) and no content that belongs in a separate file; the single file reference (../../docs/harness/claude-code.md) is one level deep and clearly signaled. Under the simple-skill guideline, well-organized sections alone merit the top score; no bundle files exist to restructure.

5 / 5

Total

19

/

20

Passed

Description

76%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.

The description clearly states what the skill does and when to use it, with an explicit trigger clause and a well-carved fallback niche. Its main weakness is thin trigger-term coverage: it relies on the skill's name and a few scenario phrases rather than the broader natural language a user would say when facing an unplaybooked task.

Suggestions

Broaden trigger terms to natural phrasings users would say for open-ended work, e.g., 'no clear approach', 'open-ended task', 'big multi-part project', or 'plan this from scratch'.

Consider adding one or two synonyms for the fallback condition (e.g., 'no existing playbook fits' or 'unstructured task') to reduce reliance on the skill name as the sole natural trigger.

DimensionReasoningScore

Specificity

Names the domain ('auditable playbook' for 'a large migration, an ambitious multi-part change') and lists several concrete actions ('Design an auditable playbook', 'runs a hypothesis loop', 'logs decisions'), matching the 'several specific actions; minor gaps' anchor. Not 5 because 'Scales rigor to the task' reads as a property rather than a tangible action; not 3 because multiple distinct actions are enumerated.

4 / 5

Completeness

Explicitly answers 'what' ('Design an auditable playbook... runs a hypothesis loop, and logs decisions') and 'when' with a concrete 'Use for /figure-it-out or \'figure it out\'' clause plus scenario triggers. Matches the anchor for both what and when with concrete trigger phrases; the missing-'Use when' cap does not apply.

5 / 5

Trigger Term Quality

Triggers include natural phrases ('figure it out', 'large migration', 'ambitious multi-part change'), but common variations a user would actually say are missing. Matches 'some relevant keywords but missing common variations or synonyms'; not 4 because coverage of natural phrasings (e.g., 'no clear plan', 'open-ended task', 'big refactor') is thin.

3 / 5

Distinctiveness Conflict Risk

The carve-out 'when no narrower one fits' plus the distinctive 'figure it out' trigger gives a mostly distinct niche with minor overlap risk against planning or migration-specific skills. Not 5 because 'large migration' and 'work a human reviews after stepping away' could still collide with related skills.

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

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

cursor/plugins

Path

harness/pstack/claude-code/skills/figure-it-out/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.