
Break a system architecture into implementable work packages with clear tasks, dependencies, and integration contracts.
Implement database security through encryption, Row-Level Security, connection hardening, backups, and audit logging.
Write SQLAlchemy ORM models and queries following repository patterns, with guidance on when to use raw SQL.
Manage cloud resources using Infrastructure as Code (IaC) with Terraform or Pulumi to ensure reproducibility and prevent configuration drift.
# 🎭 Immersive Storybook Landing Page — Frontend Skill > **Build a cinematic, full-screen storybook-style landing page** with scroll-hijacked scene transitions, animated mascot/guide, glassmorphism UI, and dark-theme premium aesthetics. The user tells you what the product/page is about — you craft the experience. --- ## 📋 Skill Metadata | Key | Value | |-----|-------| | **Difficulty** | Advanced | | **Stack** | Next.js (App Router) · React 19 · TypeScript · Tailwind CSS · Framer Motion | |
# Testing Frontend — Verification & Quality Assurance > Ensure the storybook experience works flawlessly across devices, > browsers, and interaction modes before every deploy. --- ## Overview A full-screen, animation-heavy landing page has **unique testing challenges** that standard unit tests don't cover: | Challenge | Why Standard Tests Fail | | ---------------------------- | ---------------------------------------- | | Scene transitions | De
Initialize a Vite + React + TypeScript project with standardized directory structure, tooling, and configuration.
Refine, prioritize, and clean the product backlog to ensure the team is always working on the highest-value tasks.
# Bundling Frontend — Optimisation & Deployment > Ship a 60 fps storybook experience that loads fast on 3G, scores > 90+ on Lighthouse, and deploys in one command. --- ## Overview An animation-heavy, full-screen landing page has specific bundling concerns that differ from a typical content site: | Concern | Why It Matters | | ------------------------ | -------------------------------------------------- | | **JS bundle size** | Frame
Generate creative ideas, solve complex blocking problems, and explore alternative approaches using divergent and convergent thinking.
Build RESTful Flask routes with input validation, consistent response formatting, and pagination.
Perform a rigorous, full-spectrum security assessment of the codebase, infrastructure, and logic flows to identify and remediate vulnerabilities.
Design immersive, high-end page structures using Bento Grids, Asymmetry, and Sticky Scrolling. Reject the "Generic SaaS Template."
Turn structured requirements into a system architecture with defined components, boundaries, API contracts, and data storage strategy.
Configure Flask middleware for CORS, rate limiting, security headers, and request logging.
# 🧠 Managing State > Navigation engine, scroll hijacking, and state management for the storybook. --- ## Sub-Skills | # | File | What It Covers | |---|------|----------------| | 01 | [Navigation Engine](01-navigation-engine.md) | Wheel, touch, keyboard handlers + scroll detection + transition lock | --- ## State Overview The entire storybook has surprisingly little state: | State | Type | Purpose | |-------|------|---------| | `introState` | `"loading" \| "playing" \| "done"` | Controls
Quality gates and output validation — verify that agent deliverables meet acceptance criteria, maintain cross-agent consistency, and are ready for integration.
Manage sequential and parallel execution across specialist agents, maximizing throughput while respecting task dependencies.
Design and implement production-quality RAG (Retrieval-Augmented Generation) pipelines with hybrid search, reranking, agentic patterns, and continuous learning.
User registration, login, and password hashing with bcrypt for local authentication flows.
GitHub and Google OAuth 2.0 integration using Authlib for Flask applications.
Implement centralized error handling in Flask with custom exceptions, global handlers, and structured error responses.
Prepare and deploy the Flask application to a production environment using Gunicorn, Docker, and Nginx.
Set up a Flask application using the app factory pattern with blueprints, extensions, and environment-specific configuration.
Design normalized PostgreSQL schemas from tech specs, with proper constraints, naming conventions, and standard columns.
Diagnose and fix PostgreSQL performance issues using EXPLAIN ANALYZE, indexes, connection pooling, and query optimization.
Define the "Soul" of the project—its voice, visual texture, and emotional core. Moves beyond "colors and fonts" to "feeling and memory."
Ensure WCAG 2.2 AA compliance covering color contrast, keyboard navigation, screen reader support, accessible forms, and motion preferences.
Set up automated pipelines for linting, testing, and deployment using GitHub Actions.
Instrument the application with Logging, Metrics, and Tracing (OpenTelemetry) to understand system behavior and debug production issues.
Define Service Level Objectives (SLOs), manage Error Budgets, and conduct Incident Reviews to balance reliability with velocity.
# 🧱 Building Components > All visual components for the immersive storybook landing page. --- ## Sub-Skills | # | File | What It Covers | |---|------|----------------| | 01 | [Theme & CSS](01-theme-and-css.md) | CSS custom properties, glassmorphism, gradients, glow effects, keyframes | | 02 | [Scene Config](02-scene-config.md) | The PAGES[] data array, transition variants, TypeScript interfaces | | 03 | [Intro Sequence](03-intro-sequence.md) | Branded loading animation with sessionStorage p
# Integrating API — Data, Forms & Analytics > Wire up dynamic data, capture leads, and track engagement without > slowing down the immersive experience. --- ## Overview A storybook landing page is mostly **static visual theatre**, but three API touch-points turn it into a business tool: | Touch-Point | Purpose | Timing | | --------------------- | ---------------------------------- | ------------------- | | **Form submission** | Capture lea
# 🏗️ Scaffolding Frontend > Set up the Next.js + Tailwind + Framer Motion project foundation for an immersive storybook landing page. --- ## Prerequisites - Node.js 18+ - npm or pnpm --- ## Step 1 — Create the Next.js Project ```bash npx create-next-app@latest my-landing \ --typescript \ --tailwind \ --app \ --eslint \ --src-dir=false \ --import-alias="@/*" ``` This gives you: - App Router (`app/` directory) - TypeScript - Tailwind CSS 3+ - Path alias `@/*` mapping to projec
Implement a type-safe API client using TanStack Query and Axios/Fetch to handle data fetching, caching, and server state.
Build React components with TypeScript, composition patterns, and consistent structure.
Manage frontend state using Zustand for client state, TanStack Query for server state, and React Context for global static values.
Translate high-level requirements into specific, value-focused user stories with acceptance criteria.
Analyze third-party libraries and supply chain risks to ensure no compromised or vulnerable code enters the project.
Enforce safeguards specifically for AI Agents to prevent prompt injection, tool misuse, and excessive autonomy (OWASP Top 10 for Agents).
The git-workflow skill defines branching conventions, commit message formats, and pull request standards that all agents must follow for consistent version control.
Create clear, maintainable documentation for APIs, codebases, and end-users. Treat documentation as code.
Create and manage Alembic database migrations with safe upgrade and downgrade paths.
Generate production CSS from design tokens using Tailwind CSS or vanilla CSS. Maps tokens to Tailwind theme config and establishes CSS architecture.
JWT access tokens, refresh tokens, cookie management, token rotation, and revocation strategies.
The environment-config skill standardizes how agents manage environment variables, secrets, and application configuration across local development and deployed environments.
Implement features using the Red-Green-Refactor cycle to ensure testability and correctness from the start.
rigorous, evidence-based approach to identifying root causes of bugs using the Scientific Method (Hypothesis -> Experiment -> Conclusion).
Test Flask applications with pytest using fixtures, test client, factory data, and organized test structure.
Implement comprehensive frontend testing using Vitest for unit/integration tests and React Testing Library for component interactions.
Manage the `tasks.md` ledger with strict locking and collision avoidance protocols to allow multiple agents to work in parallel safely.
Configure Vite to build optimized production assets, handling code splitting, tree-shaking, and static asset management.
Decompose requirements into discrete tasks and delegate them to the most appropriate specialist agents based on their capabilities.
The code-review skill defines review standards, checklists, and comment conventions that agents follow when reviewing pull requests to maintain code quality and knowledge sharing.
Create a unique, soulful design system that avoids generic "AI Slop." Defines tokens for color, typography, spacing, and motion that feel handcrafted and intentional.
Securing authentication routes with CSRF protection, rate limiting, HTTPS enforcement, and brute force mitigation.
Translate natural-language requirements into structured, prioritized specifications with clear acceptance criteria.
Define project scope, milestones, MVP requirements, and roadmap to turn vague ideas into executable plans.