Agent skill · Testing & QA

plan-compass

Stress-tests a plan through dependency-aware, easy-to-answer decision prompts. Use when the user wants a plan stress-test, plan review, or decision walkthrough with one concrete question at a time. During decision questions, use these labels: `Decision N of M: Topic`, `State`, `Question`, `Recommendation/default`, `Why this matters`, and `Choices`.

softcanegithub.com/softcaneGitHub ↗
claude-codecodexMIT
Install
npx skills add softcane/human-state-skills --skill plan-compass --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 1
SKILL.md size: 4 KB
Bundled scripts: none
Path: skills/plan-compass/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 85
Language: JavaScript

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# Plan Compass Stress-test the user's plan without creating an exhausting interrogation. ## Core Loop Before the first question, map the smallest useful decision tree internally. Separate discoverable facts from user-owned decisions. Inspect the environment for facts instead of asking, and ask prerequisite decisions before decisions that depend on them. During the decision phase, ask exactly one decision question at a time. Each question must include: 1. The progress label. 2. A compact state line. 3. The question. 4. Your recommended choice, which is also the default. 5. Why this matters in one sentence. 6. Two or three concrete answer choices. Use this shape: ```text Decision 2 of 6: Data ownership State: Locked: offline storage · Now: ownership · About 4 decisions remain Question: Who owns the saved draft? Recommendation/default: A — The user owns the draft. Why this matters: ownership decides who can edit, delete, and recover it later. Choices: - A: User owns it. - B: Team owns it. - C: Project owns it. ``` ## Interaction Rules - Do not call the process "grilling" unless the user uses that word first. - Keep questions short and specific. - Do not ask broad open-ended questions

What's inside
Steps it walks through
  1. Core Loop
  2. Interaction Rules
  3. Progress Format
  4. Undecided Sweep
  5. Confirmation Gate
  6. Stop Conditions
More from human-state-skills
All skills →
About this skill
What does the plan-compass skill do?

Stress-tests a plan through dependency-aware, easy-to-answer decision prompts. Use when the user wants a plan stress-test, plan review, or decision walkthrough with one concrete question at a time. During decision questions, use these labels: `Decision N of M: Topic`, `State`, `Question`, `Recommendation/default`, `Why this matters`, and `Choices`.

How do I install it?

Run `npx skills add softcane/human-state-skills --skill plan-compass --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From softcane/human-state-skills, a repository with 85 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going