Agent skill

Wayfinder Triage

by asdecided in asdecided/WayfinderRouter

Triage the Wayfinder repo in one pass — survey open PRs (CI status, review comments, mergeability) and open issues / feature requests, report what needs action, then drive small, clear fixes…

Apache-2.0Auto-check passedDevelopment

Install Wayfinder Triage

skills CLI
$ npx skills add asdecided/WayfinderRouter --skill wayfinder-triage -a claude-code

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

GitHub CLI
$ gh skill install asdecided/WayfinderRouter wayfinder-triage --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/asdecided/WayfinderRouter.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/wayfinder-triage .claude/skills/wayfinder-triage && 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-triage
GitHub stars
417
Token cost
~983 tokens
SKILL.md length
460 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
Apache-2.0

At a glance

Triage the Wayfinder repo in one pass — survey open PRs (CI status, review comments, mergeability) and open issues / feature requests, report what needs action, then drive small, clear fixes…

  • Works in 3 steps: Survey → Report → Act (per item)
  • Asked to do Wayfinder triage
  • SKILL.md covers 1. Survey, 2. Report, 3. Act (per item) and Project conventions (honor…, plus 1 more section
  • Calls ruff, mypy and pip

What it does

Wayfinder Triage is an agent skill from asdecided/WayfinderRouter. Triage the Wayfinder repo in one pass — survey open PRs (CI status, review comments, mergeability) and open issues / feature requests, report what needs action, then drive small, clear fixes following the project's conventions. Use when asked to "do Wayfinder triage", "triage the repo", check repo health, or review what's open across PRs and issues.

Its SKILL.md is about 980 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. It works with GitHub and Model Context Protocol. The repository describes itself as: Simple CLI tool for deterministic routing of queries between local and hosted LLM models. The licence is Apache-2.0.

When your agent uses it

  • Asked to do Wayfinder triage
  • Triage the repo
  • Check repo health
  • Review whats open across PRs and issues

Example prompts

  • “s conventions. Use when asked to”
  • “triage the repo”
  • “/wayfinder-triage”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Survey
  2. Report
  3. Act (per item)

What it can do on your machine

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

    Shell commands in SKILL.md call:

    • ruff
    • mypy
    • pip
    • pytest

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

    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 Triage loads about 983 tokens when it runs. Until then it costs about 92 tokens; SKILL.md has 460 words of instructions outside code blocks.

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

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 asdecided/WayfinderRouter at commit 075f17c, republished under its Apache-2.0 licence (© asdecided). 460 words, ~983 tokens.

Download SKILL.mdSave it as .claude/skills/wayfinder-triage/SKILL.md (or your agent's skills folder).
name
wayfinder-triage
description
Triage the Wayfinder repo in one pass — survey open PRs (CI status, review comments, mergeability) and open issues / feature requests, report what needs action, then drive small, clear fixes following the project's conventions. Use when asked to "do Wayfinder triage", "triage the repo", check repo health, or review what's open across PRs and issues.

Wayfinder triage

A repeatable health-and-action pass over the itsthelore/wayfinder-router repo. Works the same from the CLI, web, or mobile because it relies only on the GitHub MCP tools (mcp__github__*) — there is no gh CLI in web/mobile sessions.

Default posture: report first, act conservatively. Fix what is clearly small and unambiguous; ask before anything architectural; never merge unless the user has authorized it.

1. Survey

  • Open PRs — mcp__github__list_pull_requests (state open). For each, gather:
    • CI: pull_request_read method get_check_runs (note any non-success conclusion).
    • Reviews: pull_request_read method get_review_comments (unresolved threads).
    • Mergeability: pull_request_read method get (mergeable_state).
  • Open issues — mcp__github__list_issues (state OPEN); classify each as a feature request, bug, or question.

2. Report

Give a concise status — one line per PR (CI ✅/❌, review state, mergeable?) and per issue (type + the ask). Lead with anything red or blocked.

3. Act (per item)

  • Tractable, small CI failure → reproduce locally, fix, push to the PR's branch.
  • Ambiguous, architectural, or large → ask the user first (use AskUserQuestion).
  • Duplicate / no action needed → skip silently.
  • Green + mergeable PR → report it as ready. Merge only if the user has said so.
  • To keep watching a PR (CI + reviews) instead of one-shot triage, use the PR activity subscription rather than polling.

Project conventions (honor these when fixing or contributing)

  • Branch, never push to main. Open a PR from a feature branch.
  • Run the full CI gate locally before pushing (mirrors .github/workflows/ci.yml):
    • ruff check .
    • mypy wayfinder_router (install extras first so mypy sees optional deps: pip install -e ".[dev,gateway,ui]")
    • pytest -q
    • confirm rac is not importable — the standalone invariant (WF-ADR-0001).
  • Deterministic core invariant (WF-ADR-0001): scoring/routing makes no model call, needs no key, and touches no network. Model calls live only in the invocation / gateway layer (WF-ADR-0004). Never move logic that breaks this.
  • CHANGELOG (Keep a Changelog): every user-visible change gets a bullet under ## Unreleased in CHANGELOG.md, in user-impact voice, citing the relevant WF-ADR-#### / WF-DESIGN-####. Create the ## Unreleased section if absent.
  • Commits: conventional style (feat(...), fix(...), docs(...)).
  • Merging: squash with a clean, hand-written commit title + message. For stacked PRs, after the base merges, rebase the child onto the squashed base so its diff stays minimal.
  • Versioning is CalVer YYYY.M.MICRO, single-sourced at __version__ in wayfinder_router/__init__.py (read dynamically by pyproject.toml). Cut a release by promoting ## Unreleased to a dated ## vYYYY.M.MICRO — DATE entry (with a short intro) and bumping __version__ to match. Tagging/publishing is a human step.
Show full SKILL.md (73 more words)Show less

Notes

  • Providers: Wayfinder forwards to any OpenAI-compatible /chat/completions endpoint with a Bearer key — there is no per-provider code, so "does it support X?" is almost always "yes, point an arm's base_url at it." Auth schemes other than Bearer (e.g. Azure's api-key header) would need a code change.
  • Keys are read from the environment at request time and never written to disk; an optional api_key_cmd can fill one from a secret store in memory.

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

Files

Just SKILL.md in .claude/skills/wayfinder-triage of asdecided/WayfinderRouter.

Open the folder on GitHubat commit 075f17c

Compare with similar skills

Wayfinder Triage 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 Triage compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Wayfinder Triage this skillasdecided/WayfinderRouter417—~983Automated safety check: PassApache-2.0
Rea Changelog Updatemorluto/rea80k—~1.9kAutomated safety check: PassMIT
GitDiagram Repository Overviewahmedkhaleel2004/gitdiagram18k—~427Automated safety check: PassMIT
Library Documentation Seekerwithkynam/vibecode-pro-max-kit1.1k1 repos~1kAutomated safety check: NotesMIT
Herdr Issue Triageherdrdev/herdr43k—~517Automated safety check: PassApache-2.0
Plane Release Notes Generatormakeplane/plane61k—~2.5kAutomated safety check: PassAGPL-3.0

Similar skills

  • Prepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.

    80k GitHub stars~1.9k tokensUpdated today
    DevelopmentAuto-check passed
  • GitDiagram Repository Overview

    ahmedkhaleel2004/gitdiagram

    Explains the architecture of a public GitHub repository through GitDiagram: how the code is organized, the main components with paths, and a Mermaid diagram.

    18k GitHub stars~427 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Library Documentation Seeker

    withkynam/vibecode-pro-max-kit

    Looks up library and framework documentation through Context7 first, with bundled Node scripts as a fallback that fetch and analyze llms.txt files.

    1.1k GitHub starsUsed in 1 repo~1k tokens
    DevelopmentAuto-check: notes
  • Herdr Issue Triage

    herdrdev/herdr

    Triages open herdr GitHub issues into a short decision-first Markdown table with a priority light, recommendation, age, reactions and a reason for each.

    43k GitHub stars~517 tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Builds categorized release notes for a Plane release pull request from its commits and writes them into the PR description, for both the plane-cloud and plane-ee repos.

    61k GitHub stars~2.5k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Deepseek Automation

    zhu1090093659/deepseek-pp

    A skill your agent uses when implementing, resuming, reviewing, or verifying the DeepSeek++ Codex-style automation feature in this repository.

    1.9k GitHub stars~2.1k tokensUpdated 1 mo ago
    DevelopmentAuto-check: notes

More from asdecided/WayfinderRouter

  • Wayfinder Codex UX Review

    asdecided/WayfinderRouter

    Review and improve WAYFINDER's native macOS UX against OpenAI Codex app patterns and the repo's accepted menu-bar design contracts.

    417 GitHub stars~1.1k tokensUpdated 6 days ago
    Auto-check passed

Categories

Questions about Wayfinder Triage

What does Wayfinder Triage do?

Triage the Wayfinder repo in one pass — survey open PRs (CI status, review comments, mergeability) and open issues / feature requests, report what needs action, then drive small, clear fixes…. Wayfinder Triage is an agent skill from asdecided/WayfinderRouter. Triage the Wayfinder repo in one pass — survey open PRs (CI status, review comments, mergeability) and open issues / feature requests, report what needs action, then drive small, clear fixes following the project's conventions.

When should I use Wayfinder Triage?

Wayfinder Triage fits situations like: asked to do Wayfinder triage; triage the repo; check repo health; review whats open across PRs and issues.

How do I install Wayfinder Triage in Claude Code?

Run `npx skills add asdecided/WayfinderRouter --skill wayfinder-triage -a claude-code`. Or copy the skill folder (.claude/skills/wayfinder-triage in asdecided/WayfinderRouter) into .claude/skills/wayfinder-triage in your project. Claude Code loads it when a task matches its description.

How do I install Wayfinder Triage in Codex?

Run `npx skills add asdecided/WayfinderRouter --skill wayfinder-triage -a codex`. Or copy the skill folder (.claude/skills/wayfinder-triage in asdecided/WayfinderRouter) into .agents/skills/wayfinder-triage in your project. Codex loads it when a task matches its description.

Can I use Wayfinder Triage 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 asdecided/WayfinderRouter --skill wayfinder-triage -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-triage, .gemini/skills/wayfinder-triage, .github/skills/wayfinder-triage and .opencode/skills/wayfinder-triage in your project.

What does Wayfinder Triage need to run?

Going by SKILL.md and its folder, Wayfinder Triage needs the command-line tools its instructions call (ruff, mypy, pip and pytest). Our summary lists: Python 3.

Does Wayfinder Triage access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Wayfinder Triage 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 Triage use?

Wayfinder Triage is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Wayfinder Triage use?

About 983 tokens (SKILL.md is roughly 3.9k 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 Triage?

Skills that share tags, products or a category with Wayfinder Triage: Rea Changelog Update (morluto/rea, 80k stars), GitDiagram Repository Overview (ahmedkhaleel2004/gitdiagram, 18k stars), Library Documentation Seeker (withkynam/vibecode-pro-max-kit, 1.1k stars) and Herdr Issue Triage (herdrdev/herdr, 43k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Wayfinder Triage?

asdecided (a GitHub organization) maintains it in asdecided/WayfinderRouter, which has 417 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 5, 2026.

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