skill-flow

# Skill Flow

<div align="center">

Turn scattered AI agent skills into organized workflows.

[中文](./README.zh.md) · [日本語](./README.ja.md)

[![Node.js Version](https://img.shields.io/badge/node-%3E%3D20-43853d?style=flat-square)](https://nodejs.org)
[![npm Version](https://img.shields.io/npm/v/skill-flow?style=flat-square)](https://www.npmjs.com/package/skill-flow)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg?style=flat-square)](./LICENSE)

<img src="./img/img-icon.png" alt="Skill Flow icon" width="120" />

</div>

Install, manage, and share skills across every major coding agent — Claude Code, Cursor, Cursor, Trae, and more.

Search and import skills from skills.sh, GitHub, or local sources. Deploy to multiple agents at once. Keep everything organized and up to date.

![Skill Flow desktop overview](./img/img-home.png)

## Why This Exists

Installing skills one by one breaks down at scale:

- Repos contain multiple related skills, but you install them separately
- Different agents expect different locations
- Updates drift silently
- Unmanaged folders accumulate
- Nobody tracks what's actually deployed

`skill-flow` preserves the workflow group. One source remains one cohesive unit—inspect it, select skills, deploy to multiple targets, update cleanly, and always know your state.

## What You Get

- **Grouped source management**: local, Git, and skills.sh sources all flow through the same import model.
- **Multi-agent deployment**: deploy one selected skill set to Claude Code, Codex, Cursor, Cursor CLI, OpenCode, OpenClaw, Trae, Windsurf, and more.
- **Interactive config flow**: Ink-based TUI for add/config flows, selection state, review, and repair.
- **Desktop app on macOS 15+**: SwiftUI main window, import view, detail panel, settings, and menu bar quick config.
- **Explicit state**: `manifest.json` stores intent, `lock.json` stores resolved inventory and deployments.
- **Bridge protocol**: machine-readable desktop/helper entrypoint via