https://github.com/nimbus-solution/nimbus-skills
Curated agent skills for Apex with Nimbus
https://github.com/nimbus-solution/nimbus-skills
Last synced: 4 days ago
JSON representation
Curated agent skills for Apex with Nimbus
- Host: GitHub
- URL: https://github.com/nimbus-solution/nimbus-skills
- Owner: nimbus-solution
- License: mit
- Created: 2026-05-09T10:40:21.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-06-20T20:59:52.000Z (12 days ago)
- Last Synced: 2026-06-20T22:19:33.471Z (12 days ago)
- Language: JavaScript
- Size: 67.4 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# nimbus-skills
Curated agent skills for working on Apex with **[Nimbus](https://testnimbus.dev)** — the local Apex test runner.
Skills are short, opinionated playbooks that tell an AI coding agent **when** and **how** to use Nimbus's local runtime effectively. Each is a tight loop around a signal only Nimbus produces offline — real test results, per-line coverage, governor usage, execution traces, mutation scores.
**Getting set up**
- **`bootstrap-nimbus`** — set Nimbus up on a fresh SFDX project, including CI.
- **`migrate-suite-to-nimbus`** — get an existing org suite running green locally by clearing blockers in dependency order (schema → stubs → setup → fixtures).
**Writing & fixing code**
- **`apex-tdd`** — red → green → refactor; the only way to actually do TDD in Apex without an org.
- **`fix-failing-apex-test`** — the inner loop. Read failure → narrow → edit → re-run, until green.
- **`triage-apex-failures`** — cluster a wall of failures by root cause before fixing.
**Raising quality**
- **`apex-coverage-uplift`** — raise coverage by writing targeted tests, not theatre.
- **`harden-tests-with-mutation`** — kill surviving mutants so assertions actually check behaviour.
- **`bulkify-apex`** — find and prove fixes for governor-limit / bulk-DML problems with measured usage.
- **`apex-pre-deploy-check`** — diff-scoped run + coverage delta + governor + risky-pattern gate before you ship.
All skills assume the project has Nimbus installed and (for the MCP-driven loops) the MCP server registered with the agent (`claude mcp add nimbus -- nimbus mcp`).
## Install
### Recommended: `nimbus skills install`
If you've already installed [Nimbus](https://testnimbus.dev), one command picks up everything in this repo and writes it to the right place for your agent:
```bash
nimbus skills list # see what's available
nimbus skills install fix-failing-apex-test # install one
nimbus skills install all # install every skill the agent supports
```
`nimbus skills` auto-detects your agent from the project root. Override with `--agent claude-code|cursor|aider|agents-md|kiro`. The CLI fetches manifest + files from this repo on demand — your binary stays small and you always get the latest.
### Manual install (no nimbus binary)
#### Claude Code
```bash
mkdir -p ~/.claude/skills
git clone https://github.com/nimbus-solution/nimbus-skills.git /tmp/nimbus-skills
cp -r /tmp/nimbus-skills/dist/claude-code/* ~/.claude/skills/
```
Or per-project: copy into `.claude/skills/` at the project root.
#### Cursor
```bash
mkdir -p .cursor/rules
curl -L https://github.com/nimbus-solution/nimbus-skills/raw/main/dist/cursor/fix-failing-apex-test.mdc -o .cursor/rules/fix-failing-apex-test.mdc
curl -L https://github.com/nimbus-solution/nimbus-skills/raw/main/dist/cursor/bootstrap-nimbus.mdc -o .cursor/rules/bootstrap-nimbus.mdc
curl -L https://github.com/nimbus-solution/nimbus-skills/raw/main/dist/cursor/apex-coverage-uplift.mdc -o .cursor/rules/apex-coverage-uplift.mdc
```
#### Kiro
```bash
mkdir -p .kiro/steering
curl -L https://github.com/nimbus-solution/nimbus-skills/raw/main/dist/kiro/fix-failing-apex-test.md -o .kiro/steering/fix-failing-apex-test.md
curl -L https://github.com/nimbus-solution/nimbus-skills/raw/main/dist/kiro/bootstrap-nimbus.md -o .kiro/steering/bootstrap-nimbus.md
curl -L https://github.com/nimbus-solution/nimbus-skills/raw/main/dist/kiro/apex-coverage-uplift.md -o .kiro/steering/apex-coverage-uplift.md
```
Skills use `inclusion: manual`, so load them on demand by typing `#fix-failing-apex-test` (or another name) in your Kiro prompt.
#### Aider
```bash
curl -L https://github.com/nimbus-solution/nimbus-skills/raw/main/dist/aider/CONVENTIONS.md -o CONVENTIONS.md
aider --read CONVENTIONS.md
```
#### AGENTS.md (OpenCode, Codex, Continue, generic harnesses)
```bash
curl -L https://github.com/nimbus-solution/nimbus-skills/raw/main/dist/AGENTS.md -o AGENTS.md
```
OpenCode reads `AGENTS.md` verbatim — no further config needed.
## Repo layout
```
skills/ # Source of truth — edit these
/SKILL.md # one dir per skill (9 today)
dist/ # Generated; do not edit
claude-code//SKILL.md
cursor/.mdc
kiro/.md
aider/CONVENTIONS.md
AGENTS.md
manifest.json # Generated; consumed by `nimbus skills`
scripts/build.mjs # Renders dist/ + manifest.json from skills/
```
The build script is dependency-free Node — `node scripts/build.mjs` regenerates `dist/` and `manifest.json`. CI verifies both stay in sync with `skills/` on every PR.
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md). New skills are welcome if they target a real Apex workflow that benefits from sub-second iteration.
## License
MIT.
---
Built for [**Nimbus**](https://testnimbus.dev) — Apex testing, locally.