🌌 AntiGravity Skills

The “Cortex” for AI-Native Unity Development — 2026 Edition.

---

👋 Welcome to the Future of Game Dev

AntiGravity Skills is not just a code library — it’s a Standardized Knowledge Graph designed to bridge the gap between Human creativity and AI execution. Every skill is a portable, self-contained intelligence unit: agnostic to genre, platform, and project.

• For AI Agents (Gemini, Copilot, Cursor): Long-term memory + Senior Tech Lead. Provides context, architecture patterns, and “Do not hallucinate” constraints via the 2026 Tier Architecture.
• For Human Developers: A battle-tested modular framework. Need a system? Don’t write it from scratch — invoke it.

[!IMPORTANT] 🤖 Enables the “Tech Lead” Persona Loading AGENT.md activates the AntiGravity Architect persona. The agent acts as a Senior Mentor — explaining SOLID patterns, warning about GC pressure, and enforcing the 2026 TDD-First protocol while it builds.

---

🧩 What is a Skill?

A Skill is a packaged unit of capability that bridges general reasoning with domain-specific execution. When an AI Agent reads a SKILL.md, it gains:

1. Procedural Knowledge: Step-by-step workflows for specific problems.
2. Contextual Awareness: Rules and constraints to prevent common Unity pitfalls.
3. Templates: Pre-verified C# code ready for production.

---

🆕 2026 Standard — What Changed

[!NOTE] All 84 skills now carry full 2026-standard YAML metadata (requirements, context_discovery, performance_budget, tdd_first). All skills have TDD boilerplate. The audit v2.0.1 added standardized TDD contracts to all legacy skills — see Roadmap for the full refactoring plan.

---

🏗️ System Architecture

.agent/skills/
├── 00-core-engineering/      # C#12, GC Watchdog, Style Guide
├── 01-architecture/          # Service Locator, Repository, Command, FSM, Events
├── 02-gameplay/              # Combat, Camera, Minimap, Replay, Procedural Gen
├── 03-simulation-strategy/   # Grid Building, Resources, Waves  [Agnostic 2026]
├── 04-visuals-audio/         # Shaders, VFX, Lighting, Audio
├── 05-ui-ux/                 # MVVM, UI Toolkit, Accessibility (WCAG 2.1)
├── 06-performance/           # Job System, GPU Instancing, Texture Streaming
├── 07-tools-pipeline/        # Context Discovery, AI Code Reviewer, Validator
├── 08-backend-monetization/  # PlayFab Economy v2, UGS, Ads Mediation
├── 09-devops-automation/     # CI/CD, Build Pipelines
└── 00-meta-skills/           # Skill Creator, Project Scaffolder

2026 Tier Architecture

Every skill operates on 3 tiers, optimized for AI consumption:

[!IMPORTANT] Tier 1 is a hard-blocking gate. If requirements.unity_version or render_pipeline don’t match the project’s ContextReport, the agent must stop and report the incompatibility before writing any code. Proceeding without meeting requirements requires an explicit user --force override, which the agent must log visibly.

---

🏛️ Skill Catalog (84 Active Skills)

⚙️ Core Engineering (00-core-engineering)

• unified-style-guide — C#12, CoreCLR, Zero GC rules
• unity-compile-fixer ⭐ NEW — Agentic C# error repair loop
• coreclr-gc-watchdog ⭐ NEW — GC pressure classification + zero-alloc patterns
• csharp12-features-guide ⭐ NEW — Safety matrix for C#12 features in Unity 6

🏛 Architecture (01-architecture)

• service-locator-pattern ⭐ NEW — Type-safe SL with DI decision matrix
• repository-pattern ⭐ NEW — Generic IRepository with async I/O + mock
• command-pattern-undo ⭐ NEW — Undo/Redo history stack
• event-bus-system, finite-state-machine, save-load-serialization, asynchronous-programming

🎮 Gameplay (02-gameplay)

• procedural-generation ⭐ NEW — BSP Dungeon + Perlin Terrain with IGrid
• replay-system ⭐ NEW — Deterministic input recording + death-cam
• minimap-system ⭐ NEW — Orthographic RenderTexture minimap with icon layers
• player-movement-controller, camera-system-pro, combat-hitbox-system

🎯 Simulation & Strategy (03-simulation-strategy)

• grid-based-building-system, resource-management-system, horde-wave-logic, environment-hazard-system

🎨 Visuals & Audio (04-visuals-audio)

• shader-graph-expert, vfx-graph-shuriken, dynamic-audio-mixers, lighting-nav-baker

🖥️ UI/UX (05-ui-ux)

• mvvm-binding-system ⭐ NEW — Full MVVM for UI Toolkit with [CreateProperty]
• accessibility-hci ⭐ NEW — WCAG 2.1, colorblind shaders, control remapping
• canvas-performance, responsive-ui-design, input-system-new

⚡ Performance (06-performance)

• job-system-burst ⭐ NEW — Unity Jobs + Burst Compiler (0 GC, parallel CPU)
• gpu-instancing-expert ⭐ NEW — DrawMeshInstancedIndirect, 100k meshes/draw call
• texture-streaming-expert ⭐ NEW — Mip Streaming budget + TextureAuditTool
• object-pooling-system, addressables-asset-management, memory-profiler-expert

🛠️ Tools & Pipeline (07-tools-pipeline)

• context-discovery-agent ⭐ NEW — Auto-detects Unity version, RP, packages → ContextReport
• ai-code-reviewer ⭐ NEW — CRITICAL/WARNING/INFO code review checklist
• metadata-validator ⭐ NEW — Compliance audit script for all SKILL.md files
• automated-unit-testing, custom-editor-scripting, version-control-git

💰 Backend & Monetization (08-backend-monetization)

• playfab-economy-v2 ⭐ NEW — Economy v2 API (deprecates v1), IPlayFabEconomyService
• unity-gaming-services ⭐ NEW — UGS: Auth, Lobby, Relay, Leaderboards, Cloud Save
• ads-mediation-ironsource ⭐ NEW — LevelPlay rewarded/interstitial + GDPR consent
• analytics-heatmaps, monetization-iap, multiplayer-netcode

🚀 DevOps & Automation (09-devops-automation)

• build-pipeline-manager, unity-build-commander

---

🏷️ Skill Quality Tags

Every skill carries a tdd_first: field that signals its quality level:

Note: All skills now have tdd_first: true. The audit v2.0.1 added standardized TDD contracts to provide a starting point for test implementation.

---

⚡ 2026 Context Discovery Protocol

Before generating any code, the agent runs a pre-flight check:

// Produced by @context-discovery-agent
{
  "unity_version": "6000.1.2f1",
  "render_pipeline": "URP",
  "awaitable_api": true,
  "burst_available": true,
  "packages": ["com.unity.inputsystem", "com.unity.services.core"]
}

This ensures every generated script is compatible with your exact environment — no more “this only works in HDRP” surprises.

---

🛠️ Workflow

FOR AGENTS (The Loop)

1. Detect: Run @context-discovery-agent → get ContextReport.
2. Find: Locate the relevant skill in .agent/skills/.
3. Gate: Check requirements: in YAML frontmatter against ContextReport.
4. Read: Consume the SKILL.md body for architecture + patterns.
5. Implement: Inject from templates/, adapt to project context.
6. Review: Run @ai-code-reviewer before committing.

🧑‍💻 FOR HUMANS: Stop “Vibe Coding” Garbage

The biggest mistake developers make with AI tools (Copilot, Cursor, Gemini) is “Vibe Coding” — asking the AI to build systems without providing strict architectural boundaries. This results in spaghetti code, memory leaks, and unscalable games.

AntiGravity Skills CLI solves this by injecting production-ready, Senior-level patterns directly into your project.

Why use this?

• For Juniors: Stop guessing how to build an Object Pool or an Event Bus. The CLI injects clean, heavily-commented, industry-standard C# code directly into your project for you to study and use.
• For Seniors & AI: Every installed skill includes a SKILL.md file. When you ask your AI assistant to modify the injected code, it reads this file first. The strict rules inside prevent the AI from hallucinating or breaking the architecture.

How to use it (Zero Installation)

Thanks to npx, no local installation or repo cloning is required. The CLI checks your Unity version and Render Pipeline to prevent compatibility issues, then injects bare C# code (“Zero-Lock-In”) directly into Assets/Plugins/AntiGravitySkills/.

Run this from your Unity project root:

# 1. Search the catalog for the system you need
npx github:nlelouche/Unity-SkillForge list

# 2. Check its requirements (Unity version, packages) before installing
npx github:nlelouche/Unity-SkillForge info event-bus-system

# 3. Inject the code safely into your project
npx github:nlelouche/Unity-SkillForge add event-bus-system

Note for local AI Agents: You can still clone the full repo into .agent/skills/ if you want your agent to have permanent offline access to the entire knowledge graph.

git clone https://github.com/nlelouche/Unity-SkillForge.git .agent/skills

---

🗺️ Roadmap — v2.1 Next Skills

Based on architectural review and gap analysis, the following skills are prioritized for the next iteration:

---

📊 Repository Stats (2026 Edition)

---

🗂️ CHANGELOG

See CHANGELOG.md for the full history.

---

AntiGravity Skills — Where Code Meets Intelligence. 2026 Edition.