A collection of Cursor IDE rules and agent skills for structured, subagent-driven development workflows.
Rules live in .cursor/rules/ within your project and are loaded automatically by the AI agent.
| Rule | Description |
|---|---|
| use-subagents.mdc | Mandates all tasks are delegated to subagents via the Task tool — no direct file edits, searches, or shell commands by the parent agent. |
Copy the .mdc files into your project's .cursor/rules/ directory:
mkdir -p .cursor/rules
cp rules/*.mdc .cursor/rules/Skills are reference documents that provide subagents with project-specific context. They live in ~/.cursor/skills-cursor/ and are automatically available to the AI agent.
| Skill | Subagent Type | Purpose |
|---|---|---|
| backend-changes | generalPurpose |
Python/FastAPI backend implementation |
| frontend-changes | generalPurpose |
React/TypeScript/Vite frontend implementation |
| git-operations | shell |
Commits, pushes, merges, branching |
| docker-build | shell / generalPurpose |
Docker image builds and Dockerfile debugging |
| test-runner | shell |
Running backend (pytest) and frontend (vitest) tests |
| codebase-explorer | explore |
Finding files, searching code, understanding architecture |
| dev-server | shell |
Starting/stopping development servers |
Copy the skill directories into your Cursor skills folder:
cp -r skills/* ~/.cursor/skills-cursor/The skills contain project-specific paths, conda environments, and framework details. Update these to match your own project:
- Workspace root — your project path
- Conda env — your Python environment name
- Ports — backend/frontend port numbers
- Framework details — your stack (FastAPI, React, etc.)
The use-subagents rule enforces a delegation pattern where the parent agent:
- Receives the user's request
- Breaks it into discrete tasks
- Launches each as a subagent (in parallel when independent)
- Summarises results back to the user
The parent agent only talks to the user and launches subagents — all actual work (reading, editing, searching, running commands) is performed by specialised subagents that receive full context from the skills.