Skill Flow CLI
Skill Flow groups skills from many sources and deploys them to many agents, including Claude Code, Cursor and Codex.
- 265 ★ on the repository
- Last commit
- Apache-2.0
Extended access
Why this level
- The CLI copies and updates skills in directories of several agents from external sources.
- Sources may contain code that the utility does not review.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/skill-flowDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The CLI copies and updates skills in directories of several agents from external sources.
- Sources may contain code that the utility does not review.
This is third-party code. Review the repository files before installing.
What it does
Skill Flow is a Node.js CLI for installing and updating skills. `skill-flow add garrytan/gstack` accepts a local folder, an `owner/repo` shorthand, a Git URL or a skills.sh catalog entry, shows the group and offers to pick skills and agents. A group stays one unit that can be inspected, deployed to several targets and updated. `list`, `find`, `update --all` and `doctor` show state, search for new skills and repair drift. Configuration lives in `manifest.json`, while resolved versions and deployments are kept in `lock.json`. A SwiftUI app exists for macOS 15 and newer, and `skill-flow bridge --json` offers a machine interface.
Who it is for. People who keep dozens of skills across several agents and are tired of copying folders and tracking what updated where.
Good fit when
- A repository with a set of related skills must be placed into Claude Code and Codex in one action.
- A shared list of deployed skills and their versions across all agents is needed.
- After a source update the new versions should roll out with `skill-flow update --all`.
- Unmanaged folders and drifted copies should be diagnosed with `skill-flow doctor`.
Not a fit when
- A single skill for one agent is needed: copying a folder by hand is simpler.
- The environment has no Node.js 20 or Git for non-GitHub sources.
- A security review of skill contents is needed: the utility deploys them but does not audit the code.
Example request
Add the garrytan/gstack source, pick skills for Claude Code and Codex, show the list with identifiers and check state through `skill-flow doctor`.Limitations
Node.js 20 or newer is required, plus Git for sources outside GitHub. The desktop app requires macOS 15 or newer. The utility deploys third-party skills into agent directories without checking their contents, so choose sources yourself. Imports from skills.sh use `npm` and `npx`. The latest commit is dated November 2026 and the version may change quickly. Deployment rewrites the skill directories of chosen agents, so save important local edits before the first run.
How to disable. Remove sources with `skill-flow` commands or clear agent directories by hand, then run `npm uninstall -g skill-flow`. `manifest.json` and `lock.json` live in the utility data directory.
FAQ
How do I install Skill Flow?
Run `npm install -g skill-flow` and check `skill-flow --help`. Without a global install `npx skill-flow --help` works.
Which sources does add understand?
Local folders, the `owner/repo` shorthand, full HTTPS and SSH Git URLs, GitHub tree URLs and `clawhub:<name>` entries with a version.
What is the difference between add and config?
`add` registers a new source and lets you choose skills and targets. `config` configures an existing group. If `config` opens empty, run `skill-flow add` first.
Which agents can it deploy to?
Targets include Claude Code, Codex, Cursor, Gemini CLI, OpenCode, Windsurf, Hermes Agent, Kimi Code, Trae and more. `skill-flow import-manifest` with `--dry-run` and `--apply` moves a set between machines.
What does doctor do?
`skill-flow doctor` diagnoses drift and broken deployments. `repair-source`, `repair-state` and `repair-targets` fix them.
Discussion
No questions or reviews yet.
Related
CLI toolsA desktop app and CLI to install, sync and organize agent skills across Claude Code, Codex, Cursor and other tools
A CLI and manager skill: one skills library distributed to 70+ agents, with management done from the agent conversation
A Go terminal UI for agent skills: list, check, update and find new ones in a single window
A command-line skill manager: installs skills from a marketplace, GitHub, private Git and npm into 45 agents' folders and scans them first
skills (npx skills)
skills
A skill package manager: installs, finds, updates and removes SKILL.md packages from GitHub and other git hosts across many agents
A skill that turns a pile of skills into a routing tree so the agent loads only the leaves it needs
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| Skill Flow (this card) | no | 265 | |
| Skills Manager | no | 1,058 | Another skill manager; Skill Flow keeps groups whole, tracks manifest.json and lock.json and deploys to dozens of agents |
| Universal Skills Manager | no | 115 | A universal skill manager; Skill Flow adds a macOS app, doctor diagnostics and a JSON bridge |
README in short
The project proposes one way to manage skills as working groups: source, selection, deployment, update, diagnosis. The README gives command scenarios, terminology and the list of supported agents. The macOS app and JSON bridge are described separately. Apache-2.0 license.