Windsurf & Devin Rules Pack: 86 Rules, 12 Skills and 9 AGENTS.md Templates for 8 Stacks

Stop pasting the same instructions into Cascade. Install rules that fit your stack and load only when they matter.

Windsurf & Devin Rules Pack: 86 Rules, 12 Skills and 9 AGENTS.md Templates for 8 Stacks product illustration

What it does

86 ready rule files and 12 skills for Devin Desktop (formerly Windsurf), in the current format: .devin/rules/*.md with trigger: frontmatter and .devin/skills/<name>/SKILL.md. They also install in the legacy .windsurf/rules + .windsurf/workflows layout. You also get an installer that detects your stack, a linter and a migrator for old Windsurf projects.

Python 3.9+, standard library only, no network, no API keys.

Install into your project

python3 tools/install.py /path/to/repo --detect --dry-run      # detect the stack + languages and show the plan
python3 tools/install.py /path/to/repo --detect --agents-md    # install; also writes AGENTS.md if you have none
python3 tools/install.py /path/to/repo --stack django --languages python,docker,github-actions
python3 tools/install.py . --stack nextjs --format windsurf    # older Windsurf: .windsurf/rules + .windsurf/workflows
python3 tools/install.py ~ --global                            # core rules + skills for every project

The installer:

  • Never overwrites a file you changed unless you pass --force, and it keeps a .bak-<time> copy when you do.
  • Lints what it wrote.
  • Prints the always-on size, meaning how many characters ride along with every message. A full stack install is about 2,000 characters always-on, and everything else loads by glob or on demand.

--format agents puts skills in .agents/skills/ (shared with other agents) instead of .devin/skills/.

What's inside

foldertriggercontents
rules/core (7)always_on (2 short ones) + model_decisionagent workflow, code review, security, testing, error handling, git commits, docs
rules/languages (13)globTypeScript, React, Tailwind, Node/Express, Python, Go, Rust, Docker, GitHub Actions, SQL migrations, Terraform, Flutter/Dart, Java/Spring Boot
rules/stacks (66)always_on overview + glob/model_decision detailNext.js 16 (11), Django (10), Rails 8 (9), Laravel 12 (8), Supabase (8), FastAPI (7), SvelteKit 2 + Svelte 5 (7), Expo (6)
skills (12)/name, or picked by the agentplan-feature, debug-issue, write-tests, review-changes, refactor-safely, fix-ci, security-pass, add-endpoint, db-migration, upgrade-dependency, release-checklist, commit-and-pr
templates/agents-md (9)AGENTS.mdone short AGENTS.md per stack plus a generic one

The rules are written so they're cheap to carry:

  • Overview rules are short and always on.
  • Detailed rules load only when a matching file is in play (trigger: glob) or when their description fits the task (model_decision).

Every glob uses whole-segment (src//*.ts, not src/.ts) and every model_decision rule has a description.

Mixing stacks: --languages typescript,+supabase adds a second stack's rules (e.g. Next.js + Supabase). The detector does this automatically when it sees @supabase/supabase-js.

Moving from Windsurf to Devin

python3 tools/migrate_windsurf.py --project . --dry-run     # see the plan
python3 tools/migrate_windsurf.py --project .               # write .devin/ (old files stay)
python3 tools/migrate_windsurf.py --global                  # ~/.codeium/windsurf/memories/global_rules.md -> ~/.devin/global_rules.md

What the migrator does:

  • .windsurfrules becomes .devin/rules/windsurfrules.md (always_on). With --rules-to-agents-md it is appended to AGENTS.md instead.
  • .windsurf/rules/*.md, including nested folders like packages/api/.windsurf/rules, moves to .devin/rules/, and the frontmatter is repaired on the way: - trigger: always becomes always_on. - Cursor/Kiro/Copilot keys (alwaysApply, inclusion, applyTo, fileMatchPattern) are converted. - A model_decision rule with no description gets its heading as the description.
  • .windsurf/global_rules.md becomes .devin/global_rules.md. When both exist, only the .devin one loads.
  • .windsurf/workflows/*.md becomes .devin/skills/<name>/SKILL.md with triggers: [user], so /name keeps working. Pass --skills-dir .agents/skills to put them in .agents/skills instead.
  • --fix-frontmatter repairs rules that are already in .devin/rules, keeping a .bak copy.

Devin still reads the legacy .windsurf folders, so nothing breaks while you check the result. Delete the old copies once the lint is clean, because duplicate rules load twice.

examples/windsurf-project/ is a broken legacy project you can try it on.

Lint

python3 tools/devin_rules_lint.py --project .             # rules, skills, AGENTS.md, legacy files, globs against your real files
python3 tools/devin_rules_lint.py --project . --strict --json

The lint catches rules and skills that silently never load or that cost too much:

  • unknown or misspelled triggers
  • glob rules without globs
  • model_decision rules without a description
  • another tool's frontmatter
  • inside a segment
  • globs that match no file
  • rules over the old 12,000/6,000-character limits
  • the always-on budget
  • the same rule in both .devin and .windsurf
  • an ignored .windsurf/global_rules.md
  • frontmatter in AGENTS.md
  • skills with a bad folder name, no description, bad triggers, or no SKILL.md

How it was tested

./run_tests.sh runs 21 tests:

  • Every shipped rule and skill is linted and checked for frontmatter, description, size and glob shape.
  • Glob semantics and frontmatter parsing are checked.
  • The linter runs on the broken example, the always-on budget, and duplicate rules.
  • The full migration runs on the example project, followed by a clean lint.
  • The migrator's dry run, no-overwrite, AGENTS.md, .agents/skills and --fix-frontmatter paths are covered.
  • Stack detection is checked.
  • The installer is checked in devin and windsurf format, for idempotence and for --force backups.

Run on Python 3.13 and 3.10.

Honest limits

  • Built from the Devin Desktop documentation as of November 2026 (rules, skills, the Windsurf migration guide). The product is changing quickly after the rename: if a path or frontmatter key changes, the linter follows the docs, not your build.
  • The rules are a good default, not your team's conventions. Edit them, because they're plain Markdown.
  • Stack rules assume current majors: Next.js 16, Django 5, Rails 8, Laravel 12, SvelteKit 2/Svelte 5, Expo SDK 5x, FastAPI with Pydantic v2. Trim what you don't use.
  • The linter reads files and doesn't run Devin, so it can't see rules set in the app's settings UI.
  • Not affiliated with Cognition, Devin or Windsurf.

Format and license

Zip, 101 KB, v1.0, 127 files. You may use and modify this kit for your own work and for clients you serve, including paid client work. Not affiliated with Cognition, Devin or Windsurf.

FAQ

Does it work with the old Windsurf app?
Yes. --format windsurf installs to .windsurf/rules and turns the skills into .windsurf/workflows. Devin Desktop still reads both, but .devin/ is the new home.
Will it overwrite my rules?
No. The installer skips any file you changed unless you pass --force, and then keeps a .bak copy. --dry-run shows the plan.
Can I mix stacks, like Next.js with Supabase?
Yes. --languages typescript,+supabase adds a second stack, and --detect does it automatically when it sees @supabase/supabase-js.
How do I get the files?
Pay by card right here on youraitools.co: your download links appear on this page the moment the payment goes through (claim window: 72 hours, up to 5 downloads per 7 days). Need the files re-sent later? Email hello@youraitools.co.
Refunds?
Email hello@youraitools.co within 14 days if it doesn’t work and we can’t fix it.
Can I pay with crypto?
Yes. Pay the same price in USDC or USDT on Base, Ethereum, Arbitrum, Optimism, Polygon or Solana from the "Pay with crypto" button, with no account or KYC. We check the payment on-chain and show your download links as soon as it confirms.

Get Windsurf & Devin Rules Pack: 86 Rules, 12 Skills and 9 AGENTS.md Templates for 8 Stacks

86 tested Windsurf / Devin Desktop rules for 8 stacks and 13 languages, 12 skills, AGENTS.md templates, a stack-detecting installer and a migrator. $15.

Pairs well with

Download$119

Agent Builder Bundle

Swarm Operator Kit + x402 Builder Skills + MCP Starter Kit. $119 instead of $157.

View Agent Builder Bundle
Download$89

Swarm Operator Kit

Run a team of AI agents as a business: charter, 5 roles, 6 skills, routines and scripts.

View Swarm Operator Kit

Related

1 email a week: new x402 + MCP tools and free kits.

Short weekly digest of new x402 + MCP tools and free kits, including the MCP OAuth Checker. No spam, unsubscribe any time.