📦 deps(thirdparty): update snapshots
This commit is contained in:
ci[bot]
@@ -0,0 +1,40 @@
|
||||
# Antigravity Setup
|
||||
|
||||
Google's [Antigravity](https://antigravity.google) uses Claude-compatible
|
||||
[Agent Skills](https://agentskills.io) and reads `AGENTS.md` / `GEMINI.md`, so all six brooks-lint
|
||||
modes run with no conversion.
|
||||
|
||||
## Install
|
||||
|
||||
```bash
|
||||
# project-scoped is the official convention (recommended)
|
||||
./scripts/install.sh antigravity --project # this repo: ./.agent/skills
|
||||
|
||||
# global
|
||||
curl -fsSL https://raw.githubusercontent.com/hyhmrright/brooks-lint/main/scripts/install.sh | bash -s -- antigravity
|
||||
./scripts/install.sh antigravity # global: ~/.gemini/skills
|
||||
```
|
||||
|
||||
Manual equivalent (project):
|
||||
|
||||
```bash
|
||||
git clone https://github.com/hyhmrright/brooks-lint.git /tmp/brooks-lint
|
||||
mkdir -p .agent/skills
|
||||
cp -r /tmp/brooks-lint/skills/* .agent/skills/ # flat — brooks-* and _shared/ as siblings
|
||||
```
|
||||
|
||||
## Invoke
|
||||
|
||||
Ask naturally ("review this PR", "audit the architecture") — the agent selects the matching skill from
|
||||
its `description`. `AGENTS.md` / `GEMINI.md` carry the Iron Law and Health Score rules.
|
||||
|
||||
## Notes
|
||||
|
||||
- **Flat layout** is mandatory (the installer guarantees it): `../_shared/` only resolves when
|
||||
`_shared/` is a sibling of the `brooks-*` folders.
|
||||
- The project convention `.agent/skills/` is well documented; the **global** skills path
|
||||
(`~/.gemini/skills` vs a product subfolder) varies between sources — if the global install isn't
|
||||
discovered, use the project install. Please report what worked.
|
||||
- 🧪 Documented per the official [skills](https://antigravity.google/docs/skills) and
|
||||
[rules & workflows](https://antigravity.google/docs/rules-workflows) docs; community end-to-end
|
||||
verification welcome — [open an issue](https://github.com/hyhmrright/brooks-lint/issues/new).
|
||||
@@ -0,0 +1,43 @@
|
||||
# GitHub Copilot Setup
|
||||
|
||||
GitHub Copilot has supported [Agent Skills](https://agentskills.io) since December 2025 (coding agent,
|
||||
Copilot CLI, and VS Code agent mode). It reads `AGENTS.md` and **auto-detects existing `.claude/skills`
|
||||
folders**, so all six brooks-lint modes run with no conversion.
|
||||
|
||||
## Install
|
||||
|
||||
```bash
|
||||
# personal (all repos) — one command
|
||||
curl -fsSL https://raw.githubusercontent.com/hyhmrright/brooks-lint/main/scripts/install.sh | bash -s -- copilot
|
||||
|
||||
# from a clone
|
||||
./scripts/install.sh copilot # personal: ~/.copilot/skills
|
||||
./scripts/install.sh copilot --project # this repo: ./.github/skills
|
||||
```
|
||||
|
||||
Manual equivalent (commit to a repo so the cloud agent and reviewers share it):
|
||||
|
||||
```bash
|
||||
git clone https://github.com/hyhmrright/brooks-lint.git /tmp/brooks-lint
|
||||
mkdir -p .github/skills
|
||||
cp -r /tmp/brooks-lint/skills/* .github/skills/ # flat — brooks-* and _shared/ as siblings
|
||||
```
|
||||
|
||||
Copilot discovers skills from `.github/skills`, `.claude/skills`, `.agents/skills` (project) and
|
||||
`~/.copilot/skills`, `~/.agents/skills` (personal). `./scripts/install.sh agents` (→ `~/.agents/skills`)
|
||||
is shared with Cursor and pi.
|
||||
|
||||
## Invoke
|
||||
|
||||
Ask naturally in Copilot Chat / CLI ("review this PR", "audit the architecture") — Copilot loads the
|
||||
matching skill on demand from its `description`. `AGENTS.md` (or `.github/copilot-instructions.md`)
|
||||
carries the Iron Law and Health Score rules.
|
||||
|
||||
## Notes
|
||||
|
||||
- **Flat layout** is mandatory (the installer guarantees it): `../_shared/` only resolves when
|
||||
`_shared/` is a sibling of the `brooks-*` folders.
|
||||
- Org/enterprise-level skills were "coming soon" at launch; repo-level `.github/skills` works today.
|
||||
- 🧪 Documented per the [Agent Skills announcement](https://github.blog/changelog/2025-12-18-github-copilot-now-supports-agent-skills/)
|
||||
and [docs](https://docs.github.com/en/copilot/concepts/agents/about-agent-skills); community
|
||||
end-to-end verification welcome — [open an issue](https://github.com/hyhmrright/brooks-lint/issues/new).
|
||||
@@ -0,0 +1,38 @@
|
||||
# Cursor Setup
|
||||
|
||||
[Cursor](https://cursor.com) added native [Agent Skills](https://agentskills.io) support in 2.4. It
|
||||
loads `SKILL.md` skills and reads `AGENTS.md`, so all six brooks-lint modes run with no conversion.
|
||||
|
||||
## Install
|
||||
|
||||
```bash
|
||||
# simplest — one command (global)
|
||||
curl -fsSL https://raw.githubusercontent.com/hyhmrright/brooks-lint/main/scripts/install.sh | bash -s -- cursor
|
||||
|
||||
# from a clone
|
||||
./scripts/install.sh cursor # global: ~/.cursor/skills
|
||||
./scripts/install.sh cursor --project # this repo: ./.cursor/skills
|
||||
```
|
||||
|
||||
Manual equivalent:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/hyhmrright/brooks-lint.git /tmp/brooks-lint
|
||||
mkdir -p ~/.cursor/skills
|
||||
cp -r /tmp/brooks-lint/skills/* ~/.cursor/skills/ # flat — brooks-* and _shared/ as siblings
|
||||
```
|
||||
|
||||
Cursor also loads `.agents/skills/` / `~/.agents/skills/` and existing Claude/Codex skill folders, so
|
||||
`./scripts/install.sh agents` works too and is shared with Copilot and pi.
|
||||
|
||||
## Invoke
|
||||
|
||||
Ask naturally ("review this PR", "audit the architecture") and Cursor selects the matching skill from
|
||||
its `description`, or use the `/brooks-review` slash form once the skill is discovered.
|
||||
|
||||
## Notes
|
||||
|
||||
- **Flat layout** is mandatory (the installer guarantees it): `../_shared/` only resolves when
|
||||
`_shared/` is a sibling of the `brooks-*` folders.
|
||||
- 🧪 Documented per the official [skills docs](https://cursor.com/docs/skills); community end-to-end
|
||||
verification welcome — [open an issue](https://github.com/hyhmrright/brooks-lint/issues/new).
|
||||
@@ -0,0 +1,43 @@
|
||||
# Factory Droid Setup
|
||||
|
||||
Factory's [Droid](https://factory.ai) (`droid` CLI) natively loads
|
||||
[Agent Skills](https://agentskills.io) and reads `AGENTS.md`, so all six brooks-lint modes run with no
|
||||
conversion.
|
||||
|
||||
## Install
|
||||
|
||||
```bash
|
||||
# simplest — one command
|
||||
curl -fsSL https://raw.githubusercontent.com/hyhmrright/brooks-lint/main/scripts/install.sh | bash -s -- droid
|
||||
|
||||
# from a clone
|
||||
./scripts/install.sh droid # personal: ~/.factory/skills
|
||||
./scripts/install.sh droid --project # this repo: ./.factory/skills
|
||||
```
|
||||
|
||||
Manual equivalent:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/hyhmrright/brooks-lint.git /tmp/brooks-lint
|
||||
mkdir -p ~/.factory/skills
|
||||
cp -r /tmp/brooks-lint/skills/* ~/.factory/skills/ # flat — brooks-* and _shared/ as siblings
|
||||
```
|
||||
|
||||
Droid discovers skills from `~/.factory/skills` (personal), `.factory/skills` (project), and the legacy
|
||||
`.agent/skills`, each a single level deep.
|
||||
|
||||
## Invoke
|
||||
|
||||
Ask naturally ("review this PR", "audit the architecture") — Droid auto-loads the matching skill from
|
||||
its `description` — or use the slash form `/brooks-review` (Droid registers each skill as a command).
|
||||
`AGENTS.md` carries the Iron Law and Health Score rules.
|
||||
|
||||
## Notes
|
||||
|
||||
- **Flat layout** is mandatory (the installer guarantees it): `../_shared/` only resolves when
|
||||
`_shared/` is a sibling of the `brooks-*` folders, and Droid discovers skills only one level deep.
|
||||
- Droid ignores Claude-only frontmatter fields (e.g. `allowed-tools`); `name` + `description` + body
|
||||
are all it needs, so the skills load unchanged.
|
||||
- 🧪 Documented per the official [skills docs](https://docs.factory.ai/cli/configuration/skills) and
|
||||
[AGENTS.md docs](https://docs.factory.ai/cli/configuration/agents-md); community end-to-end
|
||||
verification welcome — [open an issue](https://github.com/hyhmrright/brooks-lint/issues/new).
|
||||
@@ -0,0 +1,74 @@
|
||||
# Getting Started — brooks-lint on any agent
|
||||
|
||||
brooks-lint is six [Agent Skills](https://agentskills.io) (`SKILL.md` + Markdown guides) plus a
|
||||
shared `_shared/` framework folder. **Any coding agent that loads Agent Skills can run all six modes
|
||||
with no conversion** — you just place the `skills/` directory where that agent looks for skills.
|
||||
|
||||
## The one thing that matters: flat layout
|
||||
|
||||
Every skill reads the shared framework via the relative path `../_shared/common.md`. That only
|
||||
resolves when `_shared/` is a **sibling** of the `brooks-*` folders:
|
||||
|
||||
```
|
||||
<skills-dir>/
|
||||
├── brooks-review/SKILL.md ← reads ../_shared/common.md
|
||||
├── brooks-audit/SKILL.md
|
||||
├── …
|
||||
└── _shared/ ← sibling, no SKILL.md (ignored as a skill, read as files)
|
||||
```
|
||||
|
||||
So always copy `skills/*` **flat** — never nest everything under one `brooks-lint/` folder for the
|
||||
platforms that discover skills with a single-level glob (`skills/<name>/SKILL.md`).
|
||||
|
||||
## Simplest install — one command
|
||||
|
||||
The installer copies the skills flat into the correct folder for your platform, so you can't get the
|
||||
layout wrong:
|
||||
|
||||
```bash
|
||||
# from a clone
|
||||
./scripts/install.sh <platform>
|
||||
|
||||
# or without cloning
|
||||
curl -fsSL https://raw.githubusercontent.com/hyhmrright/brooks-lint/main/scripts/install.sh | bash -s -- <platform>
|
||||
```
|
||||
|
||||
`<platform>` ∈ `opencode · cursor · windsurf · antigravity · pi · kiro · copilot · droid · gemini ·
|
||||
codex · claude · agents`. Add `--project` to install into the current repo instead of your global
|
||||
config. `agents` targets the vendor-neutral `~/.agents/skills` folder that Cursor, Copilot, pi, Gemini,
|
||||
and Codex all read.
|
||||
|
||||
## Per-platform guides
|
||||
|
||||
| Platform | Guide | Discovers `SKILL.md` from | Reads `AGENTS.md` |
|
||||
|----------|-------|---------------------------|:-----------------:|
|
||||
| OpenCode | [opencode-setup.md](opencode-setup.md) | `~/.config/opencode/skills`, `.opencode/skills`, `~/.claude/skills` | ✅ |
|
||||
| Cursor | [cursor-setup.md](cursor-setup.md) | `~/.cursor/skills`, `.cursor/skills`, `.agents/skills` | ✅ |
|
||||
| Windsurf | [windsurf-setup.md](windsurf-setup.md) | `~/.codeium/windsurf/skills`, `.windsurf/skills` | ✅ |
|
||||
| Antigravity | [antigravity-setup.md](antigravity-setup.md) | `.agent/skills`, `~/.gemini/skills` | ✅ |
|
||||
| pi | [pi-setup.md](pi-setup.md) | `~/.pi/agent/skills`, `.pi/skills`, settings array | ✅ |
|
||||
| GitHub Copilot | [copilot-setup.md](copilot-setup.md) | `.github/skills`, `.claude/skills`, `~/.copilot/skills` | ✅ |
|
||||
| Kiro | [kiro-setup.md](kiro-setup.md) | `.kiro/skills`, `~/.kiro/skills` | ✅ |
|
||||
| Factory Droid | [factory-droid-setup.md](factory-droid-setup.md) | `~/.factory/skills`, `.factory/skills`, `.agent/skills` | ✅ |
|
||||
|
||||
For Claude Code, Gemini CLI, and Codex CLI, see the [README install section](../README.md#installation).
|
||||
`./scripts/install.sh gemini` and `./scripts/install.sh codex` also work and use the flat layout these
|
||||
two require (Gemini discovers skills only one level deep).
|
||||
|
||||
## Any other agent
|
||||
|
||||
If your agent accepts a skills folder or an instruction file, brooks-lint works:
|
||||
|
||||
- **Loads `SKILL.md`?** Point it at a flat `skills/` folder (use `install.sh agents` for the neutral
|
||||
`~/.agents/skills`).
|
||||
- **Only reads an instructions file** (`AGENTS.md` / `CLAUDE.md` / a system prompt)? Add the repo's
|
||||
`AGENTS.md` so the agent learns the Iron Law and scoring, then have it read the relevant
|
||||
`skills/<mode>/SKILL.md` on demand.
|
||||
|
||||
## Verification status
|
||||
|
||||
The marketplace-installed platforms (Claude Code, Gemini CLI, Codex CLI) are maintainer-verified. The
|
||||
seven Agent-Skills platforms above are documented from each tool's official skill spec and verified at
|
||||
the file-layout level (the installer is tested), but not yet end-to-end run by the maintainer on every
|
||||
platform. **Tried one? Tell us** — [open an issue](https://github.com/hyhmrright/brooks-lint/issues/new)
|
||||
with the platform, version, and what you saw, working or broken.
|
||||
@@ -0,0 +1,41 @@
|
||||
# Kiro Setup
|
||||
|
||||
AWS [Kiro](https://kiro.dev) (IDE & CLI) natively loads Claude-compatible
|
||||
[Agent Skills](https://agentskills.io), reads `AGENTS.md`, and **auto-registers each skill as a slash
|
||||
command**, so all six brooks-lint modes run with no conversion.
|
||||
|
||||
## Install
|
||||
|
||||
```bash
|
||||
# simplest — one command (global)
|
||||
curl -fsSL https://raw.githubusercontent.com/hyhmrright/brooks-lint/main/scripts/install.sh | bash -s -- kiro
|
||||
|
||||
# from a clone
|
||||
./scripts/install.sh kiro # global: ~/.kiro/skills
|
||||
./scripts/install.sh kiro --project # this repo: ./.kiro/skills
|
||||
```
|
||||
|
||||
Manual equivalent:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/hyhmrright/brooks-lint.git /tmp/brooks-lint
|
||||
mkdir -p ~/.kiro/skills
|
||||
cp -r /tmp/brooks-lint/skills/* ~/.kiro/skills/ # flat — brooks-* and _shared/ as siblings
|
||||
```
|
||||
|
||||
Or use the IDE: **Agent Steering & Skills** panel → **+** → **Import a skill** → paste a GitHub URL or
|
||||
pick a local folder (Kiro copies it into your skills folder).
|
||||
|
||||
## Invoke
|
||||
|
||||
Ask naturally ("review this PR", "audit the architecture"), or use the auto-registered slash command
|
||||
`/brooks-review`. `AGENTS.md` is always-included and carries the Iron Law and Health Score rules.
|
||||
|
||||
## Notes
|
||||
|
||||
- **Flat layout** is mandatory (the installer guarantees it): `../_shared/` only resolves when
|
||||
`_shared/` is a sibling of the `brooks-*` folders.
|
||||
- Kiro requires the folder name to equal the skill's `name` (✅ already true here), `name` ≤ 64 chars,
|
||||
and `description` ≤ 1024 chars (brooks-lint's longest is ~920).
|
||||
- 🧪 Documented per the official [skills docs](https://kiro.dev/docs/skills/); community end-to-end
|
||||
verification welcome — [open an issue](https://github.com/hyhmrright/brooks-lint/issues/new).
|
||||
@@ -0,0 +1,45 @@
|
||||
# OpenCode Setup
|
||||
|
||||
[OpenCode](https://opencode.ai) natively loads [Agent Skills](https://agentskills.io) and reads
|
||||
`AGENTS.md`, so all six brooks-lint modes run with no conversion.
|
||||
|
||||
## Install
|
||||
|
||||
```bash
|
||||
# simplest — one command (global)
|
||||
curl -fsSL https://raw.githubusercontent.com/hyhmrright/brooks-lint/main/scripts/install.sh | bash -s -- opencode
|
||||
|
||||
# from a clone
|
||||
./scripts/install.sh opencode # global: ~/.config/opencode/skills
|
||||
./scripts/install.sh opencode --project # this repo: ./.opencode/skills
|
||||
```
|
||||
|
||||
Manual equivalent:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/hyhmrright/brooks-lint.git /tmp/brooks-lint
|
||||
mkdir -p ~/.config/opencode/skills
|
||||
cp -r /tmp/brooks-lint/skills/* ~/.config/opencode/skills/ # flat — brooks-* and _shared/ as siblings
|
||||
```
|
||||
|
||||
OpenCode also discovers Claude-compatible `~/.claude/skills/*/SKILL.md`, so an existing Claude install
|
||||
(if flat) is picked up automatically.
|
||||
|
||||
## Invoke
|
||||
|
||||
Just ask — OpenCode auto-selects skills from each `description`:
|
||||
|
||||
- "review this PR" → `brooks-review`
|
||||
- "audit the architecture" → `brooks-audit`
|
||||
- "where's our worst tech debt?" → `brooks-debt`
|
||||
|
||||
For explicit invocation, `/brooks-review` etc. are available once the skill is discovered. The repo's
|
||||
`AGENTS.md` carries the Iron Law (Symptom → Source → Consequence → Remedy) and the Health Score rules.
|
||||
|
||||
## Notes
|
||||
|
||||
- **Flat layout** is mandatory (the installer guarantees it): skills read `../_shared/`, which only
|
||||
resolves when `_shared/` sits beside the `brooks-*` folders.
|
||||
- 🧪 Documented per the official [skills](https://opencode.ai/docs/skills/) and
|
||||
[rules](https://opencode.ai/docs/rules/) docs; community end-to-end verification welcome —
|
||||
[open an issue](https://github.com/hyhmrright/brooks-lint/issues/new).
|
||||
@@ -0,0 +1,39 @@
|
||||
# pi Setup
|
||||
|
||||
[pi](https://github.com/earendil-works/pi) (the earendil-works coding agent) natively loads
|
||||
[Agent Skills](https://agentskills.io) and reads `AGENTS.md` / `CLAUDE.md`, so all six brooks-lint
|
||||
modes run with no conversion.
|
||||
|
||||
## Install
|
||||
|
||||
```bash
|
||||
# simplest — one command (global)
|
||||
curl -fsSL https://raw.githubusercontent.com/hyhmrright/brooks-lint/main/scripts/install.sh | bash -s -- pi
|
||||
|
||||
# from a clone
|
||||
./scripts/install.sh pi # global: ~/.pi/agent/skills
|
||||
./scripts/install.sh pi --project # this repo: ./.pi/skills
|
||||
```
|
||||
|
||||
Or **don't copy at all** — point pi at a clone via settings (`~/.pi/settings.json`, or project
|
||||
`.pi/settings.json`):
|
||||
|
||||
```json
|
||||
{ "skills": ["/path/to/brooks-lint/skills"] }
|
||||
```
|
||||
|
||||
pi can also reuse other tools' skill folders the same way, e.g. `{ "skills": ["~/.claude/skills"] }`
|
||||
(only if that folder is flat).
|
||||
|
||||
## Invoke
|
||||
|
||||
Ask naturally ("review this PR", "audit the architecture"), or use the auto-registered command form
|
||||
`/skill:brooks-review`. `AGENTS.md` carries the Iron Law and Health Score rules.
|
||||
|
||||
## Notes
|
||||
|
||||
- **Flat layout** is mandatory (the installer guarantees it): `../_shared/` only resolves when
|
||||
`_shared/` is a sibling of the `brooks-*` folders.
|
||||
- pi caps `description` at 1024 chars; brooks-lint's longest is ~920, so all six skills load cleanly.
|
||||
- 🧪 Documented per the official [skills docs](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/skills.md);
|
||||
community end-to-end verification welcome — [open an issue](https://github.com/hyhmrright/brooks-lint/issues/new).
|
||||
@@ -0,0 +1,36 @@
|
||||
# Windsurf Setup
|
||||
|
||||
[Windsurf](https://windsurf.com) (Cascade) natively loads [Agent Skills](https://agentskills.io) and
|
||||
reads `AGENTS.md`, so all six brooks-lint modes run with no conversion.
|
||||
|
||||
## Install
|
||||
|
||||
```bash
|
||||
# simplest — one command (global)
|
||||
curl -fsSL https://raw.githubusercontent.com/hyhmrright/brooks-lint/main/scripts/install.sh | bash -s -- windsurf
|
||||
|
||||
# from a clone
|
||||
./scripts/install.sh windsurf # global: ~/.codeium/windsurf/skills
|
||||
./scripts/install.sh windsurf --project # this repo: ./.windsurf/skills
|
||||
```
|
||||
|
||||
Manual equivalent:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/hyhmrright/brooks-lint.git /tmp/brooks-lint
|
||||
mkdir -p ~/.codeium/windsurf/skills
|
||||
cp -r /tmp/brooks-lint/skills/* ~/.codeium/windsurf/skills/ # flat — brooks-* and _shared/ as siblings
|
||||
```
|
||||
|
||||
## Invoke
|
||||
|
||||
Ask naturally ("review this PR", "audit the architecture") — Cascade selects the matching skill from
|
||||
its `description`. The repo's `AGENTS.md` is read by Windsurf's rules engine and carries the Iron Law
|
||||
and Health Score rules. (`@skill-name` also references a discovered skill.)
|
||||
|
||||
## Notes
|
||||
|
||||
- **Flat layout** is mandatory (the installer guarantees it): `../_shared/` only resolves when
|
||||
`_shared/` is a sibling of the `brooks-*` folders.
|
||||
- 🧪 Documented per the official [Cascade skills docs](https://docs.windsurf.com/windsurf/cascade/skills);
|
||||
community end-to-end verification welcome — [open an issue](https://github.com/hyhmrright/brooks-lint/issues/new).
|
||||
Reference in New Issue
Block a user