sx

sx is a package manager for AI coding assistants. Create, version, and distribute reusable AI tools across your entire team. Think NPM for AI agents -- install once, use everywhere.

Why sx?

• Onboard new developers instantly with your team's tribal knowledge
• Expand successful AI use from experts to everyone
• Spread best practices to any AI tool (coming soon)

Quickstart

curl -fsSL https://raw.githubusercontent.com/sleuth-io/sx/main/install.sh | bash

then

# Initialize
sx init

# Add an asset from your vault
sx add /path/to/my-skill

# Install assets to your current project
sx install

Already using Claude Code?

If you've built up skills, commands, or MCP configs in your .claude directory, sx helps you version, sync across machines, and share with teammates.

# Add your existing skills/commands (sx auto-detects the type)
sx add ~/.claude/commands/my-command
sx add ~/.claude/skills/my-skill

Your prompt files stay exactly as they are - sx just wraps them with metadata for versioning.

What can you build and share?

• Skills - Custom prompts and behaviors for specific tasks
• Agents - Autonomous AI agents with specific goals
• Commands - Slash commands for quick actions
• Hooks - Automation triggers for lifecycle events
• MCP Servers (experimental) - Model Context Protocol (MCP) servers for external integrations

Distribution models

Choose the right distribution model for your team:

Local (Personal)

Perfect for easily sharing personal tools across multiple personal projects

sx init --type path --path my/vault/path

Git vault (Small teams)

Share assets through a shared git vault

sx init --type git --repo [email protected]:yourteam/skills.git

Skills.new (Large teams and enterprise)

Centralized, effortless management with a UI for discovery, creation, and sharing at scale

sx init --type sleuth

How it works

sx uses a lock file, like package-lock.json, for deterministic installations in the right context:

1. Create assets with metadata (name, version, dependencies)
2. Publish to your chosen vault
3. Share the asset globally, per repository, or even per path in a repository (monorepo support!)
4. Auto-install on new Claude Code sessions
5. Stay synchronized - everyone gets the same tools automatically

Supported Clients

Client	Status	Notes
Claude Code	✅ Supported	Full support for all asset types
Cursor	✅ Experimental	Skills, MCP servers, commands, hooks
GitHub Copilot	Coming soon
Gemini	Coming soon
Codex	Coming soon

Roadmap

• ✅ Local, Git, and Skills.new vaults
• ✅ Claude Code support
• ✅ Cursor support (experimental)
• More clients - GitHub Copilot, Gemini, Codex
• Skill discovery - Use Skills.new to discover relevant skills from your code and architecture
• Analytics - Track skill usage and impact

License

See LICENSE file for details.

---

Development

Click to expand development instructions

Documentation

• Vault Spec - Skills vault structure
• Metadata Spec - Skill metadata format
• Lock Spec - Lock file format

Prerequisites

Go 1.25 or later is required. Install using gvm:

# Install gvm
bash < <(curl -s -S -L https://raw.githubusercontent.com/moovweb/gvm/master/binscripts/gvm-installer)

# Install Go (use go1.4 as bootstrap if needed)
gvm install go1.4 -B
gvm use go1.4
export GOROOT_BOOTSTRAP=$GOROOT
gvm install go1.25
gvm use go1.25 --default

Building from Source

make init           # First time setup (install tools, download deps)
make build          # Build binary
make install        # Install to GOPATH/bin

Testing

make test           # Run tests with race detection
make format         # Format code with gofmt
make lint           # Run golangci-lint
make prepush        # Run before pushing (format, lint, test, build)

Releases

Tag and push to trigger automated release via GoReleaser:

git tag v0.1.0
git push origin v0.1.0