# skilly-cli

A skill that tells the agent to manage this repo's skills through the skilly CLI: add or remove bundles and skills, pull hub updates.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 647 installs
- Author: timschoch
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/timschoch/skilly/tree/HEAD/bundles/workflow/skills/skilly-cli/SKILL.md
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/skills/skilly-cli

## What it does

Skills in the repo are tracked by skilly, a hub at `timschoch/skilly`. The `skilly-cli` skill makes the agent use the CLI for that instead of copying files by hand.

Three verbs cover the work. `npx -y github:timschoch/skilly add <name...>` brings in a bundle or a single skill, `remove <name...>` takes one out, `update` syncs the hub's current state. Each verb handles its own commit, push and PR, so the agent should not commit on its behalf. On `main` it branches to `chore/skilly-setup`. On any other branch it halts before committing if `.agents/skills/verify/scripts/check-branch-name.mjs` rejects the name; rename with `git branch -m <type>/<description>` and run the verb again.

Do not edit skilly-owned files by hand — the nightly sync rewrites them. That covers `.claude/skills/`, `.agents/skills/`, `.claude/rules/<name>-*.md`, `.skilly/config.json` and `skills-lock.json`. A skill fix goes to its source repo, a repo-local rule goes to `CLAUDE.md`. When the user pastes a skills.sh URL, that skill sits outside the hub: pin it with the skills CLI via `npx -y skills add <url> --agent claude-code -y`. It lands in `skills-lock.json` and the sync leaves it alone.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add timschoch/skilly --skill skilly-cli -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/skilly-cli/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/skilly-cli/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add timschoch/skilly --skill skilly-cli -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/skilly-cli/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add timschoch/skilly --skill skilly-cli -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/skilly-cli/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install timschoch/skilly skilly-cli
```

2. **Manually: put the files in place**
- File: `.github/skills/skilly-cli/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add timschoch/skilly --skill skilly-cli -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/timschoch/skilly --path bundles/workflow/skills/skilly-cli
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/skilly-cli/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add timschoch/skilly --skill skilly-cli -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/timschoch/skilly/tree/HEAD/bundles/workflow/skills/skilly-cli/SKILL.md

## When to use it
- add a bundle of skills to the repo in one command
- remove a skill without breaking bundles that still need it
- pull the hub's latest state
- pin a skill from a skills.sh URL outside the hub
- rename a branch so the verb passes its name check

## Example prompts
- Add the workflow bundle to this repo with skilly
- Remove the skilly-cli skill and show me what changed
- Pull the latest updates from the skilly hub

## Similar
- [cargo-context](https://affpapa.org/en/nevibecode/skills/cargo-context.md) — skill · 9900 installs
- [setup-codemap-cli](https://affpapa.org/en/nevibecode/skills/setup-codemap-cli.md) — skill · 1200 installs
- [fallow-review](https://affpapa.org/en/nevibecode/skills/fallow-review.md) — skill · 885 installs
- [using-tmux-for-interactive-commands](https://affpapa.org/en/nevibecode/skills/using-tmux-for-interactive-commands.md) — skill · 504 installs
- [stack](https://affpapa.org/en/nevibecode/skills/stack.md) — skill · 474 installs
- [creating-pr](https://affpapa.org/en/nevibecode/skills/creating-pr.md) — skill · 465 installs

From the same set: [timschoch/skilly](https://affpapa.org/en/nevibecode/by/timschoch/skilly.md) — 16 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md