Writing Livekit Scenarios
livekit-examples/agent-starter-python
Creates and maintains the scenarios a LiveKit agent simulation runs, and wires the agent to consume them.
Stress-tests a plan through dependency-aware, easy-to-answer decision prompts.
Install Plan Compass
$ npx skills add softcane/human-state-skills --skill plan-compass -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install softcane/human-state-skills plan-compass --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/softcane/human-state-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/plan-compass .claude/skills/plan-compass && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "plan-compass" agent skill from https://github.com/softcane/human-state-skills/tree/main/skills/plan-compass into .claude/skills/plan-compass/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "plan-compass", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/softcane/human-state-skills/tree/main/skills/plan-compassType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add softcane/human-state-skills --skill plan-compass -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install softcane/human-state-skills plan-compass --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/softcane/human-state-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/plan-compass .agents/skills/plan-compass && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "plan-compass" agent skill from https://github.com/softcane/human-state-skills/tree/main/skills/plan-compass into .agents/skills/plan-compass/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "plan-compass", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add softcane/human-state-skills --skill plan-compass -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install softcane/human-state-skills plan-compass --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/softcane/human-state-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/plan-compass .cursor/skills/plan-compass && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "plan-compass" agent skill from https://github.com/softcane/human-state-skills/tree/main/skills/plan-compass into .cursor/skills/plan-compass/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "plan-compass", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/softcane/human-state-skills.git --path skills/plan-compass--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add softcane/human-state-skills --skill plan-compass -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install softcane/human-state-skills plan-compass --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/softcane/human-state-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/plan-compass .gemini/skills/plan-compass && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "plan-compass" agent skill from https://github.com/softcane/human-state-skills/tree/main/skills/plan-compass into .gemini/skills/plan-compass/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "plan-compass", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install softcane/human-state-skills plan-compassInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add softcane/human-state-skills --skill plan-compass -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/softcane/human-state-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/plan-compass .github/skills/plan-compass && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "plan-compass" agent skill from https://github.com/softcane/human-state-skills/tree/main/skills/plan-compass into .github/skills/plan-compass/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "plan-compass", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add softcane/human-state-skills --skill plan-compass -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install softcane/human-state-skills plan-compass --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/softcane/human-state-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/plan-compass .opencode/skills/plan-compass && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "plan-compass" agent skill from https://github.com/softcane/human-state-skills/tree/main/skills/plan-compass into .opencode/skills/plan-compass/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "plan-compass", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
plan-compass- GitHub stars
- 116
- Token cost
- ~1.1k tokens
- SKILL.md length
- 580 words
- Files
- 1
- Skills in repo
- 5
- Repo updated
- First seen
- Licence
- MIT
At a glance
Stress-tests a plan through dependency-aware, easy-to-answer decision prompts.
- Works in 6 steps: The progress label. → A compact state line. → The question. → …
- The user wants a plan stress-test
- SKILL.md covers Core Loop, Interaction Rules, Progress Format and Undecided Sweep, plus 2 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Plan Compass is an agent skill from softcane/human-state-skills. 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.
Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Testing & QA, covering Load testing. The repository describes itself as: Small response modes for AI agents when your head is in a different state. The licence is MIT.
When your agent uses it
- The user wants a plan stress-test
- Decision walkthrough with one concrete question at a time
Example prompts
- “/plan-compass”
Workflow steps
6 steps, taken from the first numbered list in SKILL.md.
- The progress label.
- A compact state line.
- The question.
- Your recommended choice, which is also the default.
- Why this matters in one sentence.
- Two or three concrete answer choices.
What it can do on your machine
Read from SKILL.md and the folder at commit ba5914d. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Plan Compass loads about 1.1k tokens when it runs. Until then it costs about 91 tokens; SKILL.md has 580 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from softcane/human-state-skills at commit ba5914d, republished under its MIT licence (© softcane). 580 words, ~1,144 tokens.
Download SKILL.mdSave it as
.claude/skills/plan-compass/SKILL.md (or your agent's skills folder).- name
- plan-compass
- description
- 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`.
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:
- The progress label.
- A compact state line.
- The question.
- Your recommended choice, which is also the default.
- Why this matters in one sentence.
- Two or three concrete answer choices.
Use this shape:
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 unless unavoidable.
- Do not ask multiple questions in one response.
- Do not require the user to hold previous answers in memory.
- Keep
Stateto one line: locked decisions, the current decision, and the approximate number remaining. Summarize older decisions rather than letting the line grow. - Prefer examples over abstract categories.
- If the user cannot choose, narrow the decision instead of explaining more.
- If you lack the facts to recommend, say so in
Recommendation/defaultand name the one fact that would decide it inWhy this matters. - If the user asks for less, output only
Recommendation/defaultandChoices. This is an explicit exception to the normal question format. - Keep tangents in a private parking lot. Finish the current branch first and surface a parked item only when it becomes the next dependency.
- Make progress visible without praise or gamification.
Progress Format
Use this format:
Decision 2 of 6: Data ownershipChoose the total decision count conservatively. Prefer 4 to 6 decisions for a normal plan. Use fewer when the user asks for a shorter pass. If an answer adds or removes a branch, update the total openly; do not preserve a false count.
Undecided Sweep
Run this sweep before every ending, whether the walkthrough reaches the confirmation gate or pauses.
Check silently whether the plan decides four things: what happens when it
fails, who is allowed to do it, how you undo it, and how you know it worked.
List any that are undecided under Open. Do not turn the sweep into extra
questions.
Show full SKILL.md (205 more words)Show less
Confirmation Gate
When the decisions are sufficient, run the undecided sweep, stop asking decision questions, and show only:
Plan ready for confirmationDecisions locked: the agreed decisions in no more than five bullets.Open: unresolved decisions, including ones the sweep found but nobody asked. UseNoneonly when the sweep found nothing.Next action: exactly one small, atomic next action.Confirmation: ask the user to approve the summary or name one change.
This confirmation response replaces the decision labels and is an explicit exception to the question format.
Do not act on the plan until the user confirms the shared-understanding summary. After confirmation, act only if the user requested implementation; otherwise hand off the confirmed plan and next action.
Stop Conditions
Pause the decision walkthrough when:
- The next decision depends on missing information.
- The user asks to pause, stop, or end the walkthrough.
When pausing, run the undecided sweep and summarize only:
- Decisions made.
- Open decisions, including ones the sweep found but nobody asked. Use
Noneonly when the sweep found nothing. - One small, atomic next action.
Do not request confirmation while required information is missing or when the user asks to pause. Preserve the state so the next turn can resume from one decision.
© softcane, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/plan-compass of softcane/human-state-skills.
Open the folder on GitHubat commit ba5914d
Compare with similar skills
Plan Compass next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Plan Compass this skillsoftcane/human-state-skills | 116 | — | ~1.1k | Automated safety check: Pass | MIT | |
| Writing Livekit Scenarioslivekit-examples/agent-starter-python | 264 | 1 repos | ~2.5k | Automated safety check: Pass | MIT | |
| Go Testingcxuu/golang-skills | 170 | 1 repos | ~1.3k | Automated safety check: Pass | Apache-2.0 | |
| Goalcraftgrp06/goalcraft | 102 | — | ~3.8k | Automated safety check: Pass | MIT | |
| Thinking Partnermattnowdev/thinking-partner | 206 | — | ~4.4k | Automated safety check: Pass | MIT | |
| Visionkunchenguid/vision | 329 | — | ~2.9k | Automated safety check: Pass | MIT |
Similar skills
Go Testing
cxuu/golang-skills
A skill your agent uses when writing, reviewing, or improving Go test code — including table-driven tests, subtests, parallel tests, test helpers, test doubles, and assertions with cmp.Diff.
Goalcraft
grp06/goalcraft
Turn a rough draft, vague ambition, or messy task brief into a powerful Codex /goal objective for persistent, evidence-checked work.
Thinking Partner
mattnowdev/thinking-partner
A deterministic thinking partner that challenges assumptions and applies mental models to sharpen decisions, solve problems, and think more clearly.
Vision
kunchenguid/vision
Draft and stress-test a VISION.md for a repository, then iterate with the author on an interactive review board until approved.
Volt Load Testing
owenHochwald/volt
Safely exercise and evaluate HTTP APIs with the Volt CLI, including authenticated requests, JSON bodies, staged load, machine-readable results, performance baselines, and before/after comparisons.
More from softcane/human-state-skills
Overloaded Mode
softcane/human-state-skills
A skill your agent uses when the user asks for overloaded-mode or burnout-mode, describes burnout or being burned out, or is overwhelmed, frozen, overcommitted, burnout-adjacent, or unable to decide…
Reality Check Mode
softcane/human-state-skills
A skill your agent uses for grounding or AI-loop escalation when the user treats ordinary artifacts, numbers, phrases, coincidences, symbols, model wording, or AI behavior as hidden, personal…
Foggy Mode
softcane/human-state-skills
A skill your agent uses when the user asks for foggy-mode or brain-fog-mode, or has low working memory, brain fog, fatigue, sleep debt, illness, recovery state, or cognitive depletion.
Normal Mode
softcane/human-state-skills
A skill your agent uses when the user wants to stop any active human-state response mode and return to the assistant's normal response style.
Related
Categories
Questions about Plan Compass
What does Plan Compass do?
Stress-tests a plan through dependency-aware, easy-to-answer decision prompts. Plan Compass is an agent skill from softcane/human-state-skills. Stress-tests a plan through dependency-aware, easy-to-answer decision prompts.
When should I use Plan Compass?
Plan Compass fits situations like: the user wants a plan stress-test; decision walkthrough with one concrete question at a time.
How do I install Plan Compass in Claude Code?
Run `npx skills add softcane/human-state-skills --skill plan-compass -a claude-code`. Or copy the skill folder (skills/plan-compass in softcane/human-state-skills) into .claude/skills/plan-compass in your project. Claude Code loads it when a task matches its description.
How do I install Plan Compass in Codex?
Run `npx skills add softcane/human-state-skills --skill plan-compass -a codex`. Or copy the skill folder (skills/plan-compass in softcane/human-state-skills) into .agents/skills/plan-compass in your project. Codex loads it when a task matches its description.
Can I use Plan Compass in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add softcane/human-state-skills --skill plan-compass -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/plan-compass, .gemini/skills/plan-compass, .github/skills/plan-compass and .opencode/skills/plan-compass in your project.
What does Plan Compass need to run?
SKILL.md names no scripts, command-line tools or credentials: Plan Compass is instructions for the agent only.
Does Plan Compass access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Plan Compass safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Plan Compass use?
Plan Compass is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Plan Compass use?
About 1.1k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Plan Compass?
Skills that share tags, products or a category with Plan Compass: Writing Livekit Scenarios (livekit-examples/agent-starter-python, 264 stars), Go Testing (cxuu/golang-skills, 170 stars), Goalcraft (grp06/goalcraft, 102 stars) and Thinking Partner (mattnowdev/thinking-partner, 206 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Plan Compass?
softcane (a GitHub user) maintains it in softcane/human-state-skills, which has 116 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on August 4, 2026.
Source: softcane/human-state-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.