agentleFS
dgilforddgilford/ai-science-toolkit/skills/pathfinder/SKILL.md

pathfinder

Skill82 starsChanged 42 days agoMITView on GitHub

SLASH COMMAND — type /pathfinder to get a navigable map of every skill and subagent and when to reach for each. Resolves the reviewer-2-vs-panel decision. Use when unsure which skill or agent to invoke, or when orienting a new session.

10 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use oh-my-issues, what-the and 8 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • tuliosalustiano27Skill

    oh-my-issues

    Cluster a GitHub issue backlog by root cause into a small set of plan-master issues, redirect children with a standardized comment, and bundle architectural-fix PRs that close clusters atomically. Use when an issue tracker has accumulated dozens of reports that share underlying defects, when asked to triage / consolidate / cluster / dedupe issues, when asked to build a plan series or roadmap from open issues, or when routing a new incoming bug into an existing plan.

    Also in 3 projects that use this

  • tuliosalustiano27Skill

    what-the

    What the? Use when the user wants a plain-English breakdown of something technical — the who, what, where, why, and when.

    Also in 3 projects that use this

  • tunnckoCoreSkill

    how-it-works

    Use for 'how does X work', code walkthroughs before changing something, and placement / ownership / layering questions ('where should this live', 'which package owns this', 'is this the right layer'). Explains subsystem architecture, runtime flow, onboarding mental models. Can critique architecture. Use why for motivation.

    Also in 4 projects that use this

  • magnusrodsethSkill

    learn-codebase

    Understand a codebase by reading its actual source, on GitHub or on disk: how a pattern is really implemented, an org's conventions, how two things are wired. Use for \"how does <repo> do X\". For published API docs prefer find-docs.

    Also in 5 projects that use this

  • dqtx760Skill

    timeline-report

    Generate a "Journey Into [Project]" narrative report analyzing a project's entire development history from claude-mem's timeline. Use when asked for a timeline report, project history analysis, development journey, or full project report.

    Also in 3 projects that use this

  • barrelcSkill

    mem-search

    Search kimi-mneme's persistent cross-session memory database. Use when user asks "did we already solve this?", "how did we do X last time?", "what did we do yesterday?", or needs work from previous sessions.

    Also in 4 projects that use this

The file

We split this skill into the rules it gives an agent

1 rule. 0 are common, 1 is distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 10 edited versions we read keep these.

  • 1

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    All four are review-only (report findings.

    line 69

“Common” is measured: kept by at least 6 in 10 of the 10 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Skill & Agent Router

Type /pathfinder when you need to know which skill or subagent to reach for. Nothing here fires automatically; this is a navigation aid only.


Session lifecycle

Lost a session     →  /recover-sessions   find the closed conversation and resume it
Start of session   →  /pickup
                         ↓ (do work)
End of session     →  /handoff           writes .ai/HANDOFF.md, then calls /evolve-claude-md
Standalone update  →  /evolve-claude-md  promote session knowledge to CLAUDE.md only
Periodically       →  /retro             the counterweight: propose checks, pointers, and cuts so CLAUDE.md shrinks

Skills — user-invoked (type the slash command explicitly)

SkillCommandReach for it when…
repo-init/repo-init [--package]Starting a new repo (or retrofitting an old one): scaffolds the standard structure — research mode by default, --package for a distributable library. Idempotent
pickup/pickupStarting a new session; reconstructs context from .ai/HANDOFF.md. Named pickup, not resume, so it doesn't shadow Claude Code's built-in /resume session picker
recover-sessions/recover-sessionsA session closed or crashed and you want it back; finds the Claude conversation itself on disk. Distinct from pickup, which reconstructs project state from .ai/HANDOFF.md
handoff/handoffEnding a session or switching agents; calls evolve-claude-md internally
evolve-claude-md/evolve-claude-mdStandalone CLAUDE.md update without a full handoff
retro/retro [--session <id>] [--global]After a session where the agent struggled or repeated a mistake, or when CLAUDE.md has grown: proposes a check per mistake, a pointer per slow lookup, a cut per no-op instruction. Report-only — the opposite direction to evolve-claude-md
grill-me/grill-meStress-testing a plan or design before implementing; thin launcher for the grilling core
slack-message/slack-messageDrafting an internal Slack update grounded in git context
create-alert/create-alert [--spec-only]Getting pinged on Slack when something changes/happens: grills a "tell me when X" ask into a testable trigger, dry-runs it, and (on sign-off) creates a scheduled cloud routine. --spec-only stops at the spec
disclose-project/disclose-project [path]A paper or other multi-session project needs its AI-use statement: interviews you phase by phase into a per-phase spectrum-of-involvement table plus a publication statement. Per-artifact disclosures are disclose
tab-setup/tab-setup [all]Naming / coloring this Claude Code tab; all recolors every active session
write-new-skill/write-new-skillScaffolding a new skill from scratch
spot-ai/spot-ai [path | pasted text]Checking prose for AI markers: gray-list style tells (lane 1) and generation-mechanism substance tells like fabricated provenance or invented first-person testimony (lane 2). Flags only. Not a copy-editor — it reports AI markers, not writing advice
ai-review/ai-reviewFull comprehensive repo/project review; orchestrates code-review/security-review/unstale/overbaked/reviewer-2 in parallel and adds gap-hunting + grounded ideation + prioritized synthesis. Run on fable at high+ effort
pathfinder/pathfinderThis router

Skills — model-invokable (reachable by the model or another skill mid-task)

SkillReach for it when…
grillingStress-testing a plan in rounds along the decision tree's frontier, facts looked up rather than asked — and proactively before a step that changes running state, grabs a shared resource (GPUs/ports/memory), or could invalidate an earlier decision. /grill-me is the explicit launcher
figure-reviewUser shares or references a figure/plot and wants it checked for publication readiness
lit-reviewSearching or synthesizing scientific literature; citation checks from a review flow
overbakedAuditing any artifact for over-engineering, verbosity, or scope creep
brieflyUser wants a short answer — /briefly typed anywhere in a prompt (mid-prompt it doesn't expand; invoke it), or "brief"/"TL;DR"
reviewer-2Quick generalist stress-test of a claim, result, or section (any domain)
unstaleCleaning up dead imports, stale comments, resolved TODOs after a refactor
discloseA deliverable is about to be shared (doc, Slack message, post, figure, artifact): estimates Claude's spectrum of involvement (0–10), has you confirm or revise it, and emits a content-disclosure line. slack-message calls it; handoff lists unrated shareables
evolve-claude-mdPromoting session knowledge to CLAUDE.md (called by handoff; also invokable standalone)

Subagents — domain reviewer panel

Subagents are spawned with the Agent tool (subagent_type:), not slash commands. All four are review-only (report findings; never rewrite).

SubagentDomainReach for it when…
attribution-reviewerClimate attributionAn attribution claim, result, or draft section needs expert scrutiny (PR/OR/ChIP, storyline, D&A)
meteo-reviewerMeteorology (AMS CCM)A weather analysis or mechanistic argument needs dynamical / thermodynamic review
stats-reviewerStatistics / MLA statistical analysis, methods section, or quantitative result needs estimator/causal/inference review
scicomm-reviewerScience communicationA public-facing product (article, press release, talk abstract) needs communication-effectiveness review

Review decision tree

Need a review?
│
├── Quick generalist stress-test — one skill, any domain, fast
│   → /reviewer-2
│     Baseline, counterfactual, alternatives, uncertainty consistency.
│     No domain expertise assumed.
│
├── Deep single-domain review — expert read on one dimension
│   ├── Attribution claim / result     → attribution-reviewer subagent
│   ├── Weather / synoptic mechanism   → meteo-reviewer subagent
│   ├── Statistical analysis / ML      → stats-reviewer subagent
│   └── Public-facing science product  → scicomm-reviewer subagent
│
└── Full multi-lens review — manuscript, full section, ≥2 dimensions
    → Spawn the relevant subset of the 4 subagents in a SINGLE message
      (parallel, independent — no cross-anchoring).
      Synthesize findings after all return.
      Use /reviewer-2 first if you want a fast generalist pass before the panel.

When NOT to use the panel

  • Single-domain question → one reviewer, not all four.
  • /reviewer-2 covers the generalist case; don't over-convene the panel for a claim check.
  • Prose checks split three ways: /spot-ai = does this read as machine-written (AI markers only) · /overbaked = is it over-engineered or verbose · /reviewer-2 = is the claim defensible. spot-ai deliberately refers the other two out rather than duplicating them.
  • scicomm-reviewer is for public-facing products, not internal methods or data.

Citing literature during a review

Any reviewer can flag missing citations. To retrieve them, route to /lit-review (Zotero, arxiv, bioRxiv, Google Scholar, Consensus).


Composition rule (for skills that call other skills)

A user-invoked skill may call model-invokable skills; never another user-invoked one. (Examples: handoff → evolve-claude-md; grill-me → grilling.)

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.