QA Acceptance
paperclipai/paperclip
Produce QA acceptance criteria and a manual validation plan for a feature change — golden path, edge cases, error states, performance limits, and explicit pass/fail evidence.
Wayfind a foggy, multi-session effort into an accepted repository spec and separate implementation-ticket drafts.
MITAuto-check passed
Install Wayfinder
$ npx skills add PromptPartner/agentsmith --skill wayfinder -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install PromptPartner/agentsmith wayfinder --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/PromptPartner/agentsmith.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/wayfinder .claude/skills/wayfinder && 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 "wayfinder" agent skill from https://github.com/PromptPartner/agentsmith/tree/master/skills/wayfinder into .claude/skills/wayfinder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "wayfinder", 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/PromptPartner/agentsmith/tree/master/skills/wayfinderType 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 PromptPartner/agentsmith --skill wayfinder -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install PromptPartner/agentsmith wayfinder --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/PromptPartner/agentsmith.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/wayfinder .agents/skills/wayfinder && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "wayfinder" agent skill from https://github.com/PromptPartner/agentsmith/tree/master/skills/wayfinder into .agents/skills/wayfinder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "wayfinder", 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 PromptPartner/agentsmith --skill wayfinder -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install PromptPartner/agentsmith wayfinder --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/PromptPartner/agentsmith.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/wayfinder .cursor/skills/wayfinder && 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 "wayfinder" agent skill from https://github.com/PromptPartner/agentsmith/tree/master/skills/wayfinder into .cursor/skills/wayfinder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "wayfinder", 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/PromptPartner/agentsmith.git --path skills/wayfinder--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 PromptPartner/agentsmith --skill wayfinder -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install PromptPartner/agentsmith wayfinder --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/PromptPartner/agentsmith.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/wayfinder .gemini/skills/wayfinder && 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 "wayfinder" agent skill from https://github.com/PromptPartner/agentsmith/tree/master/skills/wayfinder into .gemini/skills/wayfinder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "wayfinder", 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 PromptPartner/agentsmith wayfinderInstalls 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 PromptPartner/agentsmith --skill wayfinder -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/PromptPartner/agentsmith.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/wayfinder .github/skills/wayfinder && 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 "wayfinder" agent skill from https://github.com/PromptPartner/agentsmith/tree/master/skills/wayfinder into .github/skills/wayfinder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "wayfinder", 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 PromptPartner/agentsmith --skill wayfinder -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install PromptPartner/agentsmith wayfinder --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/PromptPartner/agentsmith.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/wayfinder .opencode/skills/wayfinder && 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 "wayfinder" agent skill from https://github.com/PromptPartner/agentsmith/tree/master/skills/wayfinder into .opencode/skills/wayfinder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "wayfinder", 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
wayfinder- GitHub stars
- 177
- Token cost
- ~1.2k tokens
- SKILL.md length
- 580 words
- Files
- 1
- Skills in repo
- 10
- Repo updated
- First seen
- Licence
- MIT
At a glance
Wayfind a foggy, multi-session effort into an accepted repository spec and separate implementation-ticket drafts.
- Works in 6 steps: Read the tracked item, existing… → Name the destination and non-goals.… → Create docs/specs/.md from… → …
- The destination is known but important decisions
- SKILL.md covers Invariants, Chart, Advance and Terminal-spec gate, plus 1 more section
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Wayfinder is an agent skill from PromptPartner/agentsmith. Wayfind a foggy, multi-session effort into an accepted repository spec and separate implementation-ticket drafts. Use when the destination is known but important decisions, dependencies, or scope are not yet clear enough to implement safely.
Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Requires an Agent Skills-compatible coding agent with filesystem access.
The repository describes itself as: Universal, model-agnostic operating harness for AI agents (Claude, Codex, Gemini, …) — a lean core + work-type profiles assembled by one setup script. The licence is MIT.
When your agent uses it
- The destination is known but important decisions
- Scope are not yet clear enough to implement safely
Example prompts
- “/wayfinder”
Requirements
- Compatibility (from SKILL.md): Requires an Agent Skills-compatible coding agent with filesystem access.
Workflow steps
6 steps, taken from the first numbered list in SKILL.md.
- Read the tracked item, existing plans/specs, and docs/14-project-tracker-guide.md when present.
- Name the destination and non-goals. Route a small but still fuzzy, single-session change to
- Create docs/specs/.md from .harness/templates/wayfinder-spec.md (or
- Add every sharp question to the decision map, wire its blockers, and identify the frontier.
- If tracker writes are unauthorized, put paste-ready ticket bodies in the spec and surface them
- Stop after charting. The completed draft spec and ticket drafts are the evidence for this step.
What it can do on your machine
Read from SKILL.md and the folder at commit 19afde4. 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
Links to these hosts (documentation or services it may open):
github.com
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.
Compatibility
Requires an Agent Skills-compatible coding agent with filesystem access.
From compatibility in the SKILL.md frontmatter.
Context cost
Wayfinder loads about 1.2k tokens when it runs. Until then it costs about 63 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 PromptPartner/agentsmith at commit 19afde4, republished under its MIT licence (© PromptPartner). 580 words, ~1,172 tokens.
Download SKILL.mdSave it as
.claude/skills/wayfinder/SKILL.md (or your agent's skills folder).- name
- wayfinder
- description
- Wayfind a foggy, multi-session effort into an accepted repository spec and separate implementation-ticket drafts. Use when the destination is known but important decisions, dependencies, or scope are not yet clear enough to implement safely.
- compatibility
- Requires an Agent Skills-compatible coding agent with filesystem access.
Wayfinder
Turn uncertainty into a decision-complete spec. The map plans the route; it does not execute the destination.
Invariants
- Destination: the observable end state this effort is finding a route to.
- Decision map: named questions and their dependency edges. A decision produces an answer, not a slice of implementation.
- Frontier: the sharp, unresolved, unblocked decisions that can be taken next.
- Fog: in-scope uncertainty that cannot yet be phrased as a precise question. Fog graduates to a decision only when the question is sharp.
- Decision index: one context pointer and one-line rationale per resolved decision; the detail lives in its ticket or linked research artifact.
- Non-goal: a deliberate scope boundary. It never graduates from fog unless the destination is explicitly redrawn.
Resolve one decision per session. Parallel research may inform that decision, but does not silently resolve another one.
Chart
- Read the tracked item, existing plans/specs, and
docs/14-project-tracker-guide.mdwhen present. Determine the active tracker-write policy before any tracker action. - Name the destination and non-goals. Route a small but still fuzzy, single-session change to
grill-with-docs; route decision-complete work to the ordinary plan flow. - Create
docs/specs/<slug>.mdfrom.harness/templates/wayfinder-spec.md(ortemplates/wayfinder-spec.mdin the harness source checkout); reproduce that shape only when neither is available. Initial status is alwaysdraft. - Add every sharp question to the decision map, wire its blockers, and identify the frontier. Keep unshaped uncertainty in Fog. Draft a decision ticket for each mapped decision.
- If tracker writes are unauthorized, put paste-ready ticket bodies in the spec and surface them to the operator. A connected or named tracker grants no write permission.
- Stop after charting. The completed draft spec and ticket drafts are the evidence for this step.
Advance
- Load the spec at low resolution: destination, frontier, fog, non-goals, and decision index.
- Select one frontier decision. Research, prototype, or discuss only enough to answer its stated question. Human-preference decisions require the human's actual answer.
- Record the answer and rationale once, in the decision's ticket draft or authorized tracker item. Add only a linked gist to the Decision index.
- Recompute dependencies. Graduate newly sharp fog into decisions; move newly excluded work to Non-goals or Explicit deferrals with a reason.
- Stop after one decision. Completion means its answer is recorded and the map reflects the new frontier without duplicate rationale.
Show full SKILL.md (193 more words)Show less
Terminal-spec gate
A spec can be offered for acceptance only when:
- the destination and non-goals are concrete;
- no unresolved in-scope decision or blocking fog remains;
- each resolved decision has a rationale and context pointer;
- evidence/acceptance requirements cover the destination end to end; and
- implementation-ticket drafts are separate, independently executable scopes.
Present the spec as draft and ask the operator to accept or revise it. Only an explicit operator
acceptance may change status to accepted; record that human in accepted_by and the acceptance
time in accepted_at. An agent's own evaluation cannot accept it. Acceptance closes the decision
item and unlocks planning/execution against the separate implementation tickets.
Tracker consent still governs closing or creating items: when writes are unauthorized, provide the
close comment and implementation-ticket bodies as paste-ready drafts.
Implementation boundary
An implementation ticket names one deliverable, its scope, dependencies, and proof. It never inherits the decision ticket's identity. Wayfinder ends at the accepted spec and ticket drafts; start implementation only from a separately tracked implementation ticket and the operator's normal execution instruction.
Adapted from Matt Pocock's
wayfinder
(MIT). Agentsmith keeps its decision-map concepts while making the terminal artifact repository-
native and preserving tracker consent.
© PromptPartner, 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/wayfinder of PromptPartner/agentsmith.
Open the folder on GitHubat commit 19afde4
Compare with similar skills
Wayfinder 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 |
|---|---|---|---|---|---|---|
| Wayfinder this skillPromptPartner/agentsmith | 177 | — | ~1.2k | Automated safety check: Pass | MIT | |
| QA Acceptancepaperclipai/paperclip | 99k | — | ~964 | Automated safety check: Pass | MIT | |
| Acceptance Orchestratorsickn33/agentic-awesome-skills | 47k | 2 repos | ~943 | Automated safety check: Pass | MIT | |
| Acceptance Evidence for Deliverieslobehub/lobehub | 83k | — | ~9.7k | Automated safety check: Pass | Apache-2.0 | |
| Change, Accept or Leave Frameworkkangarooking/cangjie-skill | 11k | — | ~700 | Automated safety check: Pass | MIT | |
| Wayfindervinvcn/mattpocock-skills-zh-CN | 4.7k | — | ~1.8k | Automated safety check: Pass | MIT |
Similar skills
Acceptance Orchestrator
sickn33/agentic-awesome-skills
A skill your agent uses when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and acceptance verification with minimal human re-intervention.
Acceptance Evidence for Deliveries
lobehub/lobehub
Verifies a delivery end to end by driving the real product on a CLI, web, desktop or iOS Simulator surface, capturing evidence and publishing a round with the lh CLI.
Change, Accept or Leave Framework
kangarooking/cangjie-skill
Helps someone stuck ruminating over an unchangeable situation decide whether to change it, accept it, or leave it, drawn from a chapter of Navalism-style writing.
Wayfinder
vinvcn/mattpocock-skills-zh-CN
把单个 agent session 装不下的一大块工作规划成 issue tracker 上的 decision tickets shared map，并逐一解决，直到通往 destination 的路清晰。
Wayfinder
bestofjs/bestofjs
Plan a huge chunk of work — more than one agent session can hold — as a shared map of decision tickets on your issue tracker, and resolve them one at a time until the way to the destination is clear.
More from PromptPartner/agentsmith
All 10 skills in this repoAutonomous Run
PromptPartner/agentsmith
Prepare, start, inspect, resume, or stop a finite local overnight coding run after a human has accepted a Wayfinder terminal spec; coordinates a declared Claude/Codex maker and independent checker…
Grill With Docs
PromptPartner/agentsmith
Grill a fuzzy, single-session repository change into shared language, recorded decisions, and a handoff-ready plan.
Handoff
PromptPartner/agentsmith
Checkpoint work for recovery — fires on "handoff", "wrap up", context pressure, a closed phase, or before a long external wait or irreversible gate.
Harness Doctor
PromptPartner/agentsmith
Check whether this project's Agentsmith harness is installed correctly and healthy — fires on "is my harness set up right?", "harness doctor", "check my harness".
Harness Help
PromptPartner/agentsmith
Orient a non-coder to this project's Agentsmith harness — fires on "what is this harness?", "what are my rules?", "which profile am I on?", "what do I type next?".
New Feedback
PromptPartner/agentsmith
Log a harness lesson / post-incident so the SYSTEM improves, not just this one bug — fires on "log a harness lesson", "post-incident", "we should make this less likely", System-Evolution moments.
Questions about Wayfinder
What does Wayfinder do?
Wayfind a foggy, multi-session effort into an accepted repository spec and separate implementation-ticket drafts. Wayfinder is an agent skill from PromptPartner/agentsmith. Wayfind a foggy, multi-session effort into an accepted repository spec and separate implementation-ticket drafts.
When should I use Wayfinder?
Wayfinder fits situations like: the destination is known but important decisions; scope are not yet clear enough to implement safely.
How do I install Wayfinder in Claude Code?
Run `npx skills add PromptPartner/agentsmith --skill wayfinder -a claude-code`. Or copy the skill folder (skills/wayfinder in PromptPartner/agentsmith) into .claude/skills/wayfinder in your project. Claude Code loads it when a task matches its description.
How do I install Wayfinder in Codex?
Run `npx skills add PromptPartner/agentsmith --skill wayfinder -a codex`. Or copy the skill folder (skills/wayfinder in PromptPartner/agentsmith) into .agents/skills/wayfinder in your project. Codex loads it when a task matches its description.
Can I use Wayfinder 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 PromptPartner/agentsmith --skill wayfinder -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/wayfinder, .gemini/skills/wayfinder, .github/skills/wayfinder and .opencode/skills/wayfinder in your project.
What does Wayfinder need to run?
SKILL.md names no scripts, command-line tools or credentials: Wayfinder is instructions for the agent only. Compatibility (from SKILL.md): Requires an Agent Skills-compatible coding agent with filesystem access..
Does Wayfinder access the network?
SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.
Is Wayfinder 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 Wayfinder use?
Wayfinder 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 Wayfinder use?
About 1.2k tokens (SKILL.md is roughly 4.7k 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 Wayfinder?
Skills that share tags, products or a category with Wayfinder: QA Acceptance (paperclipai/paperclip, 99k stars), Acceptance Orchestrator (sickn33/agentic-awesome-skills, 47k stars), Acceptance Evidence for Deliveries (lobehub/lobehub, 83k stars) and Change, Accept or Leave Framework (kangarooking/cangjie-skill, 11k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Wayfinder?
PromptPartner (a GitHub user) maintains it in PromptPartner/agentsmith, which has 177 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 9, 2026.
Source: PromptPartner/agentsmith on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.