Skip to main content

CLI tool to manage Claude Code skills (~/.claude/skills/)

Project description

Claude Skills Manager (csm)

A CLI tool to manage Claude Code skills in ~/.claude/skills/.

Skills are directories containing a SKILL.md file with YAML frontmatter. csm lets you list, enable/disable, create, link, and configure them without manually editing files.

Installation

# With uv (recommended)
uv tool install claude-skills-manager

# With pipx
pipx install claude-skills-manager

The csm command will be available globally after installation.

Usage

List all skills

csm list

Shows a table with each skill's name, enabled status, description, and invocation settings.

Show skill details

csm show <name>

Prints the full frontmatter and markdown content of a skill.

Enable / Disable

csm disable <name>   # renames SKILL.md → SKILL.md.disabled
csm enable <name>    # renames SKILL.md.disabled → SKILL.md

Create a new skill

csm create my-skill --desc "Does something useful"

Scaffolds a new skill directory with a template SKILL.md in ~/.claude/skills/.

Edit a skill

csm edit <name>

Opens the skill's SKILL.md in $EDITOR (defaults to vi).

Link / Unlink external skills

# Symlink a skill from another directory (uses relative paths, compatible with GNU Stow)
csm link /path/to/my-skill

# Symlink with a custom name
csm link /path/to/my-skill --name custom-name

# Remove a symlink (does not delete the original directory)
csm unlink <name>

Configure frontmatter

# Set a key
csm config <name> --key disable-model-invocation --value true

# Delete a key
csm config <name> --key some-key --delete

Shell completion

csm --install-completion

Enables tab completion for commands and skill names in your shell.

How it works

  • Skills are discovered by scanning ~/.claude/skills/ for directories containing SKILL.md or SKILL.md.disabled
  • Enable/disable toggles the file extension
  • Frontmatter is parsed and written with python-frontmatter for safe YAML round-tripping
  • Symlinked skill directories are fully supported

Development

git clone https://github.com/danielmeint/skills-manager.git
cd claude-skills-manager
uv sync
uv run pytest

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

claude_skills_manager-0.1.1.tar.gz (16.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

claude_skills_manager-0.1.1-py3-none-any.whl (7.3 kB view details)

Uploaded Python 3

File details

Details for the file claude_skills_manager-0.1.1.tar.gz.

File metadata

  • Download URL: claude_skills_manager-0.1.1.tar.gz
  • Upload date:
  • Size: 16.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for claude_skills_manager-0.1.1.tar.gz
Algorithm Hash digest
SHA256 9b60c65642b8bfe42a75b2d67ea2ae85e281549598ede2ab5a358b43f05ec0f1
MD5 28167efba68dc950b60a3a67d360d264
BLAKE2b-256 840fb9b43a27584b6479987eebdca5162c374a7ec97460a281ba35e2dc2a47fc

See more details on using hashes here.

Provenance

The following attestation bundles were made for claude_skills_manager-0.1.1.tar.gz:

Publisher: publish.yml on danielmeint/skills-manager

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file claude_skills_manager-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for claude_skills_manager-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 5109eb7615008d99f724e00147f556f6369d8a09a389dbbbe4e94840fd957c7b
MD5 3898a72f53b4170e5b3a25823068c289
BLAKE2b-256 509d6666cd303fe100a6f7f812af22185889a497434e6f57b75a6308e368ca21

See more details on using hashes here.

Provenance

The following attestation bundles were made for claude_skills_manager-0.1.1-py3-none-any.whl:

Publisher: publish.yml on danielmeint/skills-manager

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page