# songwhip-core

Foundation plugin for working across the Songwhip service fleet. Install this
first — it lets Claude analyze across the fleet's repos and implement coordinated
changes that span multiple services.

## Skills

| Skill | Triggers on | What it provides |
|---|---|---|
| `songwhip-cross-repo` | cross-repo search, impact analysis, architecture, multi-repo solutioning | read-only analysis across all `theorchard/*songwhip*` repos via local shallow clones |
| `songwhip-feature` | implementing a feature across multiple services | staged, worktree-isolated subagents that implement + commit local `feat/<slug>` branches per repo (write counterpart to `songwhip-cross-repo`); never pushes/PRs |

## Prerequisites

`songwhip-cross-repo` discovers repos through the official **`github`** plugin
(hosted GitHub MCP). It is a manual prerequisite — install it yourself; it is not
auto-installed. You'll need:

- the `github` plugin installed: `/plugin install github@claude-plugins-official`
- `GITHUB_PERSONAL_ACCESS_TOKEN` set in your environment (with repo read scope) —
  used both by the `github` plugin's MCP and to authenticate the skill's `git`
  clones. No `gh` CLI and no bundled MCP required.
- `git` and `jq` on PATH.

The skill syncs shallow clones to `~/.cache/songwhip-cross-repo/` (outside any
repo) and runs read-only `grep`/`glob` analysis over them.

## Install

```text
/plugin install songwhip-core@songwhip-marketplace
```

See the marketplace [README](../../README.md) for adding the marketplace itself.