Getting Started

Installation

npm install -g homingo

Prerequisites

• Node.js >= 20
• An API key for Anthropic or OpenAI

Initialize a Project

homingo init

This creates ~/.homingo/config.json (in your home directory) and scaffolds a skills directory with a sample SKILL.md.

Instant Fleet Health Check

Once you have skills in your skills directory, get an instant health check:

homingo scan

Scan runs locally in under a second with zero API calls. It analyzes skill overlaps using heuristic scoring and checks for scope overload, giving you:

• A fleet health score (0–100)
• Conflicting skill pairs ranked by severity
• Scope overload warnings
• Clear next steps

Deep Diagnostic

When scan surfaces issues, dig deeper with a full routing audit:

homingo audit

Audit uses LLM-powered routing simulation — it generates adversarial prompts and measures actual routing accuracy. This takes longer but gives precise conflict data.

Pre-Deploy Validation

Before shipping a new or modified skill, lint it:

# Lint the full fleet
homingo lint

# Lint a single skill against its neighbors
homingo lint --skill my-new-skill

Lint runs adversarial routing tests, detects scope overload, and suggests description rewrites.

What's Next?

• Learn about each command: scan, audit, lint, init, logs
• Understand the core concepts: Routing Drift, Shadow Router, Scope Overload
• Configure thresholds and output: Configuration