skill-forge

Use after generating code, after accepting AI suggestions, or when reviewing AI-written modules. Also use when code "works" but feels brittle, when error handling seems thin, when you notice orphaned resources or missing cleanup, or when the agent says "done" but you suspect hidden debt. Catches the specific failure patterns AI agents produce that humans wouldn't.

Generate architecture diagrams, dependency maps, and system documentation directly from your codebase. Reads source files, traces dependencies, identifies boundaries, and outputs Mermaid/PlantUML/C4 diagrams. Use when asked to document architecture, visualize dependencies, generate system diagrams, create C4 models, map service boundaries, understand a codebase structure, or produce technical documentation from existing code.

Generate a CONTEXT.md shared vocabulary for any project. Reduces agent verbosity by 50-75%, improves variable naming, makes conversations more precise. Interviews the user about domain terms, then produces a structured glossary the agent references every session. Use when starting a new project, onboarding to unfamiliar code, the agent is being too verbose, or conversations have too much jargon confusion. Also use when user says "build context", "shared language", "define terms", or "the agent doesn't understand my project vocabulary".

Enforce schema discipline: queries-first design, index-every-filter, safe migrations, verify-at-scale thinking. Prevents the common failure of designing schemas for demos that break in production. Use when creating tables, planning migrations, designing data models, or when user mentions database, schema, migration, indexing, multi-tenant.

Use when making UI/frontend changes in Cursor's Design Mode, when the user selects elements visually, draws annotations, or uses voice commands to describe changes. Also use when editing components from the integrated browser, when multi-selecting elements to match styles, when making iterative visual refinements, or when the agent receives visual context (screenshots, element selections, DOM references) alongside a change request.