Solomon Skills Installer

Install Solomon workforce management skills for Claude Code globally. Once installed, use /solomon commands from any project directory.

Prerequisites

• Node.js 20+ (for npx)
• Claude Code installed (~/.claude/ must exist)
• Python 3 (optional, for standup-to-timelog YAML parsing)

Quick Start

Option 1: One-liner (recommended)

curl -fsSL https://api.solomon.kitemetric.com/claude-skills/install.sh | bash

Option 2: npx

npx solomon-skills install

Option 3: From repo clone

# Shell (requires jq)
bash packages/solomon-skills/install.sh

# Python (no extra deps)
python3 packages/solomon-skills/install.py

Commands

| Command | Description | |---------|-------------| | solomon-skills install | Full setup: skills, config, permissions, Composio MCP | | solomon-skills update | Refresh skill files (preserves your .env config) | | solomon-skills uninstall | Remove skills and optionally clean up all config | | solomon-skills status | Health check of your installation |

What Gets Installed

| Component | Location | |-----------|----------| | Skills (20 endpoints) | ~/.claude/skills/solomon/ and ~/.claude/skills/solomon:*/ | | User config | ~/.claude/skills/solomon/.env | | Data directory | ~/.claude/solomon/ (cache, drafts) | | Permissions | ~/.claude/settings.json (Write/Edit for data dir) | | Composio MCP | ~/.claude.json (optional) |

Configuration

The installer creates ~/.claude/skills/solomon/.env with these values:

| Variable | Required | Default | |----------|----------|---------| | SOLOMON_API_TOKEN | Yes | — | | SOLOMON_API_URL | Yes | — | | SOLOMON_TIMEZONE | No | Auto-detected | | SOLOMON_DATA_DIR | No | ~/.claude/solomon |

Available Skills

After installation, these commands are available in Claude Code:

/solomon                    Route to any Solomon command
/solomon:lookup             Look up people, projects, or your own profile
/solomon:timelog            Create time entries (work, OOO, WFH, standup text)
/solomon:report             View hours, insights, summary, confirmation status
/solomon:confirm            Finalize time entries
/solomon:slack-timelog      Generate timelogs from Slack standups
/solomon:capacity           Capacity and utilization report
/solomon:events             Company events and holidays
/solomon:reviews            OOO/overtime approvals
/solomon:api                API explorer, token management

Updating

npx solomon-skills update

This refreshes all skill files while preserving your .env configuration.

Uninstalling

npx solomon-skills uninstall

The uninstaller will ask before removing each component (skills, data, permissions, Composio MCP).

Publishing (Maintainers)

cd packages/solomon-skills
npm publish  # runs prepublishOnly to bundle skills automatically

Requires npm auth for @kitemetric-company scope on GitHub Packages.

Composio MCP Setup

The installer can configure Composio MCP in ~/.claude.json for Slack features (e.g., /solomon:slack-timelog).

Prerequisites: Create a free account at https://platform.composio.dev and link your Slack workspace.

Option A — Interactive OAuth (no secrets in config):

• The installer writes just the URL. Authenticate via /mcp in Claude Code on first use.

Option B — Consumer API key (skip auth prompt):

• Get your key from the Composio dashboard → AI Clients section.
• The installer writes the URL + your key in the headers field.