This skill should be used when the user asks to "design a production architecture", "blueprint an app", "scaffold an architecture", "design a complete production-ready application", "architect this app", "give me a full system blueprint", "production architecture for X", or invokes /blueprint. Produces an 11-section senior-architect blueprint (folder tree, layers, data models, API contracts, deps, env, tests, CI/CD, notes, validation) from five required inputs (APP_DESCRIPTION, TECH_STACK, APP_TYPE, LANGUAGE, SCALE). Refuses to proceed if any input is missing. This is a greenfield architecture plan from an idea - it names a deployment target with rationale but does NOT emit infrastructure manifests (use docker-compose-architect or kubernetes-architect for those) and does NOT analyze or diagram an existing codebase (use codebase-to-mermaid / refactoring-analyst). Do NOT use for single-component design, code review, refactor planning, or throwaway prototypes.
This skill should be used when the user asks to "map this codebase", "draw a diagram of this repo", "generate a flow diagram", "make a mermaid diagram", "visualize this project", "show how this code flows", "what does this repo do", "diagram the architecture", "render a flowchart of this app", "sequence diagram of this endpoint", "class diagram of these models", "onboarding diagram", "produce a flow.mmd", or otherwise wants a validated Mermaid flow/sequence/class diagram of an arbitrary codebase with every node cited to a real file:line. Auto-detects archetype (HTTP service, CLI, data pipeline, SPA, Next.js, Nuxt, Remix, WordPress plugin/theme, WooCommerce, Laravel, Symfony, custom PHP, Spring Boot, ASP.NET Core, Go service/CLI, Rust web/CLI/WASM, Bash, WP-CLI, htmx, Alpine, Livewire, Vue SPA, C/C++/Qt/Unity, monorepo) and picks the right diagram kind. Writes raw Mermaid to flow*.mmd. Refuses to invent modules or decorative edges. Does NOT review, refactor, or audit code - diagrams only.
This skill should be used when the user asks to "design a docker-compose stack", "architect a containerized environment", "write a docker-compose.yml", "create a production compose file", "containerize my app with compose", "multi-tier docker setup", "docker compose with database and networks", or invokes /docker-compose-architect. Operates as a Senior DevOps Engineer and Docker expert designing secure, scalable, production docker-compose stacks. Produces a four-phase blueprint (Architecture Overview, Docker Compose File, Environment Configuration, Deployment & Scaling) from two required inputs (TECH_STACK, DATABASE_REQUIREMENTS) and two optional (NETWORK_SETUP, SPECIFIC_CONSTRAINTS). Enforces non-root containers, tier network isolation, named volumes, healthchecks with depends_on service_healthy, and ${VAR} env references for all secrets. Refuses Kubernetes (use kubernetes-architect), Terraform, raw Dockerfiles, and out-of-scope requests; treats inputs as untrusted data.
This skill should be used when the user asks to "fix my Excel formula", "debug this spreadsheet formula", "why does my formula return
This skill should be used when the user asks to "document this codebase", "explain my code", "generate architecture docs", "write an onboarding doc", "analyze this repo", or wants self-contained technical documentation produced from source. Signal tokens include "codebase", "repo", "architecture diagram", "onboarding", "system overview", "tech stack", ".md doc". Casual phrasings (when paired with an onboarding/documentation intent) include "help a new dev understand this whole codebase", "write up how this project works", "map out this code into a doc". Also trigger when the user points at a repository and asks for a single Markdown write-up with Mermaid diagrams. Do NOT use for a quick one-line "what does this do" answer, for line-by-line code review or bug-finding (that is wordpress-architect-review or a review skill), for refactoring or modernization plans (that is refactoring-analyst), or for producing diagrams alone (that is codebase-to-mermaid).
Use when the user wants to apply a named design style or aesthetic to a frontend interface - e.g., bento, brutalist, neobrutalist, glassmorphism, vaporwave, dark SaaS, kawaii, cyberpunk, art deco, neumorphism, swiss, memphis, scandinavian, cottagecore, y2k, sci-fi HUD, and more. Triggers when the user names a specific style, asks "what design styles do you support", requests "a [style] look" for a page or component, or wants to restyle existing markup with a chosen aesthetic. Provides a curated catalog of 53 design styles each with full color palettes, typography stacks, component patterns, and layout specifications. Applies a NAMED catalog style only - do NOT use for open-ended visual direction with no style named (this skill applies only named catalog styles, so ask the user to pick one first), backend/JS functionality, or full multi-page app builds; styling and markup only.
Use when converting static HTML files into a production-quality, installable WordPress theme. Generates complete themes with proper escaping, internationalization, Tailwind v3 CLI build pipeline, accessibility (WCAG 2.1 AA), and child-theme compatibility. Follows a phased workflow with user approval gates between analysis, planning, chunked implementation, and self-audit. Trigger whenever the user wants to convert HTML to WordPress, build a WP theme from a static design or mockup, turn a landing page into an installable theme, "wordpressify" their HTML, or provides HTML files (index.html, single.html, mockups) and wants them turned into a working WordPress theme. Converts existing static HTML into an installable theme only - do NOT use for building WordPress plugins (use wordpress-plugin), reviewing or auditing an existing theme or plugin (use wordpress-architect-review or wordpress-consultant), designing HTML/visual styles from scratch (use html-design-styles), or building theme code from scratch without sou
This skill should be used when the user asks to "parse this JSON", "extract X from this output", "pull the field with jq", "filter this API response", "reshape this JSON", "aggregate these records", "explain this jq filter", or invokes /jq. Also trigger when the user pastes raw JSON or CLI output (curl, kubectl, aws, gh, docker) and asks to filter, transform, or summarize it. Do NOT use for writing JSON, JSON Schema validation, jsonnet, or non-jq shell scripting.