skills/figure-it-out/SKILL.md
Design an auditable playbook when no narrower one fits. Use for figure it out, 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 via show-me-your-work.
npx skillsauth add shipshitdev/library figure-it-outInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
When the task matches no pstack playbook, design one. The deliverable
before any code is the workflow itself. Bias toward more rigor.
Do not reinvent a playbook you already have. A focused single-unit task routes to Bug fix, Perf, Feature, Visual parity, Eval, or Multi-phase plan. A large or cross-cutting version of one belongs here.
Inputs:
Outputs:
Creates/Modifies:
show-me-your-workExternal Side Effects:
Confirmation Required:
Delegates To:
pstack principles index, architect, arena, show-me-your-workOpen a todo list whose first item is reading
skills/pstack/references/principles.md. Then add the phases below.
State a falsifiable done predicate, quantified scope, and a rigor level biased high. Present framing before a long run. Reversible work proceeds. A multi-hour run earns one checkpoint.
Decompose into independently-landable units. Sequence riskiest-unknown-first. Build the verification harness before the work, with a baseline from the pre-change state.
For one-way-door design decisions, run architect (it runs arena).
Skip it for mechanical work whose shape is already concrete.
Parallelize only across genuine seams. Give each worker its own worktree or branch. Write the designed phase list down.
Each unit is an experiment: hypothesis, smallest change, measure on the real artifact, keep or revert. Verify each unit before the next. A verdict is VERIFIED, NOT VERIFIED, or INCONCLUSIVE. Inconclusive is not a pass.
Log via show-me-your-work. Commit the trail when a reviewer needs it
to trust the result.
Check the whole against the Phase A predicate on the real product. Encode a recurring correction as a gate, lint, check, or script.
Reply: the playbook you designed, the rigor level and why, the trail path, what's verified, what's still open.
development
Coordinates a weekly engineering review of board accuracy, recent code changes, operational health, and scoped cleanup. Use for a recurring repository health review or a review of the last several days.
testing
Audits project board configuration and prepares explicitly requested setup, copy, or normalization changes while preserving the existing workflow and provider boundaries. Use when inspecting a board's fields, columns, scope, or configuration.
testing
Reconciles a project board with current work and delivery evidence, reports incomplete coverage and metadata gaps, and applies only approved provider-supported field changes. Use when auditing board drift, reviewing blocked work, or assessing upcoming delivery.
development
Walk through how a subsystem works. Use for "how does X work", code walkthroughs before changing something, and placement or ownership questions. Explains architecture, runtime flow, and onboarding mental models. Can critique architecture. Use why for motivation.