All skills
simota avatar

/compass

@35ffd55
by shingo imotasimota/agent-skills85 stars
15

Navigating the skill ecosystem and guiding onboarding. Lists agents, recommends best fit for tasks. Don't use for task execution (Nexus), agent design (Architect).

Use this Skill: https://skilld.dev/gh/simota/agent-skills/compass

This session only. Nothing lands on disk.

referencegap-report.md

≈358 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Gap Report (Gap mode output)

Purpose: Minimal structure for the artifact Compass emits when no skill fits a request (Gap mode), so the LADDER's compass step produces a verifiable output instead of a bare "no match" statement. Read when: Running Gap mode (no matching skill found during recommend / classify).

Structure

## Gap Report
Unmatched input: [the user's request, verbatim or lightly paraphrased]
Nearest skills:
- [skill-1]: [why it doesn't fit — the specific capability/scope gap]
- [skill-2]: [why it doesn't fit]
- [skill-3]: [why it doesn't fit] (omit if fewer than 3 skills are plausibly close)
Next action: [propose-new-skill (hand off to Architect via `COMPASS_TO_ARCHITECT`) | generic-execution (no skill class fits; proceed ad-hoc) | boundary (the act is outside what any skill may perform — e.g. licensed-human-only filings; see `nexus/reference/routing-matrix.md` LADDER non-closable-gap note)]

Every field is required — an empty "Nearest skills" list (zero candidates considered) or a missing "Next action" makes the report unverifiable and defeats the point of Gap mode.

Handoff

propose-new-skill → send the Gap Report as the payload of COMPASS_TO_ARCHITECT (see compass/SKILL.md § Collaboration). Architect returns a gap-fill proposal or declines with a reason; either way the LADDER's fallback_taken field records the outcome (architect-invoked).

Source: SKILL.md on GitHub

1 warning13d4 checks · Risk SAFE
  • Gen Agent Trust Hub13d

    The Compass skill functions as a navigator and onboarding guide for a large ecosystem of AI agents. It recommends the most appropriate agents for a given task by analyzing the project's technology stack through repository configuration files (like package.json). Although it reads external data which creates a surface for indirect prompt injection, the skill's capabilities are strictly limited to providing guidance and navigation, with no access to network exfiltration or arbitrary code execution, resulting in a low overall risk.

  • Socket13d

    No alerts

  • Snyk13d

    Risk: MEDIUM · 1 issue

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at 35ffd55. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 days ago.

Activeupdated 2 weeks ago

README badge

README badge for simota/agent-skills/compass