skillfish 1.0.10 → 1.0.11

package/README.md

@@ -10,15 +10,63 @@
   <a href="https://github.com/knoxgraeme/skillfish/actions"><img src="https://github.com/knoxgraeme/skillfish/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
 </p>
 
-Install AI agent skills from GitHub with a single command.
+<p align="center">
+  <strong>The skill manager for AI coding agents.</strong><br>
+  Install, update, and sync skills across Claude Code, Cursor, Copilot + more.
+</p>
+
+---
+
+## Quick Start
 
 ```bash
 npx skillfish add owner/repo
 ```
 
-## Overview
+One command installs to **all detected agents** on your system.
+
+## What Are Agent Skills?
+
+Agent Skills are portable packages of instructions, prompts, scripts, and resources that AI coding agents can discover and use. They give agents like Claude Code, Cursor, and Copilot domain expertise, reusable workflows, and team-specific context - loaded on demand to extend capabilities.
+
+Each skill contains a `SKILL.md` file with structured prompts and instructions the agent can follow.
+
+Learn more at [agentskills.io](https://agentskills.io).
+
+## Find Skills
+
+- **[skill.fish](https://skill.fish)** - Browse and discover community skills
+- **[MCP Market](https://mcpmarket.com/tools/skills)** - Skills directory
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `skillfish add <owner/repo>` | Install skills |
+| `skillfish list` | View installed skills |
+| `skillfish remove [name]` | Remove skills |
+| `skillfish update` | Update installed skills |
+
+All commands support `--json` for automation.
+
+## Examples
+
+```bash
+npx skillfish add user/my-skill          # Install a skill
+npx skillfish add owner/repo --all       # Install all skills from repo
+npx skillfish list                       # See what's installed
+npx skillfish update                     # Update all skills
+npx skillfish remove old-skill           # Remove a skill
+```
+
+## Supported Agents
+
+Works with 17+ agents including:
 
-One command installs skills to **all detected agents**:
+**Claude Code** · **Cursor** · **Windsurf** · **Codex** · **GitHub Copilot** · **Gemini CLI** · **OpenCode** · **Goose** · **Amp** · **Roo Code** · **Kiro CLI** · **Kilo Code** · **Trae** · **Cline** · **Antigravity** · **Droid** · **Clawdbot**
+
+<details>
+<summary>All supported agents</summary>
 
 | Agent | Skills Directory |
 |-------|------------------|
@@ -40,141 +88,65 @@ One command installs skills to **all detected agents**:
 | Droid | `~/.factory/skills/` |
 | Clawdbot | `~/.clawdbot/skills/` |
 
-## Usage
-
-### Install Skills
-
-```bash
-# Install a skill (auto-discovers SKILL.md location)
-npx skillfish add owner/repo
-
-# Full path from GitHub (plugin/skill syntax)
-npx skillfish add owner/repo/plugin/skill
+</details>
 
-# Specify explicit path
-npx skillfish add owner/repo --path path/to/skill
+---
 
-# Install all skills from a repo (non-interactive)
-npx skillfish add owner/repo --all
+## Command Reference
 
-# Overwrite existing skills
-npx skillfish add owner/repo --force
-
-# Skip confirmation prompt
-npx skillfish add owner/repo --yes
-```
+### add
 
-### List Skills
+Install skills from a repository.
 
 ```bash
-# Interactive agent and location picker
-npx skillfish list
-
-# List global skills only
-npx skillfish list --global
-
-# List project skills only
-npx skillfish list --project
-
-# List skills for a specific agent
-npx skillfish list --agent "Claude Code"
+npx skillfish add owner/repo                    # Auto-discover SKILL.md
+npx skillfish add owner/repo my-skill           # Install by skill name
+npx skillfish add owner/repo/path/to/skill      # Full path syntax
+npx skillfish add owner/repo --path skills/foo  # Explicit path
+npx skillfish add owner/repo --all              # Install all skills
+npx skillfish add owner/repo --force            # Overwrite existing
+npx skillfish add owner/repo --yes              # Skip confirmation
+npx skillfish add owner/repo --project          # Project only (./)
+npx skillfish add owner/repo --global           # Global only (~/)
 ```
 
-### Remove Skills
+### list
 
-```bash
-# Interactive skill picker
-npx skillfish remove
+View installed skills.
 
-# Remove a skill by name
-npx skillfish remove my-skill
-
-# Remove all installed skills
-npx skillfish remove --all
-
-# Remove from current project only
-npx skillfish remove my-skill --project
-
-# Remove from home directory only
-npx skillfish remove my-skill --global
-
-# Remove from specific agent
-npx skillfish remove my-skill --agent "Claude Code"
-
-# Skip confirmation prompt
-npx skillfish remove my-skill --yes
-```
-
-## Interactive Selection
-
-When a repo contains multiple skills, you'll get an interactive multi-select menu with skill names and descriptions from frontmatter:
-
-```
-◆  Select skills to install
-│  ◻ my-skill - A helpful skill for your AI agent
-│  ◻ another-skill - Another useful capability
-│  ◻ third-skill - Yet another skill option
-│  ...
-└
+```bash
+npx skillfish list                       # List all installed skills
+npx skillfish list --global              # Global skills only (~/)
+npx skillfish list --project             # Project skills only (./)
+npx skillfish list --agent "Claude Code" # Specific agent
 ```
 
-Use `--all` to install all skills non-interactively (useful for automation).
+### remove
 
-## Examples
+Remove installed skills.
 
 ```bash
-# Install from a skill repo with SKILL.md at root
-npx skillfish add user/my-skill
-
-# Install using full path from GitHub
-npx skillfish add owner/repo/path/to/skill
-
-# Install from a plugin repo with explicit path
-npx skillfish add org/plugin-repo --path plugins/my-plugin/skills/skill-name
-
-# Install all skills non-interactively
-npx skillfish add org/plugin-repo --all --yes
-
-# Force reinstall
-npx skillfish add user/skill --force
-
-# JSON output for automation
-npx skillfish add owner/repo --json
+npx skillfish remove                          # Interactive picker
+npx skillfish remove my-skill                 # By name
+npx skillfish remove --all                    # Remove all
+npx skillfish remove my-skill --project       # Project only
+npx skillfish remove my-skill --global        # Global only
+npx skillfish remove my-skill --agent "Cursor" # Specific agent
+npx skillfish remove my-skill --yes           # Skip confirmation
 ```
 
-## Discovery
-
-The CLI searches these locations for `SKILL.md`:
-1. Repository root
-2. `.claude/skills/{repo}/`
-3. `skills/{repo}/`
-4. `plugins/{repo}/skills/{repo}/`
-
-Use `--path` to skip discovery and specify the exact location.
-
-## Telemetry
+### update
 
-This CLI collects anonymous, aggregate install counts to understand skill popularity. No personally identifiable information is collected.
-
-**What is collected:**
-- Skill identifier (e.g., `owner/repo/skill-name`)
-- Incremented install count
-
-**What is NOT collected:**
-- IP addresses
-- User identifiers
-- System information
-- Usage patterns
-
-To opt out, set `DO_NOT_TRACK=1` in your environment:
+Update installed skills to latest version.
 
 ```bash
-DO_NOT_TRACK=1 npx skillfish add owner/repo
+npx skillfish update                     # Check for updates interactively
+npx skillfish update --yes               # Update all without prompting
+npx skillfish update --json              # Check for updates (JSON output)
 ```
 
-Telemetry is also automatically disabled in CI environments (`CI=true`).
-
-## Exit Codes
+<details>
+<summary>Exit Codes</summary>
 
 Exit codes help agents and scripts understand command results without parsing error messages.
 
@@ -193,22 +165,33 @@ skillfish add owner/repo --json
 # Output includes: "exit_code": 0 (or error code)
 ```
 
+</details>
+
+---
+
 ## Security
 
-**Security Note:** Skills are markdown files that provide instructions to AI agents. Always review skills before installing. skillfish does not vet third-party skills.
+Skills are markdown files that provide instructions to AI agents. Always review skills before installing. skillfish does not vet third-party skills.
 
-To report security vulnerabilities, please email security@skill.fish. See [SECURITY.md](SECURITY.md) for details.
+To report vulnerabilities, email security@skill.fish. See [SECURITY.md](SECURITY.md).
 
 ## Contributing
 
-Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
-
-Please read our [Code of Conduct](CODE_OF_CONDUCT.md) before participating.
+Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) and our [Code of Conduct](CODE_OF_CONDUCT.md).
 
 ## Changelog
 
 See [CHANGELOG.md](CHANGELOG.md) for release history.
 
+<details>
+<summary>Telemetry</summary>
+
+Anonymous, aggregate install counts only. No PII collected.
+
+To opt out: `DO_NOT_TRACK=1` or `CI=true`.
+
+</details>
+
 ## License
 
 [AGPL-3.0](LICENSE) - Graeme Knox

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillfish",
-  "version": "1.0.10",
+  "version": "1.0.11",
   "description": "Install AI agent skills from GitHub with a single command",
   "type": "module",
   "bin": {