Squirrel — Full-Cycle Software Development Skill
Overview
Squirrel is a full-cycle AI coding skill that works across 9 AI coding agents. It auto-detects project state (greenfield, in-progress, or mature) and adapts its 8-phase engineering pipeline accordingly. Instead of a one-size-fits-all workflow, it figures out where the project actually is and jumps in at exactly the right point.
When to Use This Skill
- Use when starting a new project from scratch (greenfield)
- Use when improving an existing codebase (in-progress or mature)
- Use when fixing bugs, adding features, or refactoring
- Use when adding tests, linting, or CI/CD to a project
- Use when writing production-grade documentation
- Use when the user says "build me", "fix this", "squirrel this project", or any multi-step development task
How It Works
Step 0: Detect Mode
Squirrel classifies the project directory:
| Signal |
Mode |
Entry Point |
| Empty directory |
Greenfield |
All 8 phases from scratch |
| Source files, no tests/docs |
In-Progress |
Audit first, then improve |
| Source + tests + CI + README |
Mature |
Targeted improvements |
| "fix this bug / add feature" |
Targeted |
Scoped work only |
The 8-Phase Pipeline
- Discover — Understand the project (audit existing code or gather requirements)
- Plan — Concrete task list with dependencies and done-criteria
- Build — Write or modify code (parallel sub-agents when supported)
- Test — Run existing tests, write new ones, 70%+ coverage target
- Bug Hunt — Static analysis + manual review
- Polish — Lint, format, type check, remove dead code
- Document — README + inline docs (update existing, don't overwrite)
- Ship — Final checklist: tests green, no secrets, CI configured
Failure Recovery (3-Strike Rule)
- Strike 1: Fix the specific error. Run tests. Move on.
- Strike 2: Re-read the code. Try a different approach.
- Strike 3: STOP. Revert. Document what failed. Ask the user.
Examples
Example 1: Build a REST API
> build me a REST API for a todo app with TypeScript and Express
Squirrel auto-detects greenfield mode and runs all 8 phases.
Example 2: Fix a bug
> fix this bug in src/auth/login.py
Squirrel enters targeted mode — abbreviated audit, scoped fix, verify.
Example 3: Improve existing project
> squirrel this project — add tests, fix lint errors, write README
Squirrel audits the existing codebase, then applies phases 4-8.
Best Practices
- Respects existing code — matches naming conventions, test framework, import style, and architecture
- Reads 2-3 similar files before writing a new one
- Never suppresses type errors with
as any or @ts-ignore
- Never deletes failing tests to "pass"
- Never leaves code in a broken state
Platform Compatibility
Squirrel works on: Claude Code, Codex, Cursor, Antigravity, Gemini CLI, GitHub Copilot, Windsurf, OpenCode, Aider (9 total).
Install with:
# Universal installer
npx skills add flyingsquirrel0419/squirrel-skill
Limitations
- Does not replace environment-specific validation or expert review
- CI/CD templates are starting points, not drop-in guarantees
- Parallel sub-agent execution depends on platform support
Related Skills
@brainstorming - For planning before implementation
@test-driven-development - For TDD-oriented workflows
@systematic-debugging - For methodical problem-solving
1---2name: squirrel3description: "Full-cycle AI coding skill: plans, builds, tests, lints, fixes bugs, and writes production-grade docs. Auto-detects project state and adapts its 8-phase pipeline."4category: development5risk: safe6source: community7source_repo: flyingsquirrel0419/squirrel-skill8source_type: community9license: "Apache-2.0"10license_source: "https://github.com/flyingsquirrel0419/squirrel-skill/blob/main/LICENSE"11date_added: "2026-04-29"12author: flying_squirrel__13tags: [development, testing, planning, code-review, documentation, ci-cd]14tools: [claude, cursor, codex, antigravity, gemini, windsurf, opencode, copilot]15metadata:16 source: https://skillmd.com/skills/mhassan0000/squirrel17---1819# Squirrel — Full-Cycle Software Development Skill2021## Overview2223Squirrel is a full-cycle AI coding skill that works across 9 AI coding agents. It auto-detects project state (greenfield, in-progress, or mature) and adapts its 8-phase engineering pipeline accordingly. Instead of a one-size-fits-all workflow, it figures out where the project actually is and jumps in at exactly the right point.2425## When to Use This Skill2627- Use when starting a new project from scratch (greenfield)28- Use when improving an existing codebase (in-progress or mature)29- Use when fixing bugs, adding features, or refactoring30- Use when adding tests, linting, or CI/CD to a project31- Use when writing production-grade documentation32- Use when the user says "build me", "fix this", "squirrel this project", or any multi-step development task3334## How It Works3536### Step 0: Detect Mode3738Squirrel classifies the project directory:3940| Signal | Mode | Entry Point |41|--------|------|-------------|42| Empty directory | Greenfield | All 8 phases from scratch |43| Source files, no tests/docs | In-Progress | Audit first, then improve |44| Source + tests + CI + README | Mature | Targeted improvements |45| "fix this bug / add feature" | Targeted | Scoped work only |4647### The 8-Phase Pipeline48491. **Discover** — Understand the project (audit existing code or gather requirements)502. **Plan** — Concrete task list with dependencies and done-criteria513. **Build** — Write or modify code (parallel sub-agents when supported)524. **Test** — Run existing tests, write new ones, 70%+ coverage target535. **Bug Hunt** — Static analysis + manual review546. **Polish** — Lint, format, type check, remove dead code557. **Document** — README + inline docs (update existing, don't overwrite)568. **Ship** — Final checklist: tests green, no secrets, CI configured5758### Failure Recovery (3-Strike Rule)59601. **Strike 1:** Fix the specific error. Run tests. Move on.612. **Strike 2:** Re-read the code. Try a different approach.623. **Strike 3:** STOP. Revert. Document what failed. Ask the user.6364## Examples6566### Example 1: Build a REST API6768```text69> build me a REST API for a todo app with TypeScript and Express70```7172Squirrel auto-detects greenfield mode and runs all 8 phases.7374### Example 2: Fix a bug7576```text77> fix this bug in src/auth/login.py78```7980Squirrel enters targeted mode — abbreviated audit, scoped fix, verify.8182### Example 3: Improve existing project8384```text85> squirrel this project — add tests, fix lint errors, write README86```8788Squirrel audits the existing codebase, then applies phases 4-8.8990## Best Practices9192- Respects existing code — matches naming conventions, test framework, import style, and architecture93- Reads 2-3 similar files before writing a new one94- Never suppresses type errors with `as any` or `@ts-ignore`95- Never deletes failing tests to "pass"96- Never leaves code in a broken state9798## Platform Compatibility99100Squirrel works on: Claude Code, Codex, Cursor, Antigravity, Gemini CLI, GitHub Copilot, Windsurf, OpenCode, Aider (9 total).101102Install with:103104```bash105# Universal installer106npx skills add flyingsquirrel0419/squirrel-skill107108```109110## Limitations111112- Does not replace environment-specific validation or expert review113- CI/CD templates are starting points, not drop-in guarantees114- Parallel sub-agent execution depends on platform support115116## Related Skills117118- `@brainstorming` - For planning before implementation119- `@test-driven-development` - For TDD-oriented workflows120- `@systematic-debugging` - For methodical problem-solving