agentleFS
farky-techfarky-tech/containers/skills/capability-routing/SKILL.md

capability-routing

Skill1 starsChanged 4 months agoMITView on GitHub

Use when a task may need existing skills, subagents, hooks, tools, or the container's project memory. Routes capabilities quietly, calibrates whether to stay silent or speak, classifies runtime availability, and reports only skipped or unavailable relevant capabilities. Do NOT use for every ordinary implementation task just because it is non-trivial.

1 other project uses a version of this.

Adopted by

Most recently taken up by

  • Other versions1 project uses a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 1

    1. tunahanaliozturk/atelier★ 1same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository6 other files it gives its agents.

The file

We split this skill into the rules it gives an agent

6 rules. About 0 are common, 3 are distinctive, and 3 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 3

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use when at least one is true:

    line 19
  2. Distinctive:

    Do not use this skill for every ordinary implementation task just because it is non-trivial.

    line 28
  3. Very specific:

    Do not call optional or spec-only assets a fallback.

    line 37
  4. Very specific:

    Only active and adapter-installed may be *expected* by default.

    line 47
  5. Distinctive:

    If a fitting *expected* capability is not used, state why.

    line 68
  6. Very specific:

    If an expected active capability is unavailable, go to no-silent-fallback (which logs it via scripts/fallback_log.sh).

    line 69

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “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

Capability Routing

This skill absorbs two former skills: trigger-calibration (the silent/speak/fallback decision) and runtime-capability-map (the availability classes). They are sections here, not separate files — one decision, one place.

When To Use

Use when at least one is true:

  • the user asks for review, audit, research, close, fallback handling, or memory/learning;
  • the project has a memory/ folder and the task needs continuity, ledger state, prior fallback, or capability memory;
  • the prompt obviously matches a known skill/subagent/tool;
  • a previous fallback suggests a capability should exist;
  • current work touches container capability files.

Do not use this skill for every ordinary implementation task just because it is non-trivial.

Step 1 — Calibrate (pick exactly one)

  • silent-route: a fitting active capability exists and can run normally → use it, do not narrate.
  • speak-up: risk, gate, contradiction, explicit user request, or close/handoff needs visible output.
  • fallback: an expected capability cannot run or was replaced/weakened/skipped → go to no-silent-fallback.
  • do-nothing: no container capability is relevant.

Do not call optional or spec-only assets a fallback. Do not narrate silent-route.

Step 2 — Classify availability (only what's relevant)

  • active: currently callable in this host runtime (skills here, and the backbone scripts in scripts/).
  • adapter-installed: installed by a host adapter and expected for this project.
  • spec-only: documented prompt/spec asset, not automatically callable (e.g. the non-wired hooks).
  • manual: available only by explicit invocation (e.g. the project-template installer).
  • unavailable: not present or blocked.

Only active and adapter-installed may be expected by default. spec-only/manual become expected only when the user asks, the plan promised them, or memory/ files require them.

Step 3 — Route to the concrete capability

Match the task to a capability and run it. The backbone scripts make the action deterministic — prefer them over doing the write/close/log by hand:

TaskCapabilityConcrete call
Persist a durable fact/lesson/decisionmemory-routingscripts/memory_route.sh
Carry open to-do items forward(ledger)scripts/ledger_carry.sh
Record a real fallbackno-silent-fallbackscripts/fallback_log.sh
Close / handoff a sessionsession-closescripts/session_close.sh
Check declared-vs-actual driftcapability-auditscripts/capability_audit.sh

(In Claude Code the scripts live at ${CLAUDE_PLUGIN_ROOT}/scripts/; pass the project's --memory-dir ./memory.)

Step 4 — Account for what you skipped

  • If a fitting expected capability is not used, state why.
  • If an expected active capability is unavailable, go to no-silent-fallback (which logs it via scripts/fallback_log.sh).

Verification

  • Relevant active capabilities were checked.
  • Used capability is visible in the final close when continuity matters.
  • A skipped/unavailable expected capability is reported as a fallback, not swallowed.

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.