wayfinder Skill for Claude Code: Map Big Work as Decision Tickets

Plans work too big for one agent session as a map of decision tickets on your issue tracker, then resolves them one at a time until the way forward is clear.

Installs: 758K; on skills.sh
Stars: 309.2K; on GitHub
Files: 1; besides SKILL.md
Updated: Nov 2026; last repo commit

wayfinder is for the loose, foggy idea. It plans, and it does not build. You name a destination, such as a spec, a decision or a migration. The agent opens one "map" issue on your tracker, labelled wayfinder:map, and hangs child tickets off it. Each ticket is one question sized for a single session.

Tickets come in four types: research, prototype, grilling and task. Research tickets run in parallel sub-agents that call the research skill. It depends on grilling, domain-modeling, research and prototype, and it publishes issues to your tracker. You start it with /wayfinder.

Good for

Developers facing a project too big to hold in one chat
Teams that plan in GitHub or another issue tracker
Anyone who wants decisions recorded as tickets before any code is written

Install wayfinder

Claude Code

Copy this prompt.

Install the wayfinder skill in Claude Code. Run this command:

claude plugin install mattpocock-skills@claude-plugins-official

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Install the whole set with the plugin route. wayfinder calls other skills from the same repo, and the README asks you to run /setup-matt-pocock-skills once per repo so they know your issue tracker. Pick one route per agent, or you get every skill twice. Claude Code names plugin skills /plugin-name:skill-name, so the full name is /mattpocock-skills:wayfinder if /wayfinder is not found.

From the project README. Source.

What's in the skill

When it loads

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.

Sections in SKILL.md

Plan, don't do
Refer by name
The Map
The map body
Destination
Notes
Decisions so far
Not yet specified
Out of scope
Tickets
Question
Ticket Types
Fog of war
Out of scope
Invocation
Chart the map

Key facts

Author: Matt Pocock
Repo: mattpocock/skills
Installs on skills.sh: 758,034 (Nov 2, 2026)
GitHub stars: 309,237 (Nov 2, 2026)
License: MIT
Last repo commit: Nov 1, 2026
Files next to SKILL.md: 1 files
skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk warn
Needs: grilling, domain-modeling, research and prototype skills, plus the issue tracker settings from setup-matt-pocock-skills (the SKILL.md defaults to a local-markdown tracker if none is provided)

What it includes

Names the destination, creates the map and child tickets, fires research sub-agents
Each research ticket gets a sub-agent that pushes a throwaway research branch with no PR.
Runs code · Chart the map
Claims one open ticket, resolves it by type, records the answer, adds new tickets
Write · Work through the map
Reading docs or APIs to settle a fact; an AFK sub-agent uses the research skill
Network · wayfinder:research
A cheap rough artifact to react to, made with the prototype skill
Write · wayfinder:prototype
A conversation with you, using the grilling and domain-modeling skills
wayfinder:grilling
Manual work that must happen before a decision, like signing up for a service
wayfinder:task
Keeps unsharp questions in a "Not yet specified" section instead of ticketing them
Fog of war

From the official docs

Permissions

Medium risk

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It creates and updates issues on your tracker
Use a repo where new issues and labels are fine, and check the map and tickets it makes. github.com
Research sub-agents push a branch to your remote
For each research ticket, the SKILL.md says to capture findings on a throwaway research/<name> branch, push it and open no PR. Expect extra branches on your remote and delete them when the map is done. github.com
Research sub-agents read outside sources
Research tickets read documentation and third-party APIs. Do not paste secrets into tickets. github.com
skills.sh shows a Snyk warning for this skill
Read the SKILL.md before you install if you must pass a security review. skills.sh

Technical details

Talks to	Your issue tracker. Documentation and APIs that research tickets read. Your git remote, for research/<name> branches
Scopes	Your issue tracker (issues, labels, assignees) Your repo, for research and prototypes

Questions

What does wayfinder do?

It plans a large effort as a shared map on your issue tracker. Each decision becomes a ticket, and the map is done when nothing is left to decide before the work can start.

How do I install wayfinder?

Use the install box at the top and install the whole set. wayfinder calls grilling, domain-modeling, research and prototype, and it expects the tracker settings from the setup skill. If no tracker is provided, the SKILL.md says to default to a local-markdown tracker.

Does it write code?

No, planning is the default. The SKILL.md says the pull to just do the work usually means you have reached the edge of the map. Prototypes are the exception, and they are throwaway.

What does it create on my tracker?

One map issue labelled wayfinder:map and child issues labelled wayfinder:research, prototype, grilling or task. Those labels are the only ones it adds.

Can several people or sessions use one map?

Yes. A session claims a ticket by assigning it to the dev driving the map, so other sessions skip it.

Is wayfinder safe?

It creates and edits issues on your tracker with your login, pushes throwaway research branches, and can write throwaway prototype code. Point it at a repo you are happy to add issues and branches to. Skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk warn.

Information

updated Nov 2, 2026

Repository: mattpocock/skills
Folder: skills/engineering/wayfinder

mattpocock/skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 3

mattpocock/skills README · github.com
wayfinder SKILL.md · github.com
wayfinder on skills.sh · skills.sh