https://github.com/emaraschio/cursor-commands
Generic Cursor slash commands and Agent Skills with behavioral eval rubrics and CI ship-gate checks. Merge-safe install to ~/.cursor.
https://github.com/emaraschio/cursor-commands
agent-skills ai-agents cursor cursor-ide developer-tools dotfiles github-actions prompts
Last synced: about 1 month ago
JSON representation
Generic Cursor slash commands and Agent Skills with behavioral eval rubrics and CI ship-gate checks. Merge-safe install to ~/.cursor.
- Host: GitHub
- URL: https://github.com/emaraschio/cursor-commands
- Owner: emaraschio
- License: mit
- Created: 2026-05-24T22:48:12.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-29T14:16:10.000Z (about 1 month ago)
- Last Synced: 2026-05-30T06:03:50.063Z (about 1 month ago)
- Topics: agent-skills, ai-agents, cursor, cursor-ide, developer-tools, dotfiles, github-actions, prompts
- Language: Python
- Homepage: https://github.com/emaraschio/cursor-commands#readme
- Size: 154 KB
- Stars: 7
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
- Roadmap: docs/ROADMAP.md
Awesome Lists containing this project
README
# cursor-commands
[](https://github.com/emaraschio/cursor-commands/actions/workflows/validate.yml)
[](https://github.com/emaraschio/cursor-commands/actions/workflows/install-smoke.yml)
[](https://github.com/emaraschio/cursor-commands/actions/workflows/docs.yml)
[](https://github.com/emaraschio/cursor-commands/actions/workflows/eval-fixtures.yml)
**Stable release: [`v1.0.0`](CHANGELOG.md#100---2026-05-25)** — Generic Cursor slash commands, Agent Skills, and behavioral eval rubrics. Install from `main` or `git checkout v1.0.0` (the only published release tag). Ship-gate sections are enforced in CI via [docs/EVAL_CI.md](docs/EVAL_CI.md). Organization-specific packs install from the **host workspace**.
Inspired by install ergonomics from [hamzafer/cursor-commands](https://github.com/hamzafer/cursor-commands); this repo adds **skills**, **eval rubrics**, and **structural ship-gate CI** (`run-eval-fixtures.py --strict`).
## What you get
- **28** generic slash commands (git, review, security audits, PR workflows, requirement-to-implementation, etc.)
- **28** skill directories (one per command)
- **Behavioral evals** (`PASS` / `PARTIAL` / `FAIL`) per command — regression guardrails when editing prompts
## Installation
### Standalone clone
```bash
git clone https://github.com/emaraschio/cursor-commands.git
cd cursor-commands
chmod +x scripts/install.sh
./scripts/install.sh # merge mode (default)
```
Commands and skills from this catalog are symlinked into `~/.cursor/commands/` and `~/.cursor/skills/`. **Merge mode (default)** keeps your own files and host overlays (org-specific commands installed afterward). Use `./scripts/install.sh --replace` only if you want to wipe those directories first. Use `--prune` to remove stale symlinks that still point into this repo after a catalog rename.
### As a Git submodule
If a parent repo (for example personal dotfiles) vendors this tree:
```bash
cd path/to/parent-repo
git submodule update --init path/to/cursor-commands
./path/to/cursor-commands/scripts/install.sh
```
The parent repo owns workspace-specific Cursor **rules**, **agents**, and **memory-bank** files. This repo only ships shared slash commands and skills.
### Custom Cursor home
```bash
CURSOR_HOME="$HOME/.cursor" ./scripts/install.sh
# Host overlay: install generic, then org-specific symlinks from your dotfiles (merge-safe).
```
## Architecture
```text
.cursor/commands/.md # thin slash entry (YAML frontmatter)
.cursor/skills//
SKILL.md # full agent contract
eval/
cases.md # behavioral rubric
README.md # ship gate + how to score
```
Details: [COMMAND_SCHEMA.md](.cursor/docs/COMMAND_SCHEMA.md)
```mermaid
flowchart LR
slash["/command"] --> cmd["commands/name.md"]
cmd --> skill["skills/name/SKILL.md"]
skill --> eval["eval/cases.md"]
```
## Catalog
Full table: [COMMANDS_INDEX.md](.cursor/docs/COMMANDS_INDEX.md)
| Highlight | Description |
|-----------|-------------|
| `/merge-open-prs` | Batch review, Docker verify, merge when green (limit 10) |
| `/code-review` | Thorough PR review before approval |
**External dependency:** `/merge-open-prs` expects the user-global **babysit** skill at `~/.cursor/skills-cursor/babysit/SKILL.md`.
**Org-specific commands** (domain scripts, onboarding, custom security review, rules benchmarks) are **not** in this repo — install them from your host workspace overlay. See [docs/ROADMAP.md](docs/ROADMAP.md).
## Evaluations
We treat prompts like code: editable contracts need reviewable tests.
- **Structural checks in CI** — no LLM judge on every PR (flaky, expensive); ship-gate rows use `fixtures.yaml`.
- Each command defines **ship gate** sections in frontmatter (e.g. `A`, `S`; merge-open-prs uses `A`, `D`, `E`).
- Scoring: `PARTIAL` counts as fail; target 0 `FAIL` on ship gate before merge.
How to run: [EVAL_GUIDE.md](.cursor/docs/EVAL_GUIDE.md)
Example flow:
1. Read only `skills//SKILL.md`.
2. For each case in `eval/cases.md`, draft the agent response.
3. Mark `PASS` / `PARTIAL` / `FAIL`.
4. Fix skill/command before push if any ship-gate case fails.
After install, optional IDE check: [docs/VERIFICATION.md](docs/VERIFICATION.md)
## Validation
```bash
python3 scripts/validate-cursor-commands.py
python3 scripts/run-eval-fixtures.py --strict
```
CI on `main` and PRs: **validate**, **docs**, **install-smoke**, **eval-fixtures** (see branch protection). New releases: push tag `v*` to run [release.yml](.github/workflows/release.yml).
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md). Security reports: [SECURITY.md](SECURITY.md).
## Related
- [Cursor slash commands docs](https://cursor.com/docs/agent/chat/commands)
- [hamzafer/cursor-commands](https://github.com/hamzafer/cursor-commands) — minimal command-only collection
## License
MIT — see [LICENSE](LICENSE).