Skip to content

livevil7/claude-compass

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Compass

Never wonder which plugin to use again.

Compass is a skill navigator for Claude Code. It scans your installed plugins, finds the best skill for your task, and runs it — all from a single command.

The Problem

You installed 10+ plugins. That's 50+ slash commands. You can't remember them all, and you don't know which combination works best for your task.

The Solution

You: /compass:c build a login page with social auth

Compass — Skill Scan
┌────┬──────────────────┬──────────┬─────────────────────┐
│ #  │ Skill            │ Domain   │ What it does        │
├────┼──────────────────┼──────────┼─────────────────────┤
│ 1  │ /frontend-design │ Frontend │ High-quality UI     │
│ 2  │ /bkend-auth      │ Backend  │ Auth & security     │
│ 3  │ /code-review     │ Quality  │ PR code review      │
│ .. │ ...              │ ...      │ ...                 │
└────┴──────────────────┴──────────┴─────────────────────┘
Total: 12 skills from 4 plugins

Compass — Recommendation

> "Build a login page with social auth"

│ Order │ Skill            │ Reason              │
│ 1st   │ /bkend-auth      │ Social auth logic   │
│ 2nd   │ /frontend-design │ Login page UI       │

Proceed with /bkend-auth? (y/n)

Type y and Compass runs the skill immediately.

Installation

Option 1: Load directly from GitHub (Recommended)

Clone the repo and load it with --plugin-dir:

git clone https://github.com/livevil7/claude-compass.git
claude --plugin-dir ./claude-compass

Then use /compass:c inside Claude Code.

Option 2: Copy to your commands (Quick setup)

Copy the skill file to your user-level commands for a shorter /c command:

mkdir -p ~/.claude/commands
curl -o ~/.claude/commands/c.md https://raw.githubusercontent.com/livevil7/claude-compass/master/skills/c/SKILL.md

Restart Claude Code, then use /c directly.

Option 3: Load as a local plugin

If you already cloned the repo:

claude --plugin-dir /path/to/claude-compass

Usage

/compass:c <what you want to do>

Or if installed as a user command:

/c <what you want to do>

Examples

You type Compass recommends
/c build a dashboard /frontend-design
/c review my PR /code-review → /commit-push-pr
/c deploy to production /phase-9-deployment + /sentry-setup-tracing
/c I'm new, where do I start? /first-claude-code
/c set up error tracking /sentry

How It Works

  1. Scan — Lists all installed skills in the current session
  2. Recommend — Matches your request to the best skill(s)
  3. Execute — Runs the chosen skill on your confirmation

Features

  • Works with ANY combination of installed plugins
  • Compares overlapping skills and explains the difference
  • Recommends execution order for multi-skill workflows
  • Max 5 recommendations (no overwhelm)
  • Responds in your language (EN, KO, JA, ZH, ES, FR, DE, IT)

Requirements

  • Claude Code v1.0.33+
  • 2+ plugins installed (otherwise you don't need a navigator)

License

MIT

About

Skill navigator for Claude Code. Scans installed plugins, recommends the best skill, and executes it. Just type /c.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors