One-click install
npx skills add https://github.com/gmackie/agent-skills --skill wayfinder-gmackie
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wayfinder
Source: https://github.com/gmackie/agent-skills/tree/main/skills/wayfinder
Command: npx skills add https://github.com/gmackie/agent-skills --skill wayfinder-gmackie

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large, ambiguous efforts are too big for a single agent session, and charging straight at the goal without a plan leads to wasted work. Wayfinder turns a loose idea into a shared map of decision tickets on your issue tracker, resolving them one at a time until the path to the destination is clear. ## Core Features & Use Cases - Map-based planning: Creates a single map issue (labeled wayfinder:map) that indexes decisions, open questions, fog of war, and out-of-scope work. - Typed decision tickets: Breaks work into research, prototype, grilling, and task tickets, each sized to one agent session, with native blocking relationships defining the frontier. - Two invocation modes: Chart a new map from a loose idea, or work through an existing map by claiming and resolving one ticket per session. - Use Case: You need to plan a major data-structure migration. Invoke Wayfinder to grill out the destination, fan out the open decisions into tickets, fire research subagents in parallel, and then resolve tickets session by session until the migration plan is fully decided. ## Quick Start Ask the agent to use the wayfinder skill to chart a map for your large idea, naming the destination and letting it create the first decision tickets on your issue tracker.

Frequently Asked Questions about wayfinder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I plan a large change across multiple agent sessions?▼

Use Wayfinder to chart a map issue on your issue tracker, then create decision tickets as child issues. Resolve one ticket per session, recording each answer as a resolution comment and updating the map's Decisions-so-far index.

What ticket types does Wayfinder use for decision planning?▼

Wayfinder uses four labeled ticket types: research (AFK fact-finding via subagents), prototype (HITL rough artifacts), grilling (HITL conversation), and task (manual work that unblocks a decision). Each ticket is labeled wayfinder:<type>.

Does Wayfinder work with GitHub Issues or other trackers?▼

Wayfinder is tracker-agnostic but expects an issue tracker to be provided, with tracker-specific operations documented in a tracker doc. If none is provided, it defaults to a local Markdown tracker, preferring native blocking relationships where available.

When should I not use Wayfinder for a task?▼

Skip Wayfinder when the work fits in a single session or when charting surfaces no fog, meaning the path is already clear. It is a planning tool that produces decisions, not deliverables, unless an effort explicitly overrides this in its Notes.

How does Wayfinder handle work that is not yet well defined?▼

Undefined but in-scope work goes in the map's Not yet specified section as fog of war. It graduates into tickets only when the question becomes sharp enough to state precisely, while consciously excluded work is recorded as Out of scope.