Fernando Ramos← All skills02 of 09
← All skills

/compass

Orient · Decision-tree skill router

Routes task intent to a single installed skill, probes its declared branch tools before loading the skill body, and refreshes the discovery index.

npx skills@latest add luci-efe/skills -s compass

  • OrientStage
  • 06 Autonomy with ownershipMethod
  • .ramos/cache/skills.jsonProduced artifact / output

Use when

Choosing the next engineering skill, discovering installed workflows, or checking prerequisites before a branch.

Support & adapters

  • Instructions usable across harnesses
  • Hooks tested: Claude Code

Decision tree

  1. 01

    Explicit skill named by user

    Select that skill directly and probe its target branch prerequisites before reading SKILL.md

    → User intent preserved
  2. 02

    No skill named

    Run node <this skill dir>/scripts/compass.mjs route "<task>" across at most three candidate metadata entries

    → Single skill + branch selected
  3. 03

    Prerequisite probe fails

    Show exact known install command and block only that branch; never auto-install or silently switch providers

    → Explicit branch blocker
  4. 04

    Index refresh or prompt hook

    compass.mjs index refreshes .ramos/cache/skills.json; compass.mjs nudge emits at most one advisory line

    → Fresh metadata cache

Prerequisites & install recipes

  • noderequired · default branchnode
    brew install node

Completion criteria

  • A receipt identifies one selected skill/branch, reason, entrypoint, fresh prerequisite results, and expected artifact schema.
  • Emits at most one non-blocking advisory line on UserPromptSubmit without probing or calling a model.
  • Returns control to the task owner if traversal revisits a skill or exceeds three transitions.

View skill source on GitHub

Want something like this built for your company?

Book a callMessage me on LinkedInSee Agentic Engineering
← All skills