Commands

Command overview

The jsm CLI groups functionality into subcommands. Run jsm --help for a full list, or jsm <command> --help for details on any command.

Global flags

Environment variable JSM_OFFLINE=1 is equivalent to --offline.

Authentication

jsm login

Open browser-based OAuth to authenticate with jeffreys-skills.md.

jsm logout

Clear stored credentials.

jsm whoami

Print the current user, email, and subscription status.

jsm auth set-key <key>

Set an API key directly (format: jsm_xxx). Useful in CI or headless environments.

Setup & diagnostics

jsm setup

Run the first-time setup wizard. Configures your projects directory and skill directories. Pass --force to re-run.

jsm doctor

Check authentication, skill directories, database integrity, network connectivity, and CLI version. Pass --fix to auto-repair common issues.

jsm status

Print a summary of mode, sync state, and installed skills.

jsm verify [skill]

Verify integrity of installed skills. Omit the skill name to verify all.

Browsing & discovery

jsm list

List installed skills. Useful filters:

jsm search <query>

Full-text search across the skill catalog. Uses a local Tantivy index when offline.

jsm search "code review" --limit 5

jsm show <skill>

Display detailed metadata, description, and install status for a skill. jsm info is an alias.

jsm featured

Show the currently featured skill. Pass --install to install it immediately, or --history to see past features.

jsm tags

List all available compatibility tags.

jsm related <skill>

Show skills related to the given skill, grouped by relationship type (pairs_with, alternative_to, extends, prerequisite). Pass --all to see relationships for every installed skill.

jsm examples <skill>

Show curated usage examples for a skill.

jsm why <skill>

Display the author's notes explaining why a skill exists.

jsm suggest [query]

Context-aware skill suggestions based on your current project. Analyzes files in the working directory and recommends matching skills.

jsm suggest --add-to-project

jsm context [path]

Analyze a project directory and display detected context tags (language, framework, tooling).

Installation & updates

jsm install <skill>

Install a skill to your managed agent skills directories (~/.claude/skills/, ~/.codex/skills/, and ~/.gemini/skills/ by default).

jsm install code-review-expert
jsm install code-review-expert --version 3
jsm install code-review-expert --related   # also install related skills

jsm uninstall <skills...>

Remove one or more installed skills. Pass --all to remove everything, or --keep-data to preserve per-skill configuration.

jsm sync [skill]

Sync saved skills between local and cloud. Omit the skill name to sync all.

jsm sync                    # sync everything
jsm sync --force            # force re-download
jsm sync --org acme         # sync team skills
jsm sync --status           # show sync status only

jsm upgrade [skill]

Check for and apply skill updates. Pass --list to preview without applying.

Version management

jsm pin <skill> [version]

Pin a skill to a specific version. Pinned skills are excluded from automatic updates.

jsm unpin <skill>

Remove the version pin so the skill receives updates again.

jsm versions <skill>

List all published versions of a skill.

jsm diff <skill>

Show a diff between the installed version and the latest (or between two specified versions).

jsm diff my-skill --from 2 --to 5

jsm changelog [skill]

Show recent changes across your installed skills, or for a specific skill. Defaults to the last 7 days.

jsm rollback <skill>

Roll back to the previous version. Pass --to <version> to target a specific version.

Skill development

jsm create <name>

Scaffold a new skill from a template.

jsm create my-new-skill -c "code-quality" -d "Enforces lint rules"
jsm create my-new-skill --with-self-test

jsm validate [path]

Validate skill structure, SKILL.md format, and metadata. Runs automatically before jsm push.

jsm push <path>

Upload a skill to jeffreys-skills.md for review.

jsm push ./my-skill -m "Added Python support" --attest

The --attest flag confirms you have distribution rights.

Workspace management

jsm workspace init [path]

Initialize a skill development workspace. Pass --git to create a Git repository.

jsm workspace mirror [skills...]

Copy workspace skills to the global ~/.claude/skills/ directory. Pass --watch to auto-sync on file changes.

jsm workspace status

Show the status of skills in the current workspace.

jsm workspace diff

Show changes between workspace copies and installed versions.

jsm workspace clean

Remove stale workspace artifacts. Pass --dry-run to preview.

Project integration

jsm project add <skills...>

Add skills to .claude/skills/ in the current repository so they are available in project-scoped Claude Code sessions.

jsm project list

List skills configured for the current repository.

jsm project remove <skills...>

Remove skills from the repository configuration.

jsm project sync

Sync project-level skills with the latest installed versions.

jsm project fix-gitignore

Ensure .claude/skills/ is listed in .gitignore.

Workflows

jsm workflow list

List available skill workflows.

jsm workflow run <name>

Generate step-by-step prompts for a named workflow. Pass --edit to open the output in your editor.

Community requests

jsm requests list

Browse open skill requests. Filter with --mine, --status, or --limit.

jsm requests trending

Show the most-voted skill requests.

jsm requests vote <id> / jsm requests unvote <id>

Vote or remove your vote on a request.

jsm requests new

Interactively create a new skill request.

Notifications

jsm notify check

Check for available skill updates.

jsm notify list

View the notification feed. Pass --unread for unread only.

jsm notify read <ids...>

Mark notifications as read. Pass --all to clear everything.

jsm notify config

View or modify notification settings (email, webhook, frequency).

Effectiveness tracking

jsm effectiveness record

Record a skill outcome (success/failure, duration, context).

jsm effectiveness record -s code-review --success --duration-seconds 120

jsm effectiveness show

Display effectiveness metrics for a skill.

jsm outcome

Ergonomic alias for effectiveness record.

Graph analysis

jsm graph insights

Full analysis: keystones, bottlenecks, clusters, and cycles.

jsm graph keystones

Show the most-connected skills by PageRank.

jsm graph bottlenecks

Show skills with highest betweenness centrality.

jsm graph clusters

Detect and display skill clusters.

jsm graph tree <skill>

Print a dependency tree for a skill.

jsm graph cycles

Detect dependency cycles.

jsm graph export

Export the skill graph in Mermaid, DOT, or JSON format.

jsm graph export --format mermaid -o graph.md

Compilation

jsm compile <path>

Compile a skill into a standalone MCP server binary. Also available as jsm build.

jsm compile ./my-skill -o my-skill-server
jsm compile ./my-skill --transport http --port 9090
jsm compile ./skills-dir --bundle --bundle-name all-skills

Key flags:

Team features

jsm team collections list --org <org>

List skill collections for a team organization.

jsm team collections show <collection> --org <org>

Show skills in a specific collection.

Vault (encrypted offline storage)

jsm vault init

Create an encrypted vault for offline skill storage.

jsm vault status

Show vault status and statistics.

jsm vault lock / jsm vault unlock

Lock or unlock the vault.

jsm vault set-auto-lock <minutes>

Configure automatic locking after inactivity.

Telemetry (opt-in)

jsm telemetry enable / jsm telemetry disable

Opt in or out of anonymous usage analytics.

jsm telemetry status

Show current telemetry state.

jsm telemetry flush

Send pending telemetry events to the server.

CASS integration

jsm cass status

Check CASS installation and configuration.

jsm cass search <query>

Search past agent sessions by keyword.

jsm cass list

List recent sessions.

jsm cass show <session_id>

Display full session details.

jsm cass mine [topic]

Mine sessions for patterns and generate skill drafts.

jsm cass mine "error handling" --days 30 -o ./drafts

Configuration

jsm config show

Print the current configuration.

jsm config get <key>

Read a single configuration value.

jsm config set <key> <value>

Set a configuration value. See the configuration guide for available keys.

jsm config reset

Reset all configuration to defaults.

jsm completions install

Install shell completions for bash, zsh, or fish.

Compliance

jsm report-leak <url>

Report a suspected unauthorized copy of a premium skill.