About

Imported from shipshitdev/skills (skills/figure-it-out/SKILL.md). Install upstream with npx skills add shipshitdev/skills --skill figure-it-out. Copyright stays with the author (MIT).

Figure it out

Name: figure-it-out
Author: shipshitdev

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.

Authorized Scope

Apply this engine only within the user's requested task and existing explicit authorization. Loading or delegating to it grants no additional authority. Preserve report-only restrictions and the caller's target, host, provider, and cost limits. Existing approval satisfies a gate only for the same actions and scope; obtain approval before expanding them. Forward these limits to delegates.

Contract

Inputs:

A large, cross-cutting, or unattended task with no narrower playbook

Outputs:

A designed phase list, a rigor level, a decision trail, and verification against a falsifiable predicate

Creates/Modifies:

The work the designed playbook authorizes
A decision log via show-me-your-work

External Side Effects:

Whatever the designed playbook later requires

Confirmation Required:

One checkpoint before a multi-hour run

Delegates To:

File pointer: references/principles.md from the selected pstack skill directory
architect, arena, show-me-your-work for authorized investigation

Start

Open a todo list whose first item is reading references/principles.md from the selected pstack skill directory. Then add the phases below.

Phase A: Frame

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.

Phase B: Design the workflow

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.

Phase C: Run the loop

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.

Phase D: Keep the audit trail

Log via show-me-your-work. Commit the trail when a reviewer needs it to trust the result.

Phase E: Verify and hand back

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.

Figure It Out procedure

Read figure-it-out procedure when running this workflow. Apply the authorized scope and mode of this entry point to every step. Resolve other skills through this distribution’s active catalog; resolve resources relative to the installed skill directory.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/shipshitdev-skills-figure-it-out/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

shipshitdev-skills-figure-it-out.ocm.jsonjson

{
  "ocm": "1",
  "id": "shipshitdev-skills-figure-it-out",
  "kind": "skill",
  "name": "figure-it-out",
  "description": "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.",
  "publisher": "shipshitdev",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "playbook",
      "migration",
      "audit",
      "hypothesis",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "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."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/shipshitdev/skills",
      "path": "skills/figure-it-out/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/shipshitdev/skills/blob/HEAD/skills/figure-it-out/SKILL.md",
      "key": "shipshitdev/skills/skills/figure-it-out/SKILL.md"
    },
    "license": "MIT"
  },
  "instructions": "# Figure it out\n\nWhen the task matches no `pstack` playbook, design one. The deliverable\nbefore any code is the workflow itself. Bias toward more rigor.\n\nDo not reinvent a playbook you already have. A focused single-unit task\nroutes to Bug fix, Perf, Feature, Visual parity, Eval, or Multi-phase\nplan. A large or cross-cutting version of one belongs here.\n\n## Authorized Scope\n\nApply this engine only within the user's requested task and existing explicit\nauthorization. Loading or delegating to it grants no additional authority.\nPreserve report-only restrictions and the caller's target, host, prov",
  "cost": {
    "context_tokens": 799
  }
}

Fetch it by URL: GET /api/v1/registry/shipshitdev-skills-figure-it-out/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.