Documentation

SkillsDojo lets you manage private AI agent skill collections that work with skills.sh. Share skills across your team and sync them between applications.

Installation

Install the SkillsDojo CLI globally:

npm install -g skillsd

Requires Node.js 18 or later. Works alongside the skills.sh CLI.

Authentication

Login with API token

skillsd auth login --token YOUR_API_KEY

Get your API key from Settings → API Keys

Check login status

skillsd auth whoami

Quick Start

Link your project to a SkillsDojo collection and start adding skills:

# Link current directory to a collection
skillsd link my-account/my-collection --create

# Search for skills on skills.sh
npx skills find "commit"

# Add a skill from skills.sh
npx skills add marcelorodrigo/agent-skills@conventional-commit -y

# Check what changed
skillsd status

# Push to SkillsDojo (creates a PR)
skillsd push -t "Add conventional-commit skill"

Workflow

1. Link your project

skillsd link account/collection

Creates .skillsdojo/ config and .agents/skills/ directory. Use --create to create a new collection.

2. Add skills from skills.sh

# Search for skills
npx skills find "your query"

# Add a skill
npx skills add owner/repo@skill-name -y

Skills are installed to .agents/skills/ and automatically configured for Claude Code, Cursor, and other AI agents.

3. Check status

skillsd status

Shows new, modified, and deleted skills compared to the remote collection.

4. Push changes

skillsd push -t "Add new skills"

Creates a pull request with your changes. Merge via the web UI.

Clone Existing Collection

Download an existing collection with all its skills:

# Clone a collection
skillsd clone account/collection

# Work in the cloned directory
cd collection
skillsd status

Finding Skills

Search skills.sh

# Interactive search
npx skills find

# Search with query
npx skills find "code review"

List skills from a repository

npx skills add owner/repo -l

Command Reference

Command	Description
`skillsd auth login`	Login to SkillsDojo
`skillsd auth whoami`	Show current user
`skillsd link <collection>`	Link directory to collection
`skillsd clone <collection>`	Clone a collection locally
`skillsd status`	Show local changes
`skillsd push`	Push changes as PR
`skillsd collection list`	List your collections
`skillsd collection create`	Create new collection
`skillsd skill list`	List skills in collection
`skillsd download`	Download collection as ZIP
`npx skills find`	Search skills.sh
`npx skills add`	Add skill from skills.sh

Need help?

Run skillsd --help for all commands. Visit skills.sh to browse community skills.