cowork-guide

# CoWork Guide > Complete reference for the CoWork Skills CLI tool ## Overview **CoWork Skills** (`cowork` / `co`) is a CLI tool for managing Claude Code skills and plugins across 16+ AI coding agents: - Install skills from GitHub repositories - Generate skills from source code (Rust, TypeScript, Python) - Manage project-level skill configuration via Skills.toml - Security auditing and checksum verification - Search GitHub for skill repositories ## Installation **First, check if cowork is installed:** ```bash cowork --version ``` **If not installed, install via one of these methods:** ```bash # Option 1: From crates.io (recommended) cargo install cowork # Option 2: From source git clone https://github.com/ZhangHanDong/cowork-skills cd cowork-skills/cli cargo install --path . ``` **Then initialize built-in skills:** ```bash cowork init ``` > **Note:** If you installed cowork-skills via `npx @anthropic-ai/claude-code add`, > you still need to install the `cowork` CLI separately using the commands above. ## Command Alias ```bash cowork = co # 简写别名 ``` ## Commands by Category ### 🚀 Quick Start (初始化) | Command | Description | |---------|-------------| | `co init` | 安装内置 skills 到全局/项目 | | `co init --list` | 列出可用的内置 skills | | `co init --local` | 安装到项目 `.claude/skills/` | | `co init -r <name>` | 删除指定 skill | ### 📦 Install & Uninstall (安装) | Command | Description | |---------|-------------| | `co install user/repo` | 从 GitHub 安装 | | `co install user/repo -s skill1` | 安装指定 skills | | `co install user/repo --plugin` | 作为插件安装 | | `co install user/repo -l` | 安装到项目本地 | | `co install user/repo --update` | 更新到最新版本 | | `co install --list` | 列出已安装仓库 | | `co install --uninstall repo` | 卸载仓库 | ### ⚙️ Configuration (配置) | Command | Description | |---------|-------------| | `co config init` | 创建 Skills.toml | | `co config show` | 显示当前配置 | | `co config add name repo` | 添加依赖 | | `co config add name path --dev` | 添加开发链接 | | `co config install` | 安装 Skills.toml 中的依赖 | | `co config sync` | 同步锁文件状态 | | `co config enable/disable` | 启用/禁用 skills | | `co config priority` | 设置触发优先级 | | `co config router` | 生成动态路由 | | `co config router --analyze` | AI 分析生成智能路由 | ### 🔍 Discovery (发现) | Command | Description | |---------|-------------| | `co list` | 列出所有可用 skills | | `co search query` | 搜索 GitHub 仓库 | | `co search topic --topic` | 按 topic 搜索 | | `co generate user/repo` | 从源码生成 skills | ### 🔌 Plugin Management (插件) | Command | Description | |---------|-------------| | `co plugins list` | 列出已安装插件 | | `co plugins status` | 插件系统状态 | | `co plugins enable/disable` | 启用/禁用插件 | | `co plugins uninstall` | 卸载插件 | ### 🛡️ Security & Testing (安全) | Command | Description | |---------|-------------| | `co audit` | 安全审计 | | `co verify` | 校验 checksums | | `co test` | 生成触发测试 | | `co test --run` | 运行实际测试 | | `co test --check-conflicts` | 检查触发冲突 | ### 📊 Status & Debug (状态) | Command | Description | |---------|-------------| | `co status` | 显示当前状态 | | `co doctor` | 检查配置问题 | ## Workflow 工作流 ``` ┌─────────────────────────────────────────────────────────────────┐ │ CoWork 工作流 │ └─────────────────────────────────────────────────────────────────┘ 1. 初始化 co init # 安装内置 skills 2. 安装外部 skills co install user/repo # 从 GitHub 安装 co install user/repo --plugin # 作为插件安装 3. 项目配置 (可选) co config init # 创建 Skills.toml co config add rust ZhangHanDong/rust-skills co config install # 安装依赖 4. 生成路由 co config router --analyze # AI 分析生成智能路由 5. 测试 & 验证 co test --check-conflicts # 检查触发冲突 co audit # 安全审计 6. 日常使用 co list # 查看所有 skills co status # 查看状态 co doctor # 诊断问题 ``` --- ## cowork init Initialize built-in skills to ~/.claude/skills/. ```bash # Install all built-in skills cowork init # List available built-in skills cowork init --list # Install specific skills only cowork init -s memory-skills -s cowork-guide # Force overwrite existing cowork init --force # Install to project local (.claude/skills/) cowork init --local # Remove specific skills cowork init --remove memory-skills ``` **Built-in Skills:** - `memory-skills` - CoALA-based memory system (remember, recall, reflect) - `cowork-guide` - Complete CoWork CLI usage guide - `cowork-router` - Unified router for installed plugins/skills - `code-review` - Code review assistant with best practices - `github-generate` - Generate skills from GitHub repositories - `github-search` - Search GitHub for skill repositories --- ## cowork install Install skills from GitHub or local repositories. ### Basic Usage ```bash # Install from GitHub (user/repo format) cowork install ZhangHanDong/rust-skills # Install from full URL cowork install https://github.com/user/repo # Install current project to global cowork install # List installed repositories cowork install --list ``` ### Installation Options ```bash # Install specific skills only cowork install user/repo -s skill1 -s skill2 # Install to specific agents cowork install user/repo -a claude-code -a cursor # Install as plugin (preserves full repo structure) cowork install user/repo --plugin # Install to project local (.claude/skills/) cowork install user/repo --local # Force reinstall cowork install user/repo --reinstall # Update to latest version cowork install user/repo --update # Include additional directories cowork install user/repo --include-dir docs --include-dir examples # Copy files instead of symlinks cowork install user/repo --no-symlink # Use npx add-skill backend cowork install user/repo --use-add-skill # Skip confirmation prompts cowork install user/repo -y ``` ### Uninstall ```bash cowork install --uninstall repo-name ``` ### Supported Agents Install skills to 16+ coding agents: | Agent | Flag | Agent | Flag | |-------|------|-------|------| | Claude Code | `-a claude-code` | Amp | `-a amp` | | Cursor | `-a cursor` | Antigravity | `-a antigravity` | | Codex | `-a codex` | Clawdbot | `-a clawdbot` | | GitHub Copilot | `-a github-copilot` | Droid | `-a droid` | | Windsurf | `-a windsurf` | Gemini CLI | `-a gemini-cli` | | Goose | `-a goose` | Kilo | `-a kilo` | | Kiro CLI | `-a kiro-cli` | OpenCode | `-a opencode` | | Roo | `-a roo` | Trae | `-a trae` | --- ## cowork config Manage project-level skill configuration via Skills.toml. ### Initialize Configuration ```bash # Initialize with auto-detection of installed plugins/skills cowork config init # Skip auto-detection cowork config init --no-detect # Force overwrite existing cowork config init --force ``` Auto-detection scans: - `~/.claude/` for global plugins - `~/.claude/skills/` for global skills - `.claude/` for project plugins - `.claude/skills/` for project skills ### View Configuration ```bash # Show current config cowork config show # List available skill groups cowork config groups ``` ### Add Dependencies ```bash # Add from GitHub (global) cowork config add rust-skills ZhangHanDong/rust-skills # Add to project local cowork config add my-skills user/skills --local # Add specific skills cowork config add tokio user/tokio-skills -s tokio-runtime -s tokio-sync # Add as plugin cowork config add makepad user/makepad-skills --plugin # Add as disabled cowork config add old-lib user/old --disabled # Add with git ref cowork config add pinned user/repo --ref v1.0.0 # Add development link (symlink for testing) cowork config add dora-dev /path/to/dora-skills --dev ``` ### Install Dependencies ```bash # Install all dependencies from Skills.toml cowork config install ``` ### Sync Configuration ```bash # Sync enabled/disabled status with lock file cowork config sync # Also update remote repos (git pull) cowork config sync --update ``` ### Enable/Disable ```bash # Enable skill groups cowork config enable rust-core makepad # Enable individual skills cowork config enable memory-filesystem # Disable skills or groups cowork config disable rust-domains ``` ### Trigger Configuration ```bash # Set priority order cowork config priority dora-router rust-router makepad-router # Override specific trigger cowork config override "async" rust-router cowork config override "widget" makepad-router ``` ### Generate Output ```bash # Generate SKILLS.md from config cowork config apply # Generate to custom path cowork config apply -o ./docs/SKILLS.md # Generate dynamic router based on installed plugins cowork config router # Generate router with hooks for auto-triggering cowork config router --hooks # Analyze trigger conflicts cowork config router --analyze # Skip cache cowork config router --no-cache ``` --- ## Skills.toml Project-level configuration file stored at `.cowork/Skills.toml`. ### Basic Structure ```toml [project] name = "my-project" description = "Project description" [skills.global] enabled = ["memory-filesystem"] disabled = [] [skills.install] rust-skills = "ZhangHanDong/rust-skills" [skills.groups] enabled = ["rust-core"] disabled = [] [triggers] priority = ["dora-router", "rust-router"] [triggers.overrides] "async" = "rust-router" ``` ### Dependency Forms **Simple form:** ```toml [skills.install] rust-skills = "ZhangHanDong/rust-skills" ``` **Detailed form:** ```toml [skills.install] tokio = { repo = "user/tokio-skills", skills = ["tokio-runtime", "tokio-sync"] } local = { path = "../my-local-skills" } pinned = { repo = "user/repo", ref = "v1.0.0" } makepad = { repo = "user/makepad-skills", plugin = true } my-project = { repo = "user/skills", local = true } old-lib = { repo = "user/old", enabled = false } ``` ### Dev Links Development symlinks for testing local skills: ```toml [skills.dev] my-skill = "/path/to/my-skill-project" dora-dev = { path = "/path/to/dora-skills" } dora-plugin = { path = "/path/to/dora-skills", plugin = true } ``` ### Skill Groups | Group | Skills | Description | |-------|--------|-------------| | `rust-core` | 8 | Basic Rust (ownership, concurrency, error handling) | | `rust-patterns` | 7 | Design patterns (domain modeling, performance) | | `rust-domains` | 7 | Domain-specific (web, CLI, fintech, embedded) | | `makepad` | 11 | Makepad UI framework | | `dora` | 8 | Dora-rs robotics framework | | `dora-hubs` | 9 | Dora hub integrations | --- ## cowork generate Generate skills from source code of any GitHub repository. ```bash # Generate from GitHub repo cowork generate user/repo # Specify language(s) cowork generate tokio-rs/tokio --lang rust cowork generate vercel/next.js --lang typescript # Only generate llms.txt cowork generate user/repo --llms-only -o ./output # Generate from existing llms.txt