Agent skill

Wayfinder

by ChrisTitusTech in ChrisTitusTech/titus-ai

Create or maintain SPEC.md, MAP.md, and ANSWERS.md for large or unclear work.

No licenceAuto-check passed

Install Wayfinder

skills CLI
$ npx skills add ChrisTitusTech/titus-ai --skill wayfinder -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ChrisTitusTech/titus-ai wayfinder --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ChrisTitusTech/titus-ai.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/wayfinder .claude/skills/wayfinder && rm -rf skills-src

Use ~/.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/

Facts

Skill name
wayfinder
GitHub stars
146
Token cost
~1.2k tokens
SKILL.md length
655 words
Files
5 (incl. assets)
Skills in repo
17
Repo updated
First seen
Licence
None found

At a glance

Create or maintain SPEC.md, MAP.md, and ANSWERS.md for large or unclear work.

  • Works in 8 steps: Read applicable AGENTS.md files, inspect… → Identify the invocation mode → Name the destination before mapping the… → …
  • Ordinary planning
  • SKILL.md covers Files, Workflow, Mapping Rules and Validation
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Wayfinder is an agent skill from ChrisTitusTech/titus-ai. Create or maintain SPEC.md, MAP.md, and ANSWERS.md for large or unclear work. Invoke only with /wayfinder or $wayfinder; do not use for ordinary planning or implementation.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including assets (for example `agents/openai.yaml`, `assets/templates/ANSWERS.md` and `assets/templates/MAP.md`).

When your agent uses it

  • Ordinary planning

Example prompts

  • “/wayfinder”

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Read applicable AGENTS.md files, inspect existing changes, and locate any
  2. Identify the invocation mode
  3. Name the destination before mapping the route. Ask focused questions until
  4. Explore breadth-first. Capture precise unanswered decisions as named
  5. Give each question a stable Q-### identifier, a descriptive name, and any
  6. Resolve one coherent question at a time unless the user has already supplied
  7. When a question is resolved
  8. Stop when the requested planning pass is complete. Summarize the destination,

What it can do on your machine

Read from SKILL.md and the folder at commit 162d624. 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.

Context cost

Wayfinder loads about 1.2k tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 655 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~46
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 655 words (~1,210 tokens).

“Turn a foggy destination into three durable local planning files. Stay in planning mode: investigate and decide, but do not implement the destination unless the user separately authorizes implementation.”

— opening of SKILL.md by ChrisTitusTech
name
wayfinder

Read the full SKILL.md on GitHub

Files

SKILL.md and 4 other files (assets) in .agents/skills/wayfinder of ChrisTitusTech/titus-ai.

  • SKILL.md
  • agents/openai.yaml
  • assets/templates/ANSWERS.md
  • assets/templates/MAP.md
  • assets/templates/SPEC.md

Open the folder on GitHubat commit 162d624

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.

Wayfinder compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Wayfinder this skillChrisTitusTech/titus-ai146—~1.2kAutomated safety check: PassNone
Wiki Maintaineropenclaw/openclaw392k1 repos~462Automated safety check: PassMIT
Token Mapnexu-io/open-design100k—~1.4kAutomated safety check: PassApache-2.0
Maps Geographyasgeirtj/system_prompts_leaks69k—~717Automated safety check: PassCC0-1.0
Obsidian Vault Maintaineropenclaw/openclaw392k1 repos~262Automated safety check: PassMIT
Openclaw PR Maintaineropenclaw/openclaw392k—~2.2kAutomated safety check: PassMIT

Similar skills

  • Wiki Maintainer

    openclaw/openclaw

    Maintain the OpenClaw memory wiki vault with deterministic pages, managed blocks, and source-backed updates.

    392k GitHub starsUsed in 1 repo~462 tokens
    Knowledge ManagementAuto-check passed
  • Token Map

    nexu-io/open-design

    Map an extracted Figma / source-code token bag onto the active OD design system, producing a deterministic mapping the generate stage can consume.

    100k GitHub stars~1.4k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Maps Geography

    asgeirtj/system_prompts_leaks

    Accurate maps from real geo data — use for any map, or whenever geography would make a good graphic for a deliverable

    69k GitHub stars~717 tokensUpdated yesterday
    Auto-check passed
  • Obsidian Vault Maintainer

    openclaw/openclaw

    Maintain an Obsidian-friendly memory wiki vault with wikilinks, frontmatter, and official Obsidian CLI awareness.

    392k GitHub starsUsed in 1 repo~262 tokens
    Knowledge ManagementAuto-check passed
  • Openclaw PR Maintainer

    openclaw/openclaw

    Review, triage, repair, or land OpenClaw issues and pull requests with current-source evidence and the native maintainer workflow.

    392k GitHub stars~2.2k tokensUpdated today
    DevelopmentAuto-check passed
  • Map Wayfind

    azalio/map-framework

    Decision-frontier wayfinding: build and work a durable map of open design decisions BEFORE planning, for large or foggy efforts where $map-plan would force premature decomposition.

    156 GitHub stars~3.8k tokensUpdated 2 days ago
    DevelopmentAuto-check passed

More from ChrisTitusTech/titus-ai

All 17 skills in this repo
  • Quickshell

    ChrisTitusTech/titus-ai

    Build, lint, and troubleshoot Quickshell QML configurations or source builds.

    146 GitHub stars~779 tokensUpdated 3 days ago
    Auto-check passed
  • Mdbook

    ChrisTitusTech/titus-ai

    Create, edit, validate, and publish mdBook projects or mdBook-based KDP manuscripts.

    146 GitHub stars~773 tokensUpdated 3 days ago
    Auto-check passed
  • Code Review

    ChrisTitusTech/titus-ai

    Review code with CodeRabbit when the user requests CodeRabbit or repository policy selects it.

    146 GitHub stars~1.4k tokensUpdated 3 days ago
    Auto-check passed
  • Find Skills

    ChrisTitusTech/titus-ai

    Find and evaluate installable agent skills when the user asks to discover skills or extend agent capabilities.

    146 GitHub stars~1.2k tokensUpdated 3 days ago
    Auto-check passed
  • Forgejo Maintainer

    ChrisTitusTech/titus-ai

    Administer Forgejo or Gitea installations, including upgrades, backups, migrations, repository access, and Actions runners.

    146 GitHub stars~460 tokensUpdated 3 days ago
    Auto-check passed
  • PR Readiness

    ChrisTitusTech/titus-ai

    Validate changes and pull requests through merge readiness, including local gates, Codex review, CI, independent review, manual evidence, and unresolved review threads.

    146 GitHub stars~1.8k tokensUpdated 3 days ago
    Auto-check passed

Questions about Wayfinder

What does Wayfinder do?

Create or maintain SPEC.md, MAP.md, and ANSWERS.md for large or unclear work. Wayfinder is an agent skill from ChrisTitusTech/titus-ai.md for large or unclear work.

When should I use Wayfinder?

Wayfinder fits situations like: ordinary planning.

How do I install Wayfinder in Claude Code?

Run `npx skills add ChrisTitusTech/titus-ai --skill wayfinder -a claude-code`. Or copy the skill folder (.agents/skills/wayfinder in ChrisTitusTech/titus-ai) 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 ChrisTitusTech/titus-ai --skill wayfinder -a codex`. Or copy the skill folder (.agents/skills/wayfinder in ChrisTitusTech/titus-ai) 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 ChrisTitusTech/titus-ai --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.

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?

No licence was found for Wayfinder or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Wayfinder use?

About 1.2k tokens (SKILL.md is roughly 4.8k 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: Wiki Maintainer (openclaw/openclaw, 392k stars), Token Map (nexu-io/open-design, 100k stars), Maps Geography (asgeirtj/system_prompts_leaks, 69k stars) and Obsidian Vault Maintainer (openclaw/openclaw, 392k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Wayfinder?

ChrisTitusTech (a GitHub user) maintains it in ChrisTitusTech/titus-ai, which has 146 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 6, 2026.

Source: ChrisTitusTech/titus-ai on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.