New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Wayfinder

by stevesolun in stevesolun/ctx

Map a large, unclear, multi-session effort as linked decisions, then advance the map until the route to the destination is clear.

MITAuto-check passed

Install Wayfinder

skills CLI
$ npx skills add stevesolun/ctx --skill wayfinder -a claude-code

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

GitHub CLI
$ gh skill install stevesolun/ctx 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/stevesolun/ctx.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
588
Token cost
~379 tokens
SKILL.md length
188 words
Files
4 (incl. references)
Skills in repo
26
Repo updated
First seen
Licence
MIT

At a glance

Map a large, unclear, multi-session effort as linked decisions, then advance the map until the route to the destination is clear.

  • Works in 6 steps: Name the destination and its scope with… → Inspect the configured tracker and… → Create a low-resolution map: settled… → …
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Wayfinder is an agent skill from stevesolun/ctx. Map a large, unclear, multi-session effort as linked decisions, then advance the map until the route to the destination is clear.

Its SKILL.md is about 380 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `agents/openai.yaml`, `references/map-model.md` and `references/workflows.md`).

The repository describes itself as: CTX Fit finds the cheapest AI coding setup that reliably works on your repository, then applies the winner as a reviewable change. The licence is MIT.

Example prompts

  • “/wayfinder”

Workflow steps

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

  1. Name the destination and its scope with the user.
  2. Inspect the configured tracker and existing decisions. Choose a map
  3. Create a low-resolution map: settled decisions, sharply stated open
  4. Advance independent questions concurrently when ownership and writes do not
  5. After resolving a question, record the decision once, update affected
  6. Hand off when the route is clear enough for specification or execution.

What it can do on your machine

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

    No URLs in SKILL.md.

    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 379 tokens when it runs, and up to ~970 if it reads all its reference files. Until then it costs about 35 tokens; SKILL.md has 188 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~35
When it runs · the whole SKILL.md, loaded when a task matches
~379
With references · SKILL.md plus every file in references/, read only if the agent opens them
~970

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 stevesolun/ctx at commit 11b582a, republished under its MIT licence (© stevesolun). 188 words, ~379 tokens.

Download SKILL.mdSave it as .claude/skills/wayfinder/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
wayfinder
description
Map a large, unclear, multi-session effort as linked decisions, then advance the map until the route to the destination is clear.

Wayfind a large effort

Use this skill when the destination matters but the route cannot yet fit in one working session. If the work is already well scoped, recommend a lighter plan or implementation workflow.

  1. Name the destination and its scope with the user.
  2. Inspect the configured tracker and existing decisions. Choose a map representation that collaborators and agents can query reliably.
  3. Create a low-resolution map: settled decisions, sharply stated open questions, dependencies, unresolved fog, and explicit out-of-scope work. Avoid inventing detailed tickets for questions that are not yet clear.
  4. Advance independent questions concurrently when ownership and writes do not conflict. Keep human judgment in the loop for product or preference decisions; use research or prototypes when evidence is missing.
  5. After resolving a question, record the decision once, update affected dependencies and fog, and expose the next useful frontier.
  6. Hand off when the route is clear enough for specification or execution. Wayfinding may produce work only when doing so is necessary to resolve a decision.

Read references/map-model.md when creating or repairing a map. Read references/workflows.md for charting, advancing, concurrency, and handoff choices.

© stevesolun, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in .agents/skills/wayfinder of stevesolun/ctx.

  • SKILL.md
  • agents/openai.yaml
  • references/map-model.md
  • references/workflows.md

Open the folder on GitHubat commit 11b582a

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 skillstevesolun/ctx588—~379Automated safety check: PassMIT
SEO Aeo Internal Linkingsickn33/agentic-awesome-skills47k1 repos~2.3kAutomated safety check: PassMIT
Internal Linksthedaviddias/Front-End-Checklist74k—~770Automated safety check: PassMIT
Token Mapnexu-io/open-design100k—~1.4kAutomated safety check: PassApache-2.0
Map Wayfindazalio/map-framework156—~3.8kAutomated safety check: PassMIT
Maps Geographyasgeirtj/system_prompts_leaks69k—~717Automated safety check: PassCC0-1.0

Similar skills

  • SEO Aeo Internal Linking

    sickn33/agentic-awesome-skills

    Maps internal link opportunities between pages with relevant anchor text, placement instructions, orphan-page detection, and cannibalisation checks.

    47k GitHub starsUsed in 1 repo~2.3k tokens
    Marketing & SEOAuto-check passed

  • Internal Links

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing a site's internal link structure, identifying pages that need more incoming links, generating contextual linking opportunities between related content, or…

    74k GitHub stars~770 tokensUpdated 4 days ago
    Marketing & SEOAuto-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

  • 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 3 days ago
    DevelopmentAuto-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 today
    Auto-check passed

  • External Links

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing content pages for citation quality, suggesting authoritative sources to link for factual claims, or reviewing whether a page's external link attributes…

    74k GitHub stars~773 tokensUpdated 4 days ago
    Research & ScienceAuto-check passed

More from stevesolun/ctx

All 26 skills in this repo

  • Diagnosing Bugs

    stevesolun/ctx

    Diagnose hard bugs and performance regressions with reproducible evidence, focused hypotheses, and proportional instrumentation.

    588 GitHub stars~596 tokensUpdated 6 days ago
    Auto-check passed

  • Repo Stats Autoupdate

    stevesolun/ctx

    Keeps README badge + inline counts in sync with the real number of skills, agents, graph nodes/edges, communities, converted pipelines, and test inventory.

    588 GitHub stars~724 tokensUpdated 6 days ago
    Auto-check passed

  • Code Review

    stevesolun/ctx

    Review a Git diff against repository standards and its originating requirements.

    588 GitHub stars~466 tokensUpdated 6 days ago
    Auto-check passed

  • No Mistakes

    stevesolun/ctx

    Validate committed feature-branch changes through the no-mistakes pipeline: intent, rebase, review, test, docs, lint, push, PR, and CI.

    588 GitHub stars~458 tokensUpdated 6 days ago
    Auto-check passed

  • Skill Router

    stevesolun/ctx

    Repo-aware recommendation manager for ctx. An agent skill from stevesolun/ctx.

    588 GitHub stars~2.4k tokensUpdated 6 days ago
    Auto-check passed

  • Codebase Design

    stevesolun/ctx

    Design or improve module interfaces using deep-module heuristics.

    588 GitHub stars~662 tokensUpdated 6 days ago
    Auto-check passed

Questions about Wayfinder

What does Wayfinder do?

Map a large, unclear, multi-session effort as linked decisions, then advance the map until the route to the destination is clear. Wayfinder is an agent skill from stevesolun/ctx. Map a large, unclear, multi-session effort as linked decisions, then advance the map until the route to the destination is clear.

How do I install Wayfinder in Claude Code?

Run `npx skills add stevesolun/ctx --skill wayfinder -a claude-code`. Or copy the skill folder (.agents/skills/wayfinder in stevesolun/ctx) 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 stevesolun/ctx --skill wayfinder -a codex`. Or copy the skill folder (.agents/skills/wayfinder in stevesolun/ctx) 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 stevesolun/ctx --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 contains no URLs. Any network use would come from the scripts or tools the agent runs. 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 379 tokens (SKILL.md is roughly 1.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 591 tokens, read only when the agent opens those files.

What are the alternatives to Wayfinder?

Skills that share tags, products or a category with Wayfinder: SEO Aeo Internal Linking (sickn33/agentic-awesome-skills, 47k stars), Internal Links (thedaviddias/Front-End-Checklist, 74k stars), Token Map (nexu-io/open-design, 100k stars) and Map Wayfind (azalio/map-framework, 156 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Wayfinder?

stevesolun (a GitHub user) maintains it in stevesolun/ctx, which has 588 GitHub stars. The repository holds 26 skills in this directory. The repository was last updated on October 4, 2026.

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