Skip to content

Repository files navigation

skillman

English | 简体中文

skillman is a CLI-first toolkit for managing prompt skills across projects and agents.

North star:

  • Complete the end-to-end skill lifecycle: install -> publish/archive -> update.
  • Make cross-project skill bootstrapping fast and repeatable via profile.

Status

  • Version: v1 (CLI implemented)
  • v2 API layer: planned

Core Capabilities (v1)

  • Manage markets from local filesystem and Git repositories.
  • Install one skill to multiple agents (codex / claude / gemini) in one command.
  • Snapshot and apply skill profiles across projects.
  • Archive local skill changes back to a Git market and open PR automatically.
  • Update markets and sync installed skills with conflict-aware behavior.
  • Remove markets with copy/link handling and unmatched-agent reporting.

Quick Start

Prerequisites

  • Node.js >= 20
  • npm >= 10

Setup

git clone git@github.com:mindfn/skillman.git
cd skillman
npm install
npm run build
npm test

Use as a CLI command

npm pack
npm install -g --offline ./skillman-0.1.0.tgz --prefix /tmp/skillman-global
/tmp/skillman-global/bin/skillman --help

Typical Commands

# register projects
skillman project add /path/to/project-a
skillman project add /path/to/project-b

# add markets
skillman market add /path/to/local-market --type fs --name local-fs
skillman market add git@github.com:mindfn/skills-test.git --type git --name git-test

# install one skill to multiple agents
skillman skill install git-test:test-skill --agent codex --agent claude --agent gemini --mode copy --force

# profile snapshot/apply
skillman profile snapshot --name team-default --project-root /path/to/project-a
skillman profile apply --name team-default --project-root /path/to/project-b --force

# archive skill back to git market and auto-create PR
skillman archive /path/to/project/.codex/skills/my-skill --market git-test --dest my-skill

Documentation

Validation Evidence

Contributing

  • See CONTRIBUTING.md
  • Commit style: Conventional Commits (feat:, fix:, docs:, ...)

License

MIT

About

用于skill-market的管理

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages