One-click install
npx skills add https://github.com/cloudofgeorge/AI-hands-Engineer --skill wayfinder-cloudofgeorge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wayfinder
Source: https://github.com/cloudofgeorge/AI-hands-Engineer/tree/main/skills/engineering/wayfinder
Command: npx skills add https://github.com/cloudofgeorge/AI-hands-Engineer --skill wayfinder-cloudofgeorge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large efforts often exceed what a single agent session can hold, leaving the path from idea to destination unclear. This Skill charts that path as a shared map of decision tickets on the repo's issue tracker, resolving them one at a time until the way forward is fully decided. ## Core Features & Use Cases - Map-based planning: Creates a single map issue (labelled wayfinder:map) holding the destination, notes, decisions-so-far index, fog of war, and out-of-scope sections. - Typed decision tickets: Breaks work into research, prototype, grilling, and task tickets, each sized to one agent session, with native blocking relationships defining the workable frontier. - Concurrent session safety: Tickets are claimed by assignment before work begins, so multiple parallel sessions never collide on the same decision. - Use Case: You have a vague migration idea too big for one session. Invoke the skill to grill out the destination, chart the open decisions as tickets, fire research subagents in parallel, then resolve one ticket per session until the route is clear. ## Quick Start Ask the agent to use the wayfinder skill to chart a map for your large, loosely-defined effort on the 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 project too big for one agent session?

Use the wayfinder skill to chart the effort as a map issue on your issue tracker with child decision tickets. Each ticket is sized to one session and resolved one at a time until the way to the destination is clear.

What is a decision ticket in wayfinding?

A decision ticket is a child issue of the map whose resolution is a decision, not a build deliverable. Each carries a type label: research, prototype, grilling, or task, and is claimed by assignment before work begins.

Does wayfinder require a specific issue tracker?

Wayfinder works with any issue tracker that supports labels, child issues, assignees, and native blocking relationships. If no tracker is provided, it defaults to a local-markdown tracker convention.

Can multiple agent sessions work on the same map?

Yes. Sessions claim tickets by assigning themselves before starting work, so concurrent sessions skip claimed tickets. The frontier is the set of open, unblocked, unclaimed tickets.

When should I not use wayfinding for a task?

Skip wayfinding when the path to the destination is already clear and the whole journey fits in one session. The charting step explicitly stops and asks how to proceed if no fog is surfaced.