skls-mgr

简体中文

Maintain Agent Skills in a centralized local directory; Install on-demand across projects; Edit once, sync everywhere.

Why not vercel-labs/skills?

This project is inspired by vercel-labs/skills. We are grateful to the Vercel Labs team for their contribution to the Agent ecosystem.

Typical usage with vercel-labs/skills:

• Global install: skills are installed to ~/.agents/skills, then symlinked into another tool's global skill directory, such as ~/.claude/skills.
• Project install: skills are installed to ./.agents/skills, then symlinked into another tool's project skill directory, such as ./.claude/skills.
• Local skills: local skills are copied into .agents/skills at the global or project level, then symlinked into the target tool's global or project skill directory.
• Reinstalling the same skill across multiple projects requires repeating the add command and recreating the skill files.

Typical usage with skls-mgr:

• Skills are stored centrally in ~/.config/skls-mgr.
• Skills can be symlinked on demand into any global or project-level tool skill directory, such as ~/.claude/skills.
• Local skills can be placed directly in ~/.config/skls-mgr and managed in one place.
• Reinstalling the same skill across multiple projects only requires install to pick from the collected skills, without repeating add or recreating files.

skls-mgr simplifies skill management by keeping maintenance centralized and linking skills only where needed.

Quick Start

Find your target skills on skills.sh, and simply replace skills with skls-mgr in the installation command:

npx skls-mgr add https://github.com/vercel-labs/skills --skill find-skills

Once installed, the skills will be copied to the ~/.config/skls-mgr directory. You can then run the following in any project:

npx skls-mgr install

Select the skills required for your project through the interactive interface. The installation is complete once confirmed.

Adding Skills

npx skls-mgr add <source>

By default, this opens an interactive interface listing all available skills from the source.

Options

| Option | Description | | ------------------------ | -------------------------------------------------------------- | | -s, --skill <names...> | Specify skill names directly to skip the interactive selection |

Examples

# GitHub shorthand (owner/repo)
npx skls-mgr add vercel-labs/skills

# GitHub repository URL
npx skls-mgr add https://github.com/vercel-labs/skills

# Sub-path within a GitHub repository
npx skls-mgr add https://github.com/vercel-labs/skills/tree/main/skills/find-skills

# Any Git URL
npx skls-mgr add https://github.com/vercel-labs/skills.git
npx skls-mgr add [email protected]:vercel-labs/skills.git

# Local path (copy)
npx skls-mgr add ./my-local-skills

# Install specific skills (repeated flags)
npx skls-mgr add vercel-labs/agent-skills --skill frontend-design --skill skill-creator

# Install specific skills (multiple names after a single flag)
npx skls-mgr add vercel-labs/agent-skills --skill frontend-design skill-creator

Conflict Resolution

If the directory name of the skill being installed conflicts with an existing top-level directory in ~/.config/skls-mgr:

• Interactive Mode: You will be prompted to enter a new directory name.
• Non-interactive Mode: If --skill is used, the command will terminate immediately without automatic renaming.

Installing to Projects

npx skls-mgr install

By default, this opens an interactive interface listing all top-level directories in ~/.config/skls-mgr (including manually created skills).

Options

| Option | Description | | ------------------------ | --------------------------------------------------------------------------------------------------- | | -s, --skill <names...> | Install specified skills directly and skip the interactive selection. | | -a, --all | Install all skills. If not specified, allows interactive selection. | | -d, --dir <path> | Install to the target directory (absolute or relative). If not specified, allows interactive input. | | -l, --link | Use symbolic links. | | -c, --copy | Use direct copy. |

Examples

# Interactive installation to a project
npx skls-mgr install

# Install specific skills without interactive selection
npx skls-mgr install --skill skill-one skill-two --dir ./.claude/skills --link

# Copy all skills to the Claude Code skills directory
npx skls-mgr install --all --dir ./.claude/skills --copy

# Interactively select skills and link them to the .agents/skills directory
# Flags can be combined; missing arguments will be prompted interactively
npx skls-mgr install --dir ./.agents/skills --link

Overwrite Policy

If a skill directory with the same name already exists in the target project, skls-mgr install will overwrite it directly without further confirmation.

When --link is selected, if the current environment does not support creating symbolic links, it will automatically fall back to a direct copy.

Other Commands

| Command | Description | | -------------------------------- | ------------------------------------------------------------------------------------------ | | npx skls-mgr find [query] | Search remote skills. Omit the query to search interactively and add a selected skill. | | npx skls-mgr list | List all skills in ~/.config/skls-mgr, distinguishing between managed and manual skills. | | npx skls-mgr update [names...] | Interactively or by specified names update skills. | | npx skls-mgr remove [names...] | Interactively or by specified names remove skills. | | npx skls-mgr help | Show help. | | npx skls-mgr version | Show version. |

Examples

# Display all skills (including manually added ones)
npx skls-mgr list

# Search remote skills by query
npx skls-mgr find react performance

# Search interactively, then add the selected skill
npx skls-mgr find

# Interactive update
npx skls-mgr update

# Force update specific skills by name
npx skls-mgr update skill1 skill2

# Interactive removal
npx skls-mgr remove

# Remove specific skills by name
npx skls-mgr remove skill1 skill2

# Show help
npx skls-mgr help

# Show version
npx skls-mgr version

skls-mgr update relies on the GitHub API. To avoid rate limits for anonymous requests (60 per hour), it is recommended to configure GITHUB_TOKEN or GH_TOKEN in your environment variables to increase the quota (5000 per hour).

find-skills

It is recommended to use the find-skills skill in this project to let your AI help discover useful skills and install them.

# Add the skill
npx skls-mgr add Xaviw/skills-manager --skill find-skills

# Install the skill globally
npx skls-mgr install --skill find-skills --dir ~/.claude/skills --link

# Or install it into a project on demand
npx skls-mgr install --skill find-skills --dir ./.claude/skills --link

License

MIT