setup

A setup command that creates or refreshes a local inventory of installed coding-agent skills and surfaces important issues. It supports both a manual first-run setup and an automatic setup before another command.

In plain words
What is it for?
Use it to initialize SkillCompass, scan available skills, migrate an older setup marker, and account for extra skill directories or OpenClaw configuration.
Why use it?
It helps the agent know which skills are available and catches high-signal configuration problems early. Automatic setup can return to the user's original request afterward.

Command

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/evol-ai/skillcompass/setup
Clone the repo
git clone --depth 1 https://github.com/Evol-ai/SkillCompass
Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 3,775 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.03775
Opus 5 $0.00000 $0.01887
Sonnet 5 $0.00000 $0.00755
Haiku 4.5 $0.00000 $0.00378

Measured 2d ago against content hash 2b4f10e91c10, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade B, and why

setup scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

After smart guidance, check if `~/.claude/settings.json` already has a `statusLine` configured.
commands/setup.md · 361 lines

How it starts

The opening of the file, as written. The whole thing — 361 lines — stays where its author put it; the contents beside it link to each section on GitHub.

/setup - Skill Inventory & Health Check

This command gives users a quick local inventory of installed skills and surfaces only high-signal issues. It supports two modes:

  • Manual mode: the user explicitly runs /setup or /skill-compass setup
  • Auto-trigger mode: first-run helper shown before another command

In auto-trigger mode, setup must never replace or derail the user's original request. Its job is to help briefly, save state, and return control to the dispatcher.

Step 1: Determine Mode and Load State

  1. Detect whether setup was invoked manually or as a first-run auto-trigger.
  2. If auto-triggered, preserve the original command name and arguments as resume_command and resume_args.
  3. Use .skill-compass/setup-state.json as the primary persisted state file.
  4. For backward compatibility, if .skill-compass/setup-state.json is missing but .skill-compass/.setup-done exists, read the legacy marker and migrate the minimal fields into setup-state.json.
  5. Load the standard OpenClaw config file ~/.openclaw/openclaw.json if it exists. If present, read optional extra skill roots from skills.load.extraDirs.
  6. If setup was auto-triggered and a current setup state already exists, return control to the dispatcher immediately so it can continue the original command.

Step 2: Confirm Auto-Trigger (auto-trigger mode only)

When auto-triggered, ask the user first:

Quick skill inventory (~5 sec) before continuing {resume_command}? [OK / Skip]

  • If the user says Skip:
    • Write .skill-compass/setup-state.json with {"version": 1, "skipped": true, "timestamp": "{ISO}"}
    • Also write .skill-compass/.setup-done for compatibility
    • Return control to the dispatcher immediately so it can continue the original command
  • If the user agrees:
    • Continue with setup

Manual /setup does not need this confirmation.

Step 3: Discover Skills

Build the scan root list in this priority order:

  1. .claude/skills/ (project-level Claude Code)
  2. .openclaw/skills/ (project-level OpenClaw, if present)
  3. Each path listed in skills.load.extraDirs from ~/.openclaw/openclaw.json
  4. ~/.claude/skills/ (user-level Claude Code)
  5. ~/.openclaw/skills/ (user-level OpenClaw, if present)

Read the full file on GitHub · 361 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 361 lines · 0 tokens per session scan B 2b4f10e91c10

Subscribe to this mod's changes

setup is a command published in the GitHub repository Evol-ai/SkillCompass (216 stars, last pushed 4mo ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 3,775 tokens. A static security scan graded it B with 1 finding (reads agent configuration directories). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.