JSPM – reskill@1.8.0

Package Exports

reskill
reskill/cli

Readme

Git-based Skills Package Manager for AI Agents

Declarative skill management like npm/Go modules — install, version, sync, and share AI agent skills

Quick Start

npx reskill@latest init
npx reskill@latest install github:anthropics/skills/skills/frontend-design@latest
npx reskill@latest list

Features

One-click install — Install any skill from any Git repo with a single command
Declarative config — skills.json + skills.lock for team consistency
Flexible versioning — Exact versions, semver ranges, branches, commits
Multi-source — GitHub, GitLab, self-hosted repos, HTTP/OSS archives
Multi-agent — Cursor, Claude Code, Codex, Windsurf, GitHub Copilot, and more
Registry support — Publish and share skills via registry

Installation

Requirements: Node.js >= 18.0.0

npm install -g reskill        # Global install
npx reskill@latest <command>  # Or use npx directly

Commands

Command	Alias	Description
`init`	-	Initialize `skills.json`
`install [skills...]`	`i`	Install one or more skills
`list`	`ls`	List installed skills
`info <skill>`	-	Show skill details
`update [skill]`	`up`	Update skills
`outdated`	-	Check for outdated skills
`uninstall <skill>`	`un`, `rm`, `remove`	Remove a skill
`publish [path]`	`pub`	Publish a skill to the registry ¹
`login`	-	Authenticate with the registry ¹
`logout`	-	Remove stored authentication ¹
`whoami`	-	Display current logged in user ¹
`doctor`	-	Diagnose environment and check for issues

¹ Registry commands (publish, login, logout, whoami) require a private registry deployment. Not available for public use yet. | completion install | - | Install shell tab completion |

Common Options

Option	Commands	Description
`--no-save`	`install`	Install without saving to `skills.json` (for personal skills)
`-g, --global`	`install`, `uninstall`, `list`	Install/manage skills globally (user directory)
`-a, --agent <agents...>`	`install`	Specify target agents (e.g., `cursor`, `claude-code`)
`--mode <mode>`	`install`	Installation mode: `symlink` (default) or `copy`
`--all`	`install`	Install to all agents
`-y, --yes`	`install`, `uninstall`, `publish`	Skip confirmation prompts
`-f, --force`	`install`	Force reinstall even if already installed
`-j, --json`	`list`, `info`, `outdated`, `doctor`	Output as JSON

Run reskill <command> --help for complete options and detailed usage.

Source Formats

# GitHub shorthand
npx reskill@latest install github:user/skill@v1.0.0

# GitLab shorthand
npx reskill@latest install gitlab:group/skill@latest

# Full Git URL (HTTPS)
npx reskill@latest install https://github.com/user/skill.git

# Full Git URL (SSH)
npx reskill@latest install git@github.com:user/skill.git

# GitHub/GitLab web URL (with branch and subpath)
npx reskill@latest install https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines

# Custom registry (self-hosted GitLab, etc.)
npx reskill@latest install gitlab.company.com:team/skill@v1.0.0

# HTTP/OSS archives
npx reskill@latest install https://example.com/skills/my-skill-v1.0.0.tar.gz
npx reskill@latest install oss://bucket/path/skill.tar.gz
npx reskill@latest install s3://bucket/path/skill.zip

# Install multiple skills at once
npx reskill@latest install github:user/skill1 github:user/skill2@v1.0.0

Monorepo Support

For repositories containing multiple skills (monorepo), specify the path to the skill directory:

# Shorthand format with subpath
npx reskill@latest install github:org/monorepo/skills/planning@v1.0.0
npx reskill@latest install gitlab:company/skills/frontend/components@latest

# URL format with subpath
npx reskill@latest install https://github.com/org/monorepo.git/skills/planning@v1.0.0
npx reskill@latest install git@gitlab.company.com:team/skills.git/backend/apis@v2.0.0

# GitHub web URL automatically extracts subpath
npx reskill@latest install https://github.com/org/monorepo/tree/main/skills/planning

Requirements: The specified directory must contain a valid SKILL.md file following the Agent Skills Specification.

HTTP/OSS URL Support

Skills can be installed directly from HTTP/HTTPS URLs pointing to archive files:

Format	Example	Description
HTTPS URL	`https://example.com/skill.tar.gz`	Direct download URL
Aliyun OSS	`https://bucket.oss-cn-hangzhou.aliyuncs.com/skill.tar.gz`	Aliyun OSS URL
AWS S3	`https://bucket.s3.amazonaws.com/skill.tar.gz`	AWS S3 URL
OSS Protocol	`oss://bucket/path/skill.tar.gz`	Shorthand for Aliyun OSS
S3 Protocol	`s3://bucket/path/skill.tar.gz`	Shorthand for AWS S3

Supported archive formats: .tar.gz, .tgz, .zip, .tar

Version Specification

Format	Example	Description
Exact	`@v1.0.0`	Lock to specific tag
Latest	`@latest`	Get the latest tag
Range	`@^2.0.0`	Semver compatible (>=2.0.0 <3.0.0)
Branch	`@branch:develop`	Specific branch
Commit	`@commit:abc1234`	Specific commit hash
(none)	-	Default branch (main)

Configuration

skills.json

{
  "skills": {
    "planning": "github:user/planning-skill@v1.0.0",
    "internal-tool": "internal:team/tool@latest"
  },
  "registries": {
    "internal": "https://gitlab.company.com"
  },
  "defaults": {
    "installDir": ".skills",
    "targetAgents": ["cursor", "claude-code"],
    "installMode": "symlink"
  }
}

Private Repositories

reskill uses your existing git credentials (SSH keys or credential helper). For CI/CD:

# GitLab CI
git config --global url."https://gitlab-ci-token:${CI_JOB_TOKEN}@gitlab.company.com/".insteadOf "https://gitlab.company.com/"

Multi-Agent Support

Skills are installed to .skills/ by default and can be integrated with any agent:

Agent	Path
Cursor	`.cursor/rules/` or `.cursor/skills/`
Claude Code	`.claude/skills/`
Codex	`.codex/skills/`
Windsurf	`.windsurf/skills/`
GitHub Copilot	`.github/skills/`

Publishing Skills

Note: Publishing requires a private registry deployment. This feature is not available for public use yet.

Publish your skills to the registry for others to use:

# Login to the registry
reskill login

# Validate without publishing (dry run)
reskill publish --dry-run

# Publish the skill
reskill publish

For detailed publishing guidelines, see the CLI Specification.

Environment Variables

Variable	Description	Default
`RESKILL_CACHE_DIR`	Global cache directory	`~/.reskill-cache`
`RESKILL_TOKEN`	Auth token (takes precedence over ~/.reskillrc)	-
`RESKILL_REGISTRY`	Default registry URL	`https://registry.reskill.dev`
`DEBUG`	Enable debug logging	-
`NO_COLOR`	Disable colored output	-

Development

# Install dependencies
pnpm install

# Development mode
pnpm dev

# Build
pnpm build

# Run tests
pnpm test

# Run integration tests
pnpm test:integration

# Type check
pnpm typecheck

Acknowledgements

reskill was inspired by and references the implementations of these excellent projects:

add-skill by Vercel Labs
skild by Peiiii
openskills by Numman Ali

Agent Skills Specification

License

MIT

reskill