Skip to content
Shell

chore: Update skills-manifest to v3.0.0 with full inventory

Eddie Belaval6a45f7f2755e
diff --git a/skills-manifest.json b/skills-manifest.json
index 7d5c314..9e4b109 100644
--- a/skills-manifest.json
+++ b/skills-manifest.json
@@ -1,22 +1,41 @@
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
- "version": "2.2.0",
- "description": "Complete skills manifest for syncing Claude Code skills across machines",
- "lastUpdated": "2025-12-26T12:00:00Z",
- "totalSkills": 20,
- "totalAgents": 4,
+ "version": "3.0.0",
+ "description": "Complete manifest for syncing Claude Code skills, agents, and plugins across machines",
+ "lastUpdated": "2026-01-03T20:15:00Z",
+ "totalSkills": 24,
+ "totalAgents": 39,
+ "totalPlugins": 1,
"categories": {
"business-ops": ["llc-ops", "id8labs"],
"nextjs-stack": ["nextjs-project-manager", "api-design", "database-design", "supabase-expert", "deployment-automation"],
"ui-ux": ["ui-builder", "state-management", "performance-optimization"],
"features": ["file-uploads", "email-notifications", "real-time-features", "analytics-tracking"],
- "quality": ["testing-qa", "error-monitoring"],
+ "quality": ["testing-qa", "error-monitoring", "verify"],
"billing": ["billing-security-auditor", "payment-flow-debugger", "subscription-lifecycle-manager"],
- "tooling": ["mcp-builder"],
+ "tooling": ["mcp-builder", "tui-builder"],
+ "appstore": ["appstore-readiness"],
+ "content": ["content-publishing"],
"senior-devs": ["nextjs-senior-dev"],
"image-generation": ["nana-image-generator"],
- "social-media": ["social-media-manager"],
- "content-production": ["notebooklm-producer"]
+ "social-media": ["social-media-manager", "x-viral-optimizer"],
+ "content-production": ["notebooklm-producer", "reality-tv-beat-writer"],
+ "mcp-specialists": ["mcp-protocol-specialist", "mcp-server-architect", "mcp-deployment-orchestrator", "mcp-registry-navigator", "mcp-integration-engineer", "mcp-testing-engineer", "mcp-security-auditor"],
+ "strategic": ["steve-jobs-advisor", "strategic-think-tank", "market-intelligence-analyst", "operations-manager", "relationship-builder"],
+ "automation": ["ralph-wiggum"]
+ },
+ "plugins": {
+ "ralph-wiggum": {
+ "name": "Ralph Wiggum - Autonomous Development Loops",
+ "description": "Implementation of Geoffrey Huntley's technique for autonomous development cycles. Uses Stop hooks to keep Claude working until completion criteria are met. Run tasks for hours without intervention.",
+ "source": "official",
+ "marketplace": "claude-plugins-official",
+ "installPath": "~/.claude/plugins/cache/claude-plugins-official/ralph-wiggum/1.0.0",
+ "version": "1.0.0",
+ "category": "automation",
+ "commands": ["ralph-loop", "cancel-ralph"],
+ "triggers": ["autonomous", "overnight", "loop", "ralph", "unattended", "continuous", "hours of work"]
+ }
},
"skills": {
"llc-ops": {
@@ -41,6 +60,41 @@
"category": "business-ops",
"agents": ["architect", "exit", "growth", "launch", "ops", "scout", "today", "tracker"]
},
+ "appstore-readiness": {
+ "name": "App Store Readiness",
+ "description": "Expert iOS App Store submission and approval system. 9 specialized agents ensure first-submission approval: Compliance, Design, Privacy, Commerce, Metadata, Technical, Timing, Recovery, Teaching.",
+ "source": "repo",
+ "repository": "eddiebe147/claude-settings",
+ "path": "skills/appstore-readiness",
+ "installPath": "~/.claude/skills/appstore-readiness",
+ "version": "1.0.0",
+ "category": "appstore",
+ "triggers": ["app store", "iOS submission", "apple review", "app rejection", "aso", "privacy manifest", "privacy labels", "ATT", "iap", "in-app purchase", "subscription", "storekit", "review guidelines", "HIG", "testflight", "app store connect"],
+ "commands": ["appstore-readiness", "appstore-review", "appstore-submit"]
+ },
+ "content-publishing": {
+ "name": "Content Publishing Pipeline",
+ "description": "Automated content publishing pipeline for ID8Labs. Generates essays in Eddie's voice, publishes to id8labs.app, and distributes to social media (X, LinkedIn).",
+ "source": "repo",
+ "repository": "eddiebe147/claude-settings",
+ "path": "skills/content-publishing",
+ "installPath": "~/.claude/skills/content-publishing",
+ "version": "1.0.0",
+ "category": "content",
+ "triggers": ["release", "announce", "publish", "essay", "research article", "content pipeline"],
+ "commands": ["announce-release", "write-release", "write-research", "publish-essay", "post-tweet", "post-linkedin"]
+ },
+ "verify": {
+ "name": "Verify Application",
+ "description": "Comprehensive verification skill for validating application health, tests, builds, and deployments.",
+ "source": "repo",
+ "repository": "eddiebe147/claude-settings",
+ "path": "skills/verify",
+ "installPath": "~/.claude/skills/verify",
+ "version": "1.0.0",
+ "category": "quality",
+ "commands": ["verify"]
+ },
"nextjs-project-manager": {
"name": "Next.js Project Manager",
"description": "Expert guide for Next.js 14+ App Router projects. Use when building features, routing, server/client components, forms, layouts, or debugging Next.js-specific issues.",
@@ -52,7 +106,7 @@
},
"api-design": {
"name": "API Design",
- "description": "Expert guide for RESTful API design, Next.js API routes, error handling, validation, and best practices. Use when building endpoints, handling requests, or designing API architecture.",
+ "description": "Expert guide for RESTful API design, Next.js API routes, error handling, validation, and best practices.",
"source": "repo",
"repository": "eddiebe147/claude-settings",
"path": "skills/api-design",
@@ -61,7 +115,7 @@
},
"database-design": {
"name": "Database Design",
- "description": "Expert guide for database schema design, Supabase/PostgreSQL best practices, RLS policies, and optimizations. Use when designing tables, relationships, or implementing data models.",
+ "description": "Expert guide for database schema design, Supabase/PostgreSQL best practices, RLS policies, and optimizations.",
"source": "repo",
"repository": "eddiebe147/claude-settings",
"path": "skills/database-design",
@@ -70,7 +124,7 @@
},
"supabase-expert": {
"name": "Supabase Expert",
- "description": "Expert guide for Supabase integration - database schemas, RLS policies, auth, Edge Functions, and real-time subscriptions. Use when working with Supabase backend features.",
+ "description": "Expert guide for Supabase integration - database schemas, RLS policies, auth, Edge Functions, and real-time subscriptions.",
"source": "repo",
"repository": "eddiebe147/claude-settings",
"path": "skills/supabase-expert",
@@ -79,7 +133,7 @@
},
"deployment-automation": {
"name": "Deployment Automation",
- "description": "Expert guide for deploying Next.js apps to Vercel, managing environments, CI/CD pipelines, and production best practices. Use when deploying, setting up automation, or managing production.",
+ "description": "Expert guide for deploying Next.js apps to Vercel, managing environments, CI/CD pipelines, and production best practices.",
"source": "repo",
"repository": "eddiebe147/claude-settings",
"path": "skills/deployment-automation",
@@ -88,7 +142,7 @@
},
"ui-builder": {
"name": "UI Builder",
- "description": "Expert guide for building beautiful, responsive UI with React, Tailwind CSS, Shadcn/ui, and modern design patterns. Use when creating components, layouts, animations, or styling.",
+ "description": "Expert guide for building beautiful, responsive UI with React, Tailwind CSS, Shadcn/ui, and modern design patterns.",
"source": "repo",
"repository": "eddiebe147/claude-settings",
"path": "skills/ui-builder",
@@ -97,7 +151,7 @@
},
"state-management": {
"name": "State Management",
- "description": "Expert guide for React state management with Zustand, Context, and modern patterns. Use when managing global state, forms, complex UI state, or optimizing re-renders.",
+ "description": "Expert guide for React state management with Zustand, Context, and modern patterns.",
"source": "repo",
"repository": "eddiebe147/claude-settings",
"path": "skills/state-management",
@@ -106,7 +160,7 @@
},
"performance-optimization": {
"name": "Performance Optimization",
- "description": "Expert guide for optimizing Next.js performance - images, fonts, code splitting, caching, and Core Web Vitals. Use when improving load times or debugging performance issues.",
+ "description": "Expert guide for optimizing Next.js performance - images, fonts, code splitting, caching, and Core Web Vitals.",
"source": "repo",
"repository": "eddiebe147/claude-settings",
"path": "skills/performance-optimization",
@@ -115,7 +169,7 @@
},
"file-uploads": {
"name": "File Uploads",
- "description": "Expert guide for handling file uploads, image optimization, cloud storage (Supabase, S3, Cloudinary), and file management. Use when implementing file upload features or managing user assets.",
+ "description": "Expert guide for handling file uploads, image optimization, cloud storage (Supabase, S3, Cloudinary), and file management.",
"source": "repo",
"repository": "eddiebe147/claude-settings",
"path": "skills/file-uploads",
@@ -124,7 +178,7 @@
},
"email-notifications": {
"name": "Email Notifications",
- "description": "Expert guide for sending transactional emails, creating templates, scheduling notifications, and email best practices. Use when implementing email functionality, notifications, or campaigns.",
+ "description": "Expert guide for sending transactional emails, creating templates, scheduling notifications, and email best practices.",
"source": "repo",
"repository": "eddiebe147/claude-settings",
"path": "skills/email-notifications",
@@ -133,7 +187,7 @@
},
"real-time-features": {
"name": "Real-Time Features",
- "description": "Expert guide for real-time features using Supabase Realtime, WebSockets, live updates, presence, and collaborative features. Use when building chat, live updates, or collaborative apps.",
+ "description": "Expert guide for real-time features using Supabase Realtime, WebSockets, live updates, presence, and collaborative features.",
"source": "repo",
"repository": "eddiebe147/claude-settings",
"path": "skills/real-time-features",
@@ -142,7 +196,7 @@
},
"analytics-tracking": {
"name": "Analytics Tracking",
- "description": "Expert guide for tracking user analytics, events, conversions, A/B testing, and data-driven insights. Use when implementing analytics, tracking user behavior, or optimizing conversions.",
+ "description": "Expert guide for tracking user analytics, events, conversions, A/B testing, and data-driven insights.",
"source": "repo",
"repository": "eddiebe147/claude-settings",
"path": "skills/analytics-tracking",
@@ -151,7 +205,7 @@
},
"testing-qa": {
"name": "Testing & QA",
- "description": "Expert guide for testing Next.js applications with Playwright, Jest, and React Testing Library. Use when writing tests, debugging test failures, or setting up test infrastructure.",
+ "description": "Expert guide for testing Next.js applications with Playwright, Jest, and React Testing Library.",
"source": "repo",
"repository": "eddiebe147/claude-settings",
"path": "skills/testing-qa",
@@ -160,7 +214,7 @@
},
"error-monitoring": {
"name": "Error Monitoring",
- "description": "Expert guide for error handling, logging, monitoring, and debugging. Use when implementing error boundaries, logging systems, or integrating monitoring tools like Sentry.",
+ "description": "Expert guide for error handling, logging, monitoring, and debugging. Use when implementing error boundaries or integrating monitoring tools.",
"source": "repo",
"repository": "eddiebe147/claude-settings",
"path": "skills/error-monitoring",
@@ -199,72 +253,303 @@
},
"mcp-builder": {
"name": "MCP Builder",
- "description": "Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services. Use when building MCP servers in Python (FastMCP) or Node/TypeScript.",
+ "description": "Guide for creating high-quality MCP servers that enable LLMs to interact with external services. Use when building MCP servers in Python (FastMCP) or Node/TypeScript.",
"source": "repo",
"repository": "eddiebe147/claude-settings",
"path": "skills/mcp-builder",
"installPath": "~/.claude/skills/mcp-builder",
"category": "tooling"
+ },
+ "tui-builder": {
+ "name": "TUI Builder - Senior Terminal UI Designer",
+ "description": "Master-level terminal UI design covering 4 frameworks (Bubbletea, Ink, Textual, Ratatui), 10+ aesthetic styles, full design system, and clig.dev UX best practices.",
+ "source": "repo",
+ "repository": "eddiebe147/claude-settings",
+ "path": "skills/tui-builder",
+ "installPath": "~/.claude/skills/tui-builder",
+ "version": "1.0.0",
+ "category": "tooling",
+ "triggers": ["tui", "terminal ui", "terminal interface", "cli app", "bubbletea", "textual", "ink", "ratatui", "terminal dashboard"]
}
},
"agents": {
"nextjs-senior-dev": {
"name": "NEXUS - Next.js Senior Developer",
- "description": "Principal-level Next.js 14+ specialist. Use for complex App Router patterns, RSC optimization, middleware debugging, and architecture decisions.",
- "source": "repo",
- "repository": "eddiebe147/claude-settings",
+ "description": "Principal-level Next.js 14+ specialist for complex App Router patterns, RSC optimization, middleware debugging, and architecture decisions.",
"path": "agents/nextjs-senior-dev.md",
"installPath": "~/.claude/agents/nextjs-senior-dev.md",
- "version": "1.0.0",
- "category": "senior-devs",
- "model": "sonnet",
- "color": "blue"
+ "category": "senior-devs"
},
"nana-image-generator": {
"name": "NANO - NANA Image Generator",
- "description": "Expert operator for NANA (Nana Banana Pro) image generation model. Crafts optimized prompts, selects styles, and manages image generation workflows.",
- "source": "repo",
- "repository": "eddiebe147/claude-settings",
+ "description": "Expert operator for NANA (Nana Banana Pro) image generation model. Crafts optimized prompts and manages image generation workflows.",
"path": "agents/nana-image-generator.md",
"installPath": "~/.claude/agents/nana-image-generator.md",
- "version": "1.0.0",
- "category": "image-generation",
- "model": "sonnet",
- "color": "yellow"
+ "category": "image-generation"
},
"social-media-manager": {
"name": "ECHO - Social Media Manager",
"description": "Strategic social media manager for multi-platform content creation, engagement optimization, and brand voice management.",
- "source": "repo",
- "repository": "eddiebe147/claude-settings",
"path": "agents/social-media-manager.md",
"installPath": "~/.claude/agents/social-media-manager.md",
- "version": "1.0.0",
- "category": "social-media",
- "model": "sonnet",
- "color": "purple"
+ "category": "social-media"
+ },
+ "x-viral-optimizer": {
+ "name": "X Viral Optimizer",
+ "description": "Optimize content for maximum viral potential on X (Twitter). Algorithmic optimization, hook crafting, and engagement strategies.",
+ "path": "agents/x-viral-optimizer.md",
+ "installPath": "~/.claude/agents/x-viral-optimizer.md",
+ "category": "social-media"
},
"notebooklm-producer": {
"name": "OPUS - NotebookLM Producer",
- "description": "Creates audio and video assets using Google NotebookLM. Handles Audio Overviews (Deep Dive, Brief, Critique, Debate), video generation, and interactive sessions.",
- "source": "repo",
- "repository": "eddiebe147/claude-settings",
+ "description": "Creates audio and video assets using Google NotebookLM. Handles Audio Overviews (Deep Dive, Brief, Critique, Debate) and video generation.",
"path": "agents/notebooklm-producer.md",
"installPath": "~/.claude/agents/notebooklm-producer.md",
- "version": "1.0.0",
- "category": "content-production",
- "model": "sonnet",
- "color": "green"
+ "category": "content-production"
+ },
+ "reality-tv-beat-writer": {
+ "name": "Reality TV Beat Writer",
+ "description": "Create documentary-style beat sheets, interview questions, and production materials for reality TV shows.",
+ "path": "agents/reality-tv-beat-writer.md",
+ "installPath": "~/.claude/agents/reality-tv-beat-writer.md",
+ "category": "content-production"
+ },
+ "steve-jobs-advisor": {
+ "name": "Steve Jobs Advisor",
+ "description": "Visionary product leadership and strategic guidance. Push beyond conventional thinking for product decisions and creative challenges.",
+ "path": "agents/steve-jobs-advisor.md",
+ "installPath": "~/.claude/agents/steve-jobs-advisor.md",
+ "category": "strategic"
+ },
+ "strategic-think-tank": {
+ "name": "Strategic Think Tank",
+ "description": "RESTRICTED: Only for MAJOR business decisions (pivots, acquisitions over $1M, fundamental model changes). Multi-perspective strategic analysis.",
+ "path": "agents/strategic-think-tank.md",
+ "installPath": "~/.claude/agents/strategic-think-tank.md",
+ "category": "strategic",
+ "restricted": true
+ },
+ "market-intelligence-analyst": {
+ "name": "Market Intelligence Analyst",
+ "description": "Comprehensive market research, trend analysis, competitor intelligence, and strategic market insights.",
+ "path": "agents/market-intelligence-analyst.md",
+ "installPath": "~/.claude/agents/market-intelligence-analyst.md",
+ "category": "strategic"
+ },
+ "operations-manager": {
+ "name": "Operations Manager",
+ "description": "Sophisticated operational management, project coordination, quality control, and process optimization.",
+ "path": "agents/operations-manager.md",
+ "installPath": "~/.claude/agents/operations-manager.md",
+ "category": "strategic"
+ },
+ "relationship-builder": {
+ "name": "Relationship Builder",
+ "description": "Navigate complex business relationships, develop client connections, and handle delicate negotiations.",
+ "path": "agents/relationship-builder.md",
+ "installPath": "~/.claude/agents/relationship-builder.md",
+ "category": "strategic"
+ },
+ "backend-architect": {
+ "name": "Backend Architect",
+ "description": "Backend system architecture and API design specialist for RESTful APIs, microservice boundaries, and scalability planning.",
+ "path": "agents/backend-architect.md",
+ "installPath": "~/.claude/agents/backend-architect.md",
+ "category": "senior-devs"
+ },
+ "database-migration-specialist": {
+ "name": "Database Migration Specialist",
+ "description": "Expert in database migrations, schema evolution, and data transformation strategies.",
+ "path": "agents/database-migration-specialist.md",
+ "installPath": "~/.claude/agents/database-migration-specialist.md",
+ "category": "senior-devs"
+ },
+ "mcp-protocol-specialist": {
+ "name": "MCP Protocol Specialist",
+ "description": "MCP protocol specification and standards. Protocol design, specification compliance, and transport implementation.",
+ "path": "agents/mcp-protocol-specialist.md",
+ "installPath": "~/.claude/agents/mcp-protocol-specialist.md",
+ "category": "mcp-specialists"
+ },
+ "mcp-server-architect": {
+ "name": "MCP Server Architect",
+ "description": "MCP server architecture and implementation. Server design, transport layers, tool definitions, and protocol compliance.",
+ "path": "agents/mcp-server-architect.md",
+ "installPath": "~/.claude/agents/mcp-server-architect.md",
+ "category": "mcp-specialists"
+ },
+ "mcp-deployment-orchestrator": {
+ "name": "MCP Deployment Orchestrator",
+ "description": "MCP server deployment and operations. Containerization, Kubernetes, autoscaling, monitoring, and security hardening.",
+ "path": "agents/mcp-deployment-orchestrator.md",
+ "installPath": "~/.claude/agents/mcp-deployment-orchestrator.md",
+ "category": "mcp-specialists"
+ },
+ "mcp-registry-navigator": {
+ "name": "MCP Registry Navigator",
+ "description": "MCP registry discovery and integration. Finding servers, evaluating capabilities, and publishing to registries.",
+ "path": "agents/mcp-registry-navigator.md",
+ "installPath": "~/.claude/agents/mcp-registry-navigator.md",
+ "category": "mcp-specialists"
+ },
+ "mcp-integration-engineer": {
+ "name": "MCP Integration Engineer",
+ "description": "MCP server integration and orchestration. Client-server integration, multi-server orchestration, and workflow automation.",
+ "path": "agents/mcp-integration-engineer.md",
+ "installPath": "~/.claude/agents/mcp-integration-engineer.md",
+ "category": "mcp-specialists"
+ },
+ "mcp-testing-engineer": {
+ "name": "MCP Testing Engineer",
+ "description": "MCP server testing and quality assurance. Protocol compliance, security testing, and performance evaluation.",
+ "path": "agents/mcp-testing-engineer.md",
+ "installPath": "~/.claude/agents/mcp-testing-engineer.md",
+ "category": "mcp-specialists"
+ },
+ "mcp-security-auditor": {
+ "name": "MCP Security Auditor",
+ "description": "MCP server security specialist. Security reviews, OAuth implementation, RBAC design, and vulnerability assessment.",
+ "path": "agents/mcp-security-auditor.md",
+ "installPath": "~/.claude/agents/mcp-security-auditor.md",
+ "category": "mcp-specialists"
+ },
+ "payment-security-specialist": {
+ "name": "Payment Security Specialist",
+ "description": "Payment security and compliance specialist for PCI-DSS, fraud prevention, and secure payment flows.",
+ "path": "agents/payment-security-specialist.md",
+ "installPath": "~/.claude/agents/payment-security-specialist.md",
+ "category": "billing"
+ },
+ "stripe-integration-specialist": {
+ "name": "Stripe Integration Specialist",
+ "description": "Expert Stripe integration for payments, subscriptions, webhooks, and checkout flows.",
+ "path": "agents/stripe-integration-specialist.md",
+ "installPath": "~/.claude/agents/stripe-integration-specialist.md",
+ "category": "billing"
+ },
+ "usage-tracking-specialist": {
+ "name": "Usage Tracking Specialist",
+ "description": "Usage-based billing implementation, metering, and consumption tracking.",
+ "path": "agents/usage-tracking-specialist.md",
+ "installPath": "~/.claude/agents/usage-tracking-specialist.md",
+ "category": "billing"
+ },
+ "email-notification-specialist": {
+ "name": "Email Notification Specialist",
+ "description": "Transactional email implementation, templates, and notification systems.",
+ "path": "agents/email-notification-specialist.md",
+ "installPath": "~/.claude/agents/email-notification-specialist.md",
+ "category": "features"
+ },
+ "chat-test-runner": {
+ "name": "Chat Test Runner",
+ "description": "Automated testing for chat and conversation interfaces.",
+ "path": "agents/chat-test-runner.md",
+ "installPath": "~/.claude/agents/chat-test-runner.md",
+ "category": "quality"
+ },
+ "watcher-code-quality-guardian": {
+ "name": "Watcher: Code Quality Guardian",
+ "description": "Automated code quality monitoring and enforcement.",
+ "path": "agents/watcher-code-quality-guardian.md",
+ "installPath": "~/.claude/agents/watcher-code-quality-guardian.md",
+ "category": "quality"
+ },
+ "watcher-database-integrity": {
+ "name": "Watcher: Database Integrity",
+ "description": "Database integrity monitoring and validation.",
+ "path": "agents/watcher-database-integrity.md",
+ "installPath": "~/.claude/agents/watcher-database-integrity.md",
+ "category": "quality"
+ },
+ "watcher-payment-flow-tester": {
+ "name": "Watcher: Payment Flow Tester",
+ "description": "Automated payment flow testing and validation.",
+ "path": "agents/watcher-payment-flow-tester.md",
+ "installPath": "~/.claude/agents/watcher-payment-flow-tester.md",
+ "category": "quality"
+ },
+ "watcher-security-validator": {
+ "name": "Watcher: Security Validator",
+ "description": "Security validation and vulnerability scanning.",
+ "path": "agents/watcher-security-validator.md",
+ "installPath": "~/.claude/agents/watcher-security-validator.md",
+ "category": "quality"
+ },
+ "bebop-devops-agent": {
+ "name": "Bebop - DevOps Agent",
+ "description": "TMNT-themed DevOps automation and infrastructure management.",
+ "path": "agents/bebop-devops-agent.md",
+ "installPath": "~/.claude/agents/bebop-devops-agent.md",
+ "category": "tmnt-suite"
+ },
+ "casey-tester-agent": {
+ "name": "Casey - Tester Agent",
+ "description": "TMNT-themed testing and QA automation.",
+ "path": "agents/casey-tester-agent.md",
+ "installPath": "~/.claude/agents/casey-tester-agent.md",
+ "category": "tmnt-suite"
+ },
+ "donatello-architect-agent": {
+ "name": "Donatello - Architect Agent",
+ "description": "TMNT-themed technical architecture and system design.",
+ "path": "agents/donatello-architect-agent.md",
+ "installPath": "~/.claude/agents/donatello-architect-agent.md",
+ "category": "tmnt-suite"
+ },
+ "krang-brain-agent": {
+ "name": "Krang - Brain Agent",
+ "description": "TMNT-themed AI/ML and intelligent automation.",
+ "path": "agents/krang-brain-agent.md",
+ "installPath": "~/.claude/agents/krang-brain-agent.md",
+ "category": "tmnt-suite"
+ },
+ "leonardo-strategist-agent": {
+ "name": "Leonardo - Strategist Agent",
+ "description": "TMNT-themed strategic planning and project leadership.",
+ "path": "agents/leonardo-strategist-agent.md",
+ "installPath": "~/.claude/agents/leonardo-strategist-agent.md",
+ "category": "tmnt-suite"
+ },
+ "michelangelo-builder-agent": {
+ "name": "Michelangelo - Builder Agent",
+ "description": "TMNT-themed creative development and UI implementation.",
+ "path": "agents/michelangelo-builder-agent.md",
+ "installPath": "~/.claude/agents/michelangelo-builder-agent.md",
+ "category": "tmnt-suite"
+ },
+ "raphael-guardian-agent": {
+ "name": "Raphael - Guardian Agent",
+ "description": "TMNT-themed security and code protection.",
+ "path": "agents/raphael-guardian-agent.md",
+ "installPath": "~/.claude/agents/raphael-guardian-agent.md",
+ "category": "tmnt-suite"
+ },
+ "rocksteady-database-agent": {
+ "name": "Rocksteady - Database Agent",
+ "description": "TMNT-themed database management and optimization.",
+ "path": "agents/rocksteady-database-agent.md",
+ "installPath": "~/.claude/agents/rocksteady-database-agent.md",
+ "category": "tmnt-suite"
+ },
+ "splinter-mentor-agent": {
+ "name": "Splinter - Mentor Agent",
+ "description": "TMNT-themed code review, mentorship, and best practices.",
+ "path": "agents/splinter-mentor-agent.md",
+ "installPath": "~/.claude/agents/splinter-mentor-agent.md",
+ "category": "tmnt-suite"
}
},
"syncInstructions": {
- "description": "To sync skills to a new machine:",
+ "description": "To sync everything to a new machine:",
"steps": [
"1. Clone: git clone https://github.com/eddiebe147/claude-settings.git ~/Development/claude-settings",
- "2. Sync all skills: cp -r ~/Development/claude-settings/skills/* ~/.claude/skills/",
- "3. Sync all agents: cp -r ~/Development/claude-settings/agents/* ~/.claude/agents/",
- "4. Verify: ls ~/.claude/skills/ && ls ~/.claude/agents/"
+ "2. Sync skills: cp -r ~/Development/claude-settings/skills/* ~/.claude/skills/",
+ "3. Sync agents: cp -r ~/Development/claude-settings/agents/* ~/.claude/agents/",
+ "4. Sync plugins: cp -r ~/Development/claude-settings/plugins/* ~/.claude/plugins/",
+ "5. Verify: ls ~/.claude/skills/ && ls ~/.claude/agents/ && ls ~/.claude/plugins/"
],
- "quickSync": "git clone https://github.com/eddiebe147/claude-settings.git /tmp/cs && cp -r /tmp/cs/skills/* ~/.claude/skills/ && cp -r /tmp/cs/agents/* ~/.claude/agents/ && rm -rf /tmp/cs"
+ "quickSync": "git clone https://github.com/eddiebe147/claude-settings.git /tmp/cs && cp -r /tmp/cs/skills/* ~/.claude/skills/ && cp -r /tmp/cs/agents/* ~/.claude/agents/ && cp -r /tmp/cs/plugins/* ~/.claude/plugins/ && rm -rf /tmp/cs"
}
}
diff --git a/skills/tui-builder/SKILL.md b/skills/tui-builder/SKILL.md
new file mode 100644
index 0000000..c00acb0
--- /dev/null
+++ b/skills/tui-builder/SKILL.md
@@ -0,0 +1,593 @@
+# TUI Builder - Senior Terminal UI Designer & Developer
+
+> Master-level terminal interface design and development across all languages and aesthetics.
+
+## Role
+
+You are a **Senior TUI Designer & Developer** with expertise in:
+- **Visual Design** - Typography, color theory, layout, animation
+- **Multiple Aesthetics** - Corporate, Hacker, Retro/DOS, Cyberpunk, Minimal, and more
+- **Framework Mastery** - Bubbletea, Ink, Textual, Ratatui
+- **UX Excellence** - clig.dev best practices, accessibility, responsive design
+
+When building TUIs, you don't just code—you **design**. Every interface should have intentional visual hierarchy, consistent styling, and a cohesive aesthetic.
+
+## Reference Documents
+
+| Document | Purpose |
+|----------|---------|
+| `reference/design-system.md` | Typography, color theory, layout patterns, components |
+| `reference/style-presets.md` | 10+ style presets (Corporate, Hacker, Cyberpunk, etc.) |
+| `reference/cli-ux-guidelines.md` | clig.dev UX best practices |
+| `reference/bubbletea.md` | Go framework deep-dive |
+| `reference/ink.md` | JavaScript/TypeScript framework |
+| `reference/textual.md` | Python framework |
+| `reference/ratatui.md` | Rust framework |
+
+## Trigger Keywords
+
+- `tui`, `terminal ui`, `terminal interface`
+- `cli app`, `command line application`, `cli tool`
+- `bubbletea`, `textual`, `ink`, `ratatui`, `charm`
+- `terminal dashboard`, `terminal form`, `terminal menu`
+- `progress bar`, `spinner`, `interactive cli`
+- `retro`, `hacker style`, `cyberpunk`, `minimal`, `corporate`
+- `pip-boy`, `dos style`, `synthwave`, `nord`, `dracula`
+
+## Quick Start
+
+When user wants to build a TUI:
+
+1. **Clarify the aesthetic** - What style/vibe? (See style presets)
+2. **Detect project context** - Check for existing language/framework
+3. **Recommend framework** - Based on language and use case
+4. **Design first** - Sketch the layout, choose colors, plan hierarchy
+5. **Scaffold structure** - Generate boilerplate with styling baked in
+6. **Implement features** - Build components following framework patterns
+
+## Style Selection
+
+Ask the user early: **"What aesthetic are you going for?"**
+
+| Style | Vibe | Best For |
+|-------|------|----------|
+| Corporate | Clean, professional, trustworthy | Enterprise tools, B2B |
+| Hacker | Matrix-style, green-on-black | Dev tools, security |
+| Retro/DOS | 80s computing, CGA colors | Games, novelty |
+| Cyberpunk | Neon, glitch, high-tech | Monitoring, dashboards |
+| Minimal | Zen, focused, clean | Productivity, writing |
+| Pip-Boy | Fallout amber CRT | Games, themed apps |
+| Synthwave | 80s neon, vaporwave | Music, creative tools |
+| Nord | Arctic, calm, muted | Code editors, everyday |
+| Dracula | Dark, purple accents | Dev environments |
+| Gruvbox | Warm, earthy, retro | Text-heavy apps |
+
+See `reference/style-presets.md` for full palettes and implementation guides.
+
+---
+
+## Framework Selection Matrix
+
+| If Project Has... | Recommend | Why |
+|-------------------|-----------|-----|
+| `go.mod` | **Bubbletea** | Best Go TUI, Elm architecture, huge ecosystem |
+| `package.json` | **Ink** | React patterns, familiar to JS devs |
+| `pyproject.toml` / `requirements.txt` | **Textual** | Modern Python TUI, CSS-like styling |
+| `Cargo.toml` | **Ratatui** | Fast, low-level control, Rust safety |
+| No existing project | Ask user preference, default to **Ink** for quick prototypes |
+
+### Framework Comparison
+
+```
+┌─────────────┬────────────┬─────────────────┬──────────────────┐
+│ Framework │ Language │ Architecture │ Best For │
+├─────────────┼────────────┼─────────────────┼──────────────────┤
+│ Bubbletea │ Go │ Elm MVU │ Production CLIs │
+│ Ink │ JS/TS │ React │ Quick prototypes │
+│ Textual │ Python │ Reactive/CSS │ Dashboards │
+│ Ratatui │ Rust │ Immediate mode │ Performance │
+└─────────────┴────────────┴─────────────────┴──────────────────┘
+```
+
+---
+
+## Core Principles (from clig.dev)
+
+### 1. Human-First Design
+```
+DO: Design for humans interacting directly
+DON'T: Assume machine-to-machine only
+```
+
+### 2. Show Progress Always
+```
+< 100ms → No indicator needed
+100ms-1s → Spinner
+> 1s → Progress bar with ETA
+```
+
+### 3. Helpful Error Messages
+```
+BAD: "Error: ENOENT"
+GOOD: "File not found: config.yaml
+
+ To fix this, either:
+ • Create the file: touch config.yaml
+ • Specify a different path: --config /path/to/file"
+```
+
+### 4. Standard Flag Conventions
+```
+-h, --help Show help
+-v, --verbose Verbose output
+-q, --quiet Suppress output
+-V, --version Show version
+--json Machine-readable output
+--no-color Disable colors
+--dry-run Preview without executing
+--force Skip confirmations
+```
+
+### 5. TTY Awareness
+```go
+// Detect if running interactively
+if isatty.IsTerminal(os.Stdout.Fd()) {
+ // Human-friendly output with colors
+} else {
+ // Machine-friendly JSON/plain text
+}
+```
+
+### 6. Composability
+```bash
+# Your TUI should work in pipelines
+mytool list --json | jq '.[] | select(.status == "active")'
+mytool process < input.txt > output.txt
+```
+
+---
+
+## Architecture Patterns
+
+### Pattern 1: Model-View-Update (Elm Architecture)
+Used by: **Bubbletea**, **Ratatui**
+
+```
+┌──────────────────────────────────────────┐
+│ │
+│ ┌─────────┐ ┌─────────┐ ┌──────┐ │
+│ │ Model │───▶│ View │───▶│ UI │ │
+│ └─────────┘ └─────────┘ └──────┘ │
+│ ▲ │ │
+│ │ ┌─────────┐ │ │
+│ └─────────│ Update │◀───────┘ │
+│ └─────────┘ │
+│ (Messages) │
+└──────────────────────────────────────────┘
+```
+
+### Pattern 2: Component Model (React-style)
+Used by: **Ink**, **Textual**
+
+```
+┌──────────────────────────────────────────┐
+│ App │
+│ ├── Header │
+│ ├── MainContent │
+│ │ ├── Sidebar │
+│ │ └── ContentArea │
+│ │ ├── List │
+│ │ └── Detail │
+│ └── Footer │
+└──────────────────────────────────────────┘
+```
+
+---
+
+## Common UI Patterns
+
+### 1. Interactive List/Menu
+```
+┌─ Select an option ────────────────────┐
+│ │
+│ ● Create new project │
+│ ○ Open existing │
+│ ○ Import from GitHub │
+│ ○ Settings │
+│ ○ Exit │
+│ │
+│ ↑/↓: Navigate Enter: Select q: Quit
+└───────────────────────────────────────┘
+```
+
+### 2. Form Input
+```
+┌─ New Project ─────────────────────────┐
+│ │
+│ Name: █my-awesome-app │
+│ Template: [Next.js v14 ▼] │
+│ Include tests: [✓] │
+│ Git init: [✓] │
+│ │
+│ [Cancel] [Create Project] │
+└───────────────────────────────────────┘
+```
+
+### 3. Progress Display
+```
+┌─ Installing dependencies ─────────────┐
+│ │
+│ ████████████████░░░░░░░░ 67% │
+│ Installing: @types/react │
+│ │
+│ Elapsed: 12s Remaining: ~6s │
+└───────────────────────────────────────┘
+```
+
+### 4. Split Pane / Dashboard
+```
+┌─ System Monitor ──────────────────────────────────┐
+│ ┌─ Processes ──────────┐ ┌─ Resources ─────────┐ │
+│ │ PID NAME CPU │ │ CPU ████████░░ 80% │ │
+│ │ 1234 node 45% │ │ MEM ██████░░░░ 60% │ │
+│ │ 5678 chrome 23% │ │ DISK █████░░░░░ 50% │ │
+│ │ 9012 code 12% │ │ NET ██░░░░░░░░ 20% │ │
+│ └──────────────────────┘ └─────────────────────┘ │
+│ ┌─ Logs ───────────────────────────────────────┐ │
+│ │ [INFO] Server started on port 3000 │ │
+│ │ [WARN] Memory usage above 75% │ │
+│ └──────────────────────────────────────────────┘ │
+└───────────────────────────────────────────────────┘
+```
+
+### 5. Confirmation Dialog
+```
+┌─ Confirm ─────────────────────────────┐
+│ │
+│ ⚠️ Delete all files in /tmp? │
+│ │
+│ This action cannot be undone. │
+│ │
+│ [Cancel] [Delete] │
+└───────────────────────────────────────┘
+```
+
+---
+
+## Framework Quick References
+
+### Bubbletea (Go)
+See: `reference/bubbletea.md`
+
+```go
+package main
+
+import (
+ "fmt"
+ tea "github.com/charmbracelet/bubbletea"
+)
+
+type model struct {
+ choices []string
+ cursor int
+ selected map[int]struct{}
+}
+
+func (m model) Init() tea.Cmd { return nil }
+
+func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
+ switch msg := msg.(type) {
+ case tea.KeyMsg:
+ switch msg.String() {
+ case "q": return m, tea.Quit
+ case "up": if m.cursor > 0 { m.cursor-- }
+ case "down": if m.cursor < len(m.choices)-1 { m.cursor++ }
+ case "enter": m.selected[m.cursor] = struct{}{}
+ }
+ }
+ return m, nil
+}
+
+func (m model) View() string {
+ s := "Select items:\n\n"
+ for i, choice := range m.choices {
+ cursor := " "
+ if m.cursor == i { cursor = ">" }
+ checked := " "
+ if _, ok := m.selected[i]; ok { checked = "x" }
+ s += fmt.Sprintf("%s [%s] %s\n", cursor, checked, choice)
+ }
+ return s + "\nPress q to quit.\n"
+}
+
+func main() {
+ m := model{choices: []string{"Option 1", "Option 2", "Option 3"}, selected: make(map[int]struct{})}
+ tea.NewProgram(m).Run()
+}
+```
+
+### Ink (JavaScript/TypeScript)
+See: `reference/ink.md`
+
+```tsx
+import React, { useState } from 'react';
+import { render, Box, Text, useInput } from 'ink';
+
+const App = () => {
+ const [selected, setSelected] = useState(0);
+ const items = ['Create project', 'Open existing', 'Settings', 'Exit'];
+
+ useInput((input, key) => {
+ if (key.upArrow) setSelected(s => Math.max(0, s - 1));
+ if (key.downArrow) setSelected(s => Math.min(items.length - 1, s + 1));
+ if (input === 'q') process.exit(0);
+ });
+
+ return (
+ <Box flexDirection="column" padding={1}>
+ <Text bold>Select an option:</Text>
+ {items.map((item, i) => (
+ <Text key={i} color={i === selected ? 'green' : 'white'}>
+ {i === selected ? '> ' : ' '}{item}
+ </Text>
+ ))}
+ <Text dimColor>↑/↓: Navigate q: Quit</Text>
+ </Box>
+ );
+};
+
+render(<App />);
+```
+
+### Textual (Python)
+See: `reference/textual.md`
+
+```python
+from textual.app import App, ComposeResult
+from textual.widgets import Header, Footer, Static, Button
+from textual.containers import Container
+
+class MyApp(App):
+ CSS = """
+ Screen {
+ layout: vertical;
+ }
+ #main {
+ height: 1fr;
+ border: solid green;
+ }
+ """
+
+ BINDINGS = [("q", "quit", "Quit")]
+
+ def compose(self) -> ComposeResult:
+ yield Header()
+ yield Container(
+ Static("Welcome to My TUI App!", id="welcome"),
+ Button("Get Started", id="start"),
+ id="main"
+ )
+ yield Footer()
+
+ def on_button_pressed(self, event: Button.Pressed) -> None:
+ if event.button.id == "start":
+ self.notify("Let's go!")
+
+if __name__ == "__main__":
+ MyApp().run()
+```
+
+### Ratatui (Rust)
+See: `reference/ratatui.md`
+
+```rust
+use ratatui::{
+ backend::CrosstermBackend,
+ widgets::{Block, Borders, Paragraph},
+ Terminal,
+};
+use crossterm::{
+ event::{self, Event, KeyCode},
+ terminal::{disable_raw_mode, enable_raw_mode},
+};
+
+fn main() -> Result<(), Box<dyn std::error::Error>> {
+ enable_raw_mode()?;
+ let mut terminal = Terminal::new(CrosstermBackend::new(std::io::stdout()))?;
+
+ loop {
+ terminal.draw(|frame| {
+ let block = Block::default()
+ .title("My TUI")
+ .borders(Borders::ALL);
+ let paragraph = Paragraph::new("Press 'q' to quit")
+ .block(block);
+ frame.render_widget(paragraph, frame.area());
+ })?;
+
+ if let Event::Key(key) = event::read()? {
+ if key.code == KeyCode::Char('q') { break; }
+ }
+ }
+
+ disable_raw_mode()?;
+ Ok(())
+}
+```
+
+---
+
+## Project Scaffolding
+
+When starting a new TUI project, create this structure:
+
+### Go (Bubbletea)
+```
+my-tui/
+├── main.go # Entry point
+├── model.go # App state
+├── update.go # Message handlers
+├── view.go # UI rendering
+├── commands.go # Side effects (API calls, file IO)
+├── styles.go # Lipgloss styles
+└── go.mod
+```
+
+### JavaScript (Ink)
+```
+my-tui/
+├── src/
+│ ├── index.tsx # Entry point
+│ ├── App.tsx # Main component
+│ ├── components/ # UI components
+│ │ ├── Menu.tsx
+│ │ ├── Form.tsx
+│ │ └── Progress.tsx
+│ └── hooks/ # Custom hooks
+├── package.json
+└── tsconfig.json
+```
+
+### Python (Textual)
+```
+my-tui/
+├── src/
+│ ├── __main__.py # Entry point
+│ ├── app.py # Main app class
+│ ├── screens/ # Different screens
+│ │ ├── main.py
+│ │ └── settings.py
+│ ├── widgets/ # Custom widgets
+│ └── styles.tcss # Textual CSS
+├── pyproject.toml
+└── tests/
+```
+
+### Rust (Ratatui)
+```
+my-tui/
+├── src/
+│ ├── main.rs # Entry point
+│ ├── app.rs # App state
+│ ├── ui.rs # UI rendering
+│ ├── event.rs # Event handling
+│ └── widgets/ # Custom widgets
+├── Cargo.toml
+└── tests/
+```
+
+---
+
+## Testing TUI Applications
+
+### Snapshot Testing (Ink)
+```tsx
+import { render } from 'ink-testing-library';
+import App from './App';
+
+test('renders menu correctly', () => {
+ const { lastFrame } = render(<App />);
+ expect(lastFrame()).toMatchSnapshot();
+});
+```
+
+### Textual Testing
+```python
+async def test_app():
+ app = MyApp()
+ async with app.run_test() as pilot:
+ await pilot.click("#start-button")
+ assert app.query_one("#status").renderable == "Started"
+```
+
+### Bubbletea Testing
+```go
+func TestModel(t *testing.T) {
+ m := initialModel()
+ m, _ = m.Update(tea.KeyMsg{Type: tea.KeyDown})
+ if m.cursor != 1 {
+ t.Errorf("expected cursor 1, got %d", m.cursor)
+ }
+}
+```
+
+---
+
+## Ecosystem Tools
+
+### Charm Suite (Go)
+- **Lipgloss** - Styling and layout
+- **Bubbles** - Pre-built components (spinners, text inputs, tables)
+- **Glamour** - Markdown rendering
+- **Wish** - SSH server for TUIs
+- **VHS** - Record terminal GIFs
+
+### Ink Ecosystem (JS)
+- **ink-select-input** - Selection menus
+- **ink-text-input** - Text inputs
+- **ink-spinner** - Loading spinners
+- **ink-table** - Tables
+- **ink-gradient** - Gradient text
+
+### Textual Ecosystem (Python)
+- Built-in widgets: DataTable, Tree, Markdown, RichLog
+- CSS-like styling with `.tcss` files
+- DevTools for debugging
+
+---
+
+## Accessibility Considerations
+
+1. **Screen reader support** - Provide text alternatives
+2. **Color contrast** - Don't rely solely on color
+3. **Keyboard navigation** - Everything must be keyboard-accessible
+4. **Reduce motion** - Respect `REDUCE_MOTION` preference
+5. **Clear focus indicators** - Show which element is selected
+
+---
+
+## Performance Tips
+
+1. **Debounce rapid updates** - Don't redraw on every keystroke
+2. **Virtual scrolling** - For long lists, only render visible items
+3. **Lazy loading** - Load data as needed
+4. **Efficient diffing** - Only update changed parts of the screen
+5. **Background workers** - Don't block the UI thread
+
+---
+
+## Deployment
+
+### Single Binary (Recommended)
+```bash
+# Go
+go build -o mytui .
+
+# Rust
+cargo build --release
+
+# Node (with pkg)
+npx pkg . -o mytui
+
+# Python (with PyInstaller)
+pyinstaller --onefile src/__main__.py
+```
+
+### Distribution
+- GitHub Releases with binaries for each platform
+- Homebrew tap for macOS
+- AUR package for Arch Linux
+- npm publish for Node.js tools
+- PyPI for Python tools
+- crates.io for Rust tools
+
+---
+
+## Resources
+
+- [Command Line Interface Guidelines](https://clig.dev/) - The bible of CLI UX
+- [Charm](https://charm.sh/) - Go TUI ecosystem
+- [Textual Docs](https://textual.textualize.io/) - Python TUI framework
+- [Ink Docs](https://github.com/vadimdemedes/ink) - React for CLIs
+- [Ratatui](https://ratatui.rs/) - Rust TUI library
+- [Terminal Trove](https://terminaltrove.com/) - TUI inspiration gallery
diff --git a/skills/tui-builder/reference/bubbletea.md b/skills/tui-builder/reference/bubbletea.md
new file mode 100644
index 0000000..0738c12
--- /dev/null
+++ b/skills/tui-builder/reference/bubbletea.md
@@ -0,0 +1,488 @@
+# Bubbletea Reference (Go)
+
+> The Elm Architecture for terminal UIs
+
+## Installation
+
+```bash
+go get github.com/charmbracelet/bubbletea
+go get github.com/charmbracelet/lipgloss # Styling
+go get github.com/charmbracelet/bubbles # Pre-built components
+```
+
+## Core Concepts
+
+### The Elm Architecture (MVU)
+
+```
+Model → The application state
+Update → Handle messages, return new state
+View → Render state to string
+```
+
+### Basic Structure
+
+```go
+package main
+
+import (
+ "fmt"
+ "os"
+ tea "github.com/charmbracelet/bubbletea"
+)
+
+// MODEL - Application state
+type model struct {
+ cursor int
+ choices []string
+ selected map[int]struct{}
+ quitting bool
+}
+
+func initialModel() model {
+ return model{
+ choices: []string{"Buy milk", "Wash dishes", "Learn Bubbletea"},
+ selected: make(map[int]struct{}),
+ }
+}
+
+// INIT - Initial command (side effect)
+func (m model) Init() tea.Cmd {
+ return nil // No initial command
+}
+
+// UPDATE - Handle messages
+func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
+ switch msg := msg.(type) {
+ case tea.KeyMsg:
+ switch msg.String() {
+ case "ctrl+c", "q":
+ m.quitting = true
+ return m, tea.Quit
+ case "up", "k":
+ if m.cursor > 0 {
+ m.cursor--
+ }
+ case "down", "j":
+ if m.cursor < len(m.choices)-1 {
+ m.cursor++
+ }
+ case "enter", " ":
+ if _, ok := m.selected[m.cursor]; ok {
+ delete(m.selected, m.cursor)
+ } else {
+ m.selected[m.cursor] = struct{}{}
+ }
+ }
+ }
+ return m, nil
+}
+
+// VIEW - Render to string
+func (m model) View() string {
+ if m.quitting {
+ return "Goodbye!\n"
+ }
+
+ s := "What needs to be done?\n\n"
+
+ for i, choice := range m.choices {
+ cursor := " "
+ if m.cursor == i {
+ cursor = ">"
+ }
+
+ checked := " "
+ if _, ok := m.selected[i]; ok {
+ checked = "x"
+ }
+
+ s += fmt.Sprintf("%s [%s] %s\n", cursor, checked, choice)
+ }
+
+ s += "\nPress q to quit.\n"
+ return s
+}
+
+func main() {
+ p := tea.NewProgram(initialModel())
+ if _, err := p.Run(); err != nil {
+ fmt.Printf("Error: %v", err)
+ os.Exit(1)
+ }
+}
+```
+
+## Messages & Commands
+
+### Built-in Messages
+
+```go
+// Key press
+case tea.KeyMsg:
+ switch msg.String() {
+ case "ctrl+c": // Ctrl+C
+ case "enter": // Enter key
+ case "up": // Arrow up
+ case "a": // Letter a
+ }
+
+// Window resize
+case tea.WindowSizeMsg:
+ width := msg.Width
+ height := msg.Height
+
+// Mouse events (if enabled)
+case tea.MouseMsg:
+ x, y := msg.X, msg.Y
+ button := msg.Button
+```
+
+### Custom Messages
+
+```go
+// Define custom message types
+type statusMsg string
+type errMsg struct{ err error }
+
+// Command that returns a message
+func fetchStatus() tea.Msg {
+ // Simulate API call
+ time.Sleep(time.Second)
+ return statusMsg("Ready!")
+}
+
+// Use in Update
+func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
+ switch msg := msg.(type) {
+ case statusMsg:
+ m.status = string(msg)
+ case errMsg:
+ m.err = msg.err
+ }
+ return m, nil
+}
+
+// Trigger command from Init or Update
+func (m model) Init() tea.Cmd {
+ return fetchStatus // Note: no parentheses!
+}
+```
+
+### Commands
+
+```go
+// Return multiple commands
+return m, tea.Batch(cmd1, cmd2, cmd3)
+
+// Quit the program
+return m, tea.Quit
+
+// Do nothing
+return m, nil
+
+// Tick (for animations)
+func tickCmd() tea.Cmd {
+ return tea.Tick(time.Second, func(t time.Time) tea.Msg {
+ return tickMsg(t)
+ })
+}
+```
+
+## Styling with Lipgloss
+
+```go
+import "github.com/charmbracelet/lipgloss"
+
+var (
+ // Colors
+ subtle = lipgloss.AdaptiveColor{Light: "#D9DCCF", Dark: "#383838"}
+ highlight = lipgloss.AdaptiveColor{Light: "#874BFD", Dark: "#7D56F4"}
+ special = lipgloss.AdaptiveColor{Light: "#43BF6D", Dark: "#73F59F"}
+
+ // Styles
+ titleStyle = lipgloss.NewStyle().
+ Bold(true).
+ Foreground(lipgloss.Color("#FAFAFA")).
+ Background(lipgloss.Color("#7D56F4")).
+ Padding(0, 1)
+
+ itemStyle = lipgloss.NewStyle().
+ PaddingLeft(2)
+
+ selectedStyle = lipgloss.NewStyle().
+ PaddingLeft(2).
+ Foreground(lipgloss.Color("#7D56F4")).
+ Bold(true)
+
+ boxStyle = lipgloss.NewStyle().
+ Border(lipgloss.RoundedBorder()).
+ BorderForeground(lipgloss.Color("#874BFD")).
+ Padding(1, 2)
+)
+
+func (m model) View() string {
+ title := titleStyle.Render("My App")
+
+ var items string
+ for i, item := range m.items {
+ if i == m.cursor {
+ items += selectedStyle.Render("> " + item) + "\n"
+ } else {
+ items += itemStyle.Render(" " + item) + "\n"
+ }
+ }
+
+ return boxStyle.Render(title + "\n\n" + items)
+}
+```
+
+## Bubbles Components
+
+### Spinner
+
+```go
+import "github.com/charmbracelet/bubbles/spinner"
+
+type model struct {
+ spinner spinner.Model
+ loading bool
+}
+
+func initialModel() model {
+ s := spinner.New()
+ s.Spinner = spinner.Dot
+ s.Style = lipgloss.NewStyle().Foreground(lipgloss.Color("205"))
+ return model{spinner: s, loading: true}
+}
+
+func (m model) Init() tea.Cmd {
+ return m.spinner.Tick
+}
+
+func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
+ switch msg := msg.(type) {
+ case spinner.TickMsg:
+ var cmd tea.Cmd
+ m.spinner, cmd = m.spinner.Update(msg)
+ return m, cmd
+ }
+ return m, nil
+}
+
+func (m model) View() string {
+ if m.loading {
+ return m.spinner.View() + " Loading..."
+ }
+ return "Done!"
+}
+```
+
+### Text Input
+
+```go
+import "github.com/charmbracelet/bubbles/textinput"
+
+type model struct {
+ input textinput.Model
+}
+
+func initialModel() model {
+ ti := textinput.New()
+ ti.Placeholder = "Enter your name"
+ ti.Focus()
+ ti.CharLimit = 50
+ ti.Width = 30
+ return model{input: ti}
+}
+
+func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
+ var cmd tea.Cmd
+ m.input, cmd = m.input.Update(msg)
+
+ switch msg := msg.(type) {
+ case tea.KeyMsg:
+ if msg.Type == tea.KeyEnter {
+ // Handle submission
+ value := m.input.Value()
+ }
+ }
+ return m, cmd
+}
+
+func (m model) View() string {
+ return fmt.Sprintf("Name:\n%s\n\nPress Enter to submit", m.input.View())
+}
+```
+
+### List
+
+```go
+import "github.com/charmbracelet/bubbles/list"
+
+type item struct {
+ title, desc string
+}
+
+func (i item) Title() string { return i.title }
+func (i item) Description() string { return i.desc }
+func (i item) FilterValue() string { return i.title }
+
+type model struct {
+ list list.Model
+}
+
+func initialModel() model {
+ items := []list.Item{
+ item{title: "Raspberry Pi", desc: "A tiny computer"},
+ item{title: "Arduino", desc: "A microcontroller"},
+ }
+
+ l := list.New(items, list.NewDefaultDelegate(), 0, 0)
+ l.Title = "My Hardware"
+
+ return model{list: l}
+}
+```
+
+### Progress Bar
+
+```go
+import "github.com/charmbracelet/bubbles/progress"
+
+type model struct {
+ progress progress.Model
+ percent float64
+}
+
+func initialModel() model {
+ return model{
+ progress: progress.New(progress.WithDefaultGradient()),
+ }
+}
+
+func (m model) View() string {
+ return m.progress.ViewAs(m.percent)
+}
+```
+
+### Table
+
+```go
+import "github.com/charmbracelet/bubbles/table"
+
+columns := []table.Column{
+ {Title: "ID", Width: 4},
+ {Title: "Name", Width: 20},
+ {Title: "Status", Width: 10},
+}
+
+rows := []table.Row{
+ {"1", "Project Alpha", "Active"},
+ {"2", "Project Beta", "Pending"},
+}
+
+t := table.New(
+ table.WithColumns(columns),
+ table.WithRows(rows),
+ table.WithFocused(true),
+ table.WithHeight(7),
+)
+```
+
+## Advanced Patterns
+
+### Sub-models (Component Composition)
+
+```go
+type model struct {
+ tabs []string
+ activeTab int
+
+ // Sub-models for each tab
+ homeModel homeModel
+ settingsModel settingsModel
+}
+
+func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
+ var cmd tea.Cmd
+
+ // Route to active tab's model
+ switch m.activeTab {
+ case 0:
+ m.homeModel, cmd = m.homeModel.Update(msg)
+ case 1:
+ m.settingsModel, cmd = m.settingsModel.Update(msg)
+ }
+
+ return m, cmd
+}
+```
+
+### Full-screen vs Inline
+
+```go
+// Full-screen (default)
+p := tea.NewProgram(model{})
+
+// Inline (within existing terminal output)
+p := tea.NewProgram(model{}, tea.WithAltScreen())
+
+// With mouse support
+p := tea.NewProgram(model{}, tea.WithMouseCellMotion())
+```
+
+### Async Operations
+
+```go
+// HTTP request command
+func fetchData(url string) tea.Cmd {
+ return func() tea.Msg {
+ resp, err := http.Get(url)
+ if err != nil {
+ return errMsg{err}
+ }
+ defer resp.Body.Close()
+
+ body, _ := io.ReadAll(resp.Body)
+ return dataMsg(body)
+ }
+}
+
+// Use in Update
+case tea.KeyMsg:
+ if msg.String() == "f" {
+ return m, fetchData("https://api.example.com/data")
+ }
+```
+
+## Testing
+
+```go
+func TestUpdate(t *testing.T) {
+ m := initialModel()
+
+ // Simulate key press
+ m, _ = m.Update(tea.KeyMsg{Type: tea.KeyDown})
+
+ if m.cursor != 1 {
+ t.Errorf("expected cursor 1, got %d", m.cursor)
+ }
+}
+
+func TestView(t *testing.T) {
+ m := initialModel()
+ view := m.View()
+
+ if !strings.Contains(view, "What needs to be done?") {
+ t.Error("expected title in view")
+ }
+}
+```
+
+## Resources
+
+- [Bubbletea GitHub](https://github.com/charmbracelet/bubbletea)
+- [Bubbles Components](https://github.com/charmbracelet/bubbles)
+- [Lipgloss Styling](https://github.com/charmbracelet/lipgloss)
+- [Charm Examples](https://github.com/charmbracelet/bubbletea/tree/master/examples)
diff --git a/skills/tui-builder/reference/cli-ux-guidelines.md b/skills/tui-builder/reference/cli-ux-guidelines.md
new file mode 100644
index 0000000..92dd986
--- /dev/null
+++ b/skills/tui-builder/reference/cli-ux-guidelines.md
@@ -0,0 +1,523 @@
+# CLI UX Guidelines
+
+> Best practices from clig.dev and industry standards
+
+## Philosophy
+
+### Human-First Design
+Modern CLIs are used directly by humans, not just scripts. Design for human interaction first.
+
+```
+OLD THINKING: CLIs are for power users who read man pages
+NEW THINKING: CLIs should be discoverable, forgiving, and helpful
+```
+
+### The Conversation Model
+CLI interaction is a dialogue:
+1. User issues command
+2. Tool provides feedback
+3. User adjusts and retries
+4. Success (or helpful failure)
+
+Design for this iterative process.
+
+---
+
+## Output Principles
+
+### 1. Show Progress Always
+
+| Duration | Indicator |
+|----------|-----------|
+| < 100ms | Nothing needed |
+| 100ms - 1s | Spinner |
+| 1s - 10s | Progress bar |
+| > 10s | Progress bar + ETA |
+
+```bash
+# Bad: Silent hang
+$ mytool deploy
+[...user wonders if it's working...]
+
+# Good: Immediate feedback
+$ mytool deploy
+⠋ Connecting to server...
+████████████████░░░░░░░░ 67% | ETA: 12s
+✓ Deployed successfully!
+```
+
+### 2. Respect the Terminal
+
+```bash
+# Detect if running in a terminal
+if [ -t 1 ]; then
+ # Human-friendly output with colors
+else
+ # Machine-friendly plain text
+fi
+```
+
+- Use colors sparingly and meaningfully
+- Respect `NO_COLOR` environment variable
+- Provide `--no-color` flag
+- Use ANSI codes only when stdout is a TTY
+
+### 3. Appropriate Information Density
+
+```bash
+# Bad: Too verbose
+$ mytool status
+Checking connection to server at https://api.example.com...
+Connection established successfully.
+Fetching project metadata from database...
+Project metadata retrieved.
+Current status: active
+Last deployment: 2024-01-15T10:30:00Z
+...50 more lines...
+
+# Good: Scannable, with detail available
+$ mytool status
+✓ Connected | Project: my-app | Status: active
+ Last deploy: 2 hours ago
+
+$ mytool status --verbose # For when you need more
+```
+
+### 4. Structure Output for Humans AND Machines
+
+```bash
+# Default: Human-readable
+$ mytool list
+NAME STATUS CREATED
+my-app active 2 hours ago
+other-app stopped 5 days ago
+
+# Flag: Machine-readable
+$ mytool list --json
+[{"name": "my-app", "status": "active", "created": "2024-01-15T10:30:00Z"}]
+
+# Pipe-friendly: Plain text
+$ mytool list | grep active
+my-app active 2 hours ago
+```
+
+---
+
+## Error Handling
+
+### The Golden Rule
+Every error message should answer:
+1. What went wrong?
+2. Why did it happen?
+3. How do I fix it?
+
+### Good vs Bad Errors
+
+```bash
+# Bad
+$ mytool deploy
+Error: ECONNREFUSED
+
+# Better
+$ mytool deploy
+Error: Could not connect to server
+
+# Best
+$ mytool deploy
+✗ Could not connect to api.example.com:443
+
+ The server refused the connection. This usually means:
+ • The server is down
+ • Your network is blocking the connection
+ • The URL is incorrect
+
+ Try:
+ 1. Check if the server is running: curl https://api.example.com/health
+ 2. Verify your network connection
+ 3. Check your config: mytool config show
+
+ Docs: https://docs.example.com/troubleshooting#connection-refused
+```
+
+### Error Output Location
+
+```bash
+# Errors go to stderr (so they don't break pipes)
+echo "Error: something failed" >&2
+
+# Exit codes matter
+exit 0 # Success
+exit 1 # General error
+exit 2 # Misuse (bad arguments)
+```
+
+---
+
+## Arguments & Flags
+
+### Flag Conventions
+
+| Flag | Meaning |
+|------|---------|
+| `-h`, `--help` | Show help |
+| `-V`, `--version` | Show version |
+| `-v`, `--verbose` | More output |
+| `-q`, `--quiet` | Less output |
+| `-f`, `--force` | Skip confirmations |
+| `-n`, `--dry-run` | Preview without executing |
+| `-o`, `--output FILE` | Output file |
+| `-c`, `--config FILE` | Config file |
+| `--json` | JSON output |
+| `--no-color` | Disable colors |
+
+### Naming Conventions
+
+```bash
+# Use full words for clarity
+--output not --out
+--recursive not --rec
+--verbose not --verb
+
+# Use kebab-case
+--dry-run not --dryRun
+--no-color not --nocolor
+
+# Negative flags
+--no-cache not --skip-cache
+--no-verify not --unsafe
+```
+
+### Positional vs Flags
+
+```bash
+# Positional: For the primary target
+mytool deploy my-app
+
+# Flags: For options/modifiers
+mytool deploy my-app --env production --force
+
+# Rule: If you'd need to remember order, use flags
+# Bad: mytool copy source dest staging true
+# Good: mytool copy source dest --env staging --force
+```
+
+---
+
+## Help & Documentation
+
+### Help Output Structure
+
+```
+mytool - One-line description
+
+USAGE
+ mytool <command> [options]
+
+COMMANDS
+ init Create a new project
+ deploy Deploy to production
+ status Check current status
+
+OPTIONS
+ -h, --help Show this help
+ -V, --version Show version
+ -v, --verbose Increase verbosity
+
+EXAMPLES
+ mytool init my-project
+ mytool deploy --env staging
+ mytool status --json
+
+DOCS
+ https://docs.example.com
+```
+
+### Key Principles
+
+1. **Lead with examples** - Most users scan for patterns
+2. **Keep it scannable** - Use columns, grouping, whitespace
+3. **Link to full docs** - Help is a summary, not a manual
+4. **Show common workflows** - Not just individual commands
+
+### Smart Defaults
+
+```bash
+# No args? Show help, not an error
+$ mytool
+Usage: mytool <command> [options]
+
+Run 'mytool --help' for more information.
+
+# Suggest corrections
+$ mytool dploy
+Unknown command: dploy
+
+Did you mean: deploy?
+```
+
+---
+
+## Interactivity
+
+### When to Prompt
+
+```bash
+# DO prompt for:
+- Dangerous/destructive actions
+- Missing required information
+- Ambiguous situations
+
+# DON'T prompt for:
+- Non-interactive environments (CI/CD)
+- When all info is available
+- Confirmations that can use --force
+```
+
+### Prompt Best Practices
+
+```bash
+# Provide defaults
+Enter project name [my-project]:
+
+# Show current value when editing
+Enter API key [***hidden***]:
+
+# Validate inline
+Email: not-an-email
+ ↳ Invalid email format. Try: [email protected]
+
+# Support escape
+Press Ctrl+C to cancel
+```
+
+### Respect --no-input
+
+```bash
+# In scripts, prompts should fail gracefully
+if [ "$NO_INPUT" = "1" ]; then
+ echo "Error: Cannot prompt in non-interactive mode"
+ echo "Provide --name flag or set NAME env var"
+ exit 1
+fi
+```
+
+---
+
+## Configuration
+
+### Precedence (highest to lowest)
+
+1. Command-line flags
+2. Environment variables
+3. Project config (`./.myapp.yaml`)
+4. User config (`~/.config/myapp/config.yaml`)
+5. System config (`/etc/myapp/config.yaml`)
+6. Built-in defaults
+
+### Environment Variables
+
+```bash
+# Naming convention
+MYAPP_API_KEY
+MYAPP_CONFIG_PATH
+MYAPP_VERBOSE
+
+# Boolean flags
+MYAPP_DEBUG=1 # truthy
+MYAPP_DEBUG= # falsy
+```
+
+### Config Files
+
+```yaml
+# Use XDG Base Directory
+# Linux: ~/.config/myapp/
+# macOS: ~/Library/Application Support/myapp/
+
+# Support multiple formats
+config.yaml
+config.json
+config.toml
+```
+
+---
+
+## Composability
+
+### Work with Pipes
+
+```bash
+# Read from stdin
+echo "input" | mytool process
+
+# Write to stdout
+mytool generate > output.txt
+
+# Chain commands
+mytool list --json | jq '.[] | .name' | xargs mytool delete
+```
+
+### Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | Success |
+| 1 | General error |
+| 2 | Misuse (bad args) |
+| 126 | Permission denied |
+| 127 | Command not found |
+| 130 | Ctrl+C (SIGINT) |
+
+### Signals
+
+```bash
+# Handle Ctrl+C gracefully
+trap cleanup SIGINT SIGTERM
+
+cleanup() {
+ echo "Interrupted. Cleaning up..."
+ # Cleanup code
+ exit 130
+}
+```
+
+---
+
+## Performance & Responsiveness
+
+### Startup Time
+
+```
+< 100ms: Excellent
+100-250ms: Acceptable
+250-500ms: Noticeable lag
+> 500ms: Too slow
+```
+
+Tips:
+- Lazy-load dependencies
+- Cache expensive operations
+- Show spinner immediately
+
+### Feedback Timing
+
+```
+0-100ms: No feedback needed
+100ms-1s: Show spinner
+1s-10s: Show progress
+>10s: Show ETA
+```
+
+---
+
+## Subcommands
+
+### Verb-Noun Pattern
+
+```bash
+# Good: verb-noun
+git commit
+docker run
+kubectl get pods
+
+# Avoid: noun-verb
+git-commit # harder to discover
+```
+
+### Hierarchy
+
+```bash
+# Two levels max
+mytool project create
+mytool project list
+mytool project delete
+
+# Not
+mytool project settings advanced security enable # too deep
+```
+
+### Aliases
+
+```bash
+# Common abbreviations
+mytool ls # list
+mytool rm # remove
+mytool i # install
+
+# Document in help
+ALIASES
+ ls → list
+ rm → remove
+```
+
+---
+
+## Versioning & Updates
+
+### Version Output
+
+```bash
+$ mytool --version
+mytool 1.2.3
+
+# Or with more detail
+$ mytool --version --verbose
+mytool 1.2.3
+ Built: 2024-01-15
+ Commit: abc123
+ Go: 1.21
+```
+
+### Update Notifications
+
+```bash
+# Non-intrusive notice
+$ mytool deploy
+✓ Deployed successfully
+
+A new version is available: 1.3.0 (you have 1.2.3)
+Run 'mytool update' to upgrade.
+```
+
+---
+
+## Security
+
+### Sensitive Data
+
+```bash
+# Never accept passwords as flags (visible in ps, history)
+# Bad
+mytool login --password secret123
+
+# Good
+mytool login
+Password: ████████
+
+# Or
+MYAPP_PASSWORD=secret mytool login
+mytool login < password.txt
+```
+
+### Confirmations
+
+```bash
+# Destructive actions require confirmation
+$ mytool delete --all
+This will delete 47 items. Type 'delete all' to confirm:
+> delete all
+Deleting...
+
+# Or use --force to skip
+$ mytool delete --all --force
+Deleting 47 items...
+```
+
+---
+
+## Resources
+
+- [Command Line Interface Guidelines](https://clig.dev/)
+- [12 Factor CLI Apps](https://medium.com/@jdxcode/12-factor-cli-apps-dd3c227a0e46)
+- [Heroku CLI Style Guide](https://devcenter.heroku.com/articles/cli-style-guide)
+- [GNU Standards for CLIs](https://www.gnu.org/prep/standards/html_node/Command_002dLine-Interfaces.html)
diff --git a/skills/tui-builder/reference/design-system.md b/skills/tui-builder/reference/design-system.md
new file mode 100644
index 0000000..819afb0
--- /dev/null
+++ b/skills/tui-builder/reference/design-system.md
@@ -0,0 +1,606 @@
+# TUI Design System
+
+> Senior-level terminal UI design principles, patterns, and aesthetics
+
+## Design Philosophy
+
+### The Terminal is a Canvas
+The terminal isn't a limitation—it's a medium with its own aesthetic language. Great TUI design embraces constraints: monospace fonts, limited colors, character-based drawing. These aren't bugs, they're features that create a distinct visual identity impossible in GUIs.
+
+### Core Principles
+
+1. **Information Hierarchy** - Guide the eye through visual weight
+2. **Breathing Room** - Whitespace is your friend, even in terminals
+3. **Consistent Rhythm** - Establish patterns, then maintain them
+4. **Purposeful Color** - Every color should communicate meaning
+5. **Typography as Structure** - Monospace is your only font; use it wisely
+
+---
+
+## Visual Building Blocks
+
+### Box-Drawing Characters
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ SINGLE LINE │
+│ ┌──────┐ Corners: ┌ ┐ └ ┘ │
+│ │ │ Lines: ─ │ │
+│ │ │ T-junctions: ┬ ┴ ├ ┤ │
+│ └──────┘ Cross: ┼ │
+├─────────────────────────────────────────────────────────────┤
+│ DOUBLE LINE │
+│ ╔══════╗ Corners: ╔ ╗ ╚ ╝ │
+│ ║ ║ Lines: ═ ║ │
+│ ║ ║ T-junctions: ╦ ╩ ╠ ╣ │
+│ ╚══════╝ Cross: ╬ │
+├─────────────────────────────────────────────────────────────┤
+│ ROUNDED │
+│ ╭──────╮ Corners: ╭ ╮ ╰ ╯ │
+│ │ │ (Combine with single line characters) │
+│ │ │ │
+│ ╰──────╯ │
+├─────────────────────────────────────────────────────────────┤
+│ HEAVY/BOLD │
+│ ┏━━━━━━┓ Corners: ┏ ┓ ┗ ┛ │
+│ ┃ ┃ Lines: ━ ┃ │
+│ ┃ ┃ T-junctions: ┳ ┻ ┣ ┫ │
+│ ┗━━━━━━┛ Cross: ╋ │
+├─────────────────────────────────────────────────────────────┤
+│ ASCII (Maximum Compatibility) │
+│ +------+ Corners: + │
+│ | | Lines: - | │
+│ | | Cross: + │
+│ +------+ │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Block Characters (For Graphs & Progress)
+
+```
+FULL BLOCKS ████████████████████████████████
+LIGHT SHADE ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+MEDIUM SHADE ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
+DARK SHADE ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
+
+PARTIAL BLOCKS ▏▎▍▌▋▊▉█ (1/8 to full)
+
+QUADRANTS ▖ ▗ ▘ ▙ ▚ ▛ ▜ ▝ ▞ ▟
+
+BRAILLE ⠁⠂⠃⠄⠅⠆⠇⡀⡁⡂⡃⡄⡅⡆⡇ (For high-res graphs)
+```
+
+### Symbols & Icons
+
+```
+STATUS ✓ ✗ ● ○ ◉ ◎ ■ □ ▪ ▫ ★ ☆ ♦ ♢
+ARROWS ← → ↑ ↓ ↔ ↕ ⇐ ⇒ ⇑ ⇓ ➜ ➤ ▶ ◀ ▲ ▼
+MATH × ÷ ± ≤ ≥ ≠ ≈ ∞ √ ∑ ∏ ∫
+MISC … · • ¦ § ¶ © ® ™ ° ′ ″
+SPINNERS ⠋ ⠙ ⠹ ⠸ ⠼ ⠴ ⠦ ⠧ ⠇ ⠏ (Braille)
+ ◐ ◓ ◑ ◒ (Quarter circles)
+ ◴ ◷ ◶ ◵ (Quarter squares)
+ ▁ ▂ ▃ ▄ ▅ ▆ ▇ █ (Growing bar)
+```
+
+---
+
+## Color Theory for Terminals
+
+### The 16-Color Base Palette
+
+Most terminals support at least 16 colors. Design for this first, enhance for 256/truecolor.
+
+```
+Standard 8:
+ 0 Black 1 Red 2 Green 3 Yellow
+ 4 Blue 5 Magenta 6 Cyan 7 White
+
+Bright 8:
+ 8 Bright Black (Gray) 9 Bright Red
+ 10 Bright Green 11 Bright Yellow
+ 12 Bright Blue 13 Bright Magenta
+ 14 Bright Cyan 15 Bright White
+```
+
+### Color Semantics (Consistent Meaning)
+
+| Color | Primary Use | Secondary Use |
+|-------|-------------|---------------|
+| **Red** | Errors, danger, deletion | Urgent alerts |
+| **Green** | Success, addition, positive | Active/online status |
+| **Yellow** | Warnings, caution | In-progress, pending |
+| **Blue** | Information, links | Primary actions |
+| **Magenta** | Special, unique | Syntax highlighting |
+| **Cyan** | Secondary info | Commands, paths |
+| **White** | Primary text | - |
+| **Gray** | Disabled, hints, dimmed | Comments, metadata |
+
+### Contrast Rules
+
+```
+GOOD CONTRAST (AAA):
+ White on Black ████████ High contrast, easy to read
+ Black on White ████████ Inverted, good for headers
+ Yellow on Black ████████ Attention-grabbing
+ Cyan on Black ████████ Good for secondary text
+
+POOR CONTRAST (Avoid):
+ Red on Blue ████████ Vibrates, hard to read
+ Green on Red ████████ Colorblind-unfriendly
+ Yellow on White ████████ Nearly invisible
+ Blue on Black ████████ Too dark
+```
+
+### Dark vs Light Mode
+
+```
+DARK MODE (Default):
+ Background: Black/Dark Gray (#0d1117)
+ Primary Text: White/Light Gray (#c9d1d9)
+ Secondary Text: Gray (#8b949e)
+ Accent: Bright colors pop
+
+LIGHT MODE:
+ Background: White/Light (#ffffff)
+ Primary Text: Dark Gray (#24292f)
+ Secondary Text: Gray (#57606a)
+ Accent: Muted colors work better
+```
+
+---
+
+## Typography in Monospace
+
+### Hierarchy Through Style
+
+Since you can't change font size, use these techniques:
+
+```
+═══════════════════════════════════════════════════════════════
+ TITLE (CENTERED, CAPS)
+═══════════════════════════════════════════════════════════════
+
+## SECTION HEADER (CAPS, UNDERLINED)
+───────────────────────────────────────────────────────────────
+
+### Subsection (Title Case)
+
+Body text uses normal case. Keep lines readable—aim for 60-80
+characters per line maximum.
+
+**Bold Text** for emphasis (using ANSI bold)
+*Italic Text* for subtle emphasis (using ANSI italic)
+`Code` for commands, paths, values (using different color)
+
+> Blockquotes for callouts (indent + different color)
+
+• Bullet points for lists
+ ◦ Sub-bullets indented
+ ‣ Third level
+
+1. Numbered lists for sequences
+ a. Sub-items
+ b. Continue pattern
+```
+
+### Alignment Patterns
+
+```
+LEFT ALIGNED (Default)
+Name: Value
+Status: Active
+Created: 2024-01-15
+
+RIGHT ALIGNED (Numbers, Dates)
+ Name: Project Alpha
+ Status: Active
+ Created: 2024-01-15
+
+CENTERED (Titles, Headers)
+ ╔══════════════════════╗
+ ║ SYSTEM STATUS ║
+ ╚══════════════════════╝
+
+JUSTIFIED (Tables)
+┌────────────┬────────┬────────────┐
+│ Name │ Status │ Created │
+├────────────┼────────┼────────────┤
+│ Alpha │ Active │ 2024-01-15 │
+│ Beta │ Idle │ 2024-01-10 │
+└────────────┴────────┴────────────┘
+```
+
+---
+
+## Layout Patterns
+
+### The Grid System
+
+Think in character cells. Common terminal widths:
+
+| Width | Use Case |
+|-------|----------|
+| 80 | Classic terminal, maximum compatibility |
+| 120 | Modern wide terminal |
+| Full-width | Responsive, fills available space |
+
+### Spacing Standards
+
+```
+PADDING (Inside borders):
+ Minimal: 1 character
+ Normal: 2 characters
+ Generous: 3-4 characters
+
+MARGIN (Between elements):
+ Tight: 1 line
+ Normal: 2 lines
+ Spacious: 3+ lines
+
+EXAMPLE:
+┌──────────────────────────────────────┐
+│ │ ← 1 char top padding
+│ Content here with 2-char padding │
+│ │ ← 1 char bottom padding
+└──────────────────────────────────────┘
+
+ ← 2 lines between elements
+
+┌──────────────────────────────────────┐
+│ Next element │
+└──────────────────────────────────────┘
+```
+
+### Common Layout Templates
+
+```
+SINGLE COLUMN (Simple)
+┌────────────────────────────────────────────────────────────────────┐
+│ Header │
+├────────────────────────────────────────────────────────────────────┤
+│ │
+│ Main Content Area │
+│ │
+├────────────────────────────────────────────────────────────────────┤
+│ Footer │
+└────────────────────────────────────────────────────────────────────┘
+
+SIDEBAR + MAIN (Dashboard)
+┌────────────────┬───────────────────────────────────────────────────┐
+│ Sidebar │ Main Content │
+│ │ │
+│ • Item 1 │ │
+│ • Item 2 │ │
+│ • Item 3 │ │
+│ │ │
+└────────────────┴───────────────────────────────────────────────────┘
+
+SPLIT PANES (Comparison)
+┌─────────────────────────────────┬─────────────────────────────────┐
+│ Left Pane │ Right Pane │
+│ │ │
+│ │ │
+└─────────────────────────────────┴─────────────────────────────────┘
+
+QUADRANT (Monitoring)
+┌─────────────────────────────────┬─────────────────────────────────┐
+│ Panel 1 │ Panel 2 │
+│ │ │
+├─────────────────────────────────┼─────────────────────────────────┤
+│ Panel 3 │ Panel 4 │
+│ │ │
+└─────────────────────────────────┴─────────────────────────────────┘
+
+MODAL/DIALOG (Overlay)
+┌────────────────────────────────────────────────────────────────────┐
+│ Background content (dimmed) │
+│ ┌─────────────────────────┐ │
+│ │ Modal Title │ │
+│ ├─────────────────────────┤ │
+│ │ Modal content here │ │
+│ │ │ │
+│ │ [Cancel] [Confirm] │ │
+│ └─────────────────────────┘ │
+│ │
+└────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Animation & Motion
+
+### Principles
+
+1. **Purposeful** - Animation should communicate, not decorate
+2. **Fast** - Terminal users expect speed; keep animations under 300ms
+3. **Interruptible** - User input should always take priority
+
+### Common Animations
+
+```
+SPINNER (Continuous)
+ Dots: ⠋ ⠙ ⠹ ⠸ ⠼ ⠴ ⠦ ⠧ ⠇ ⠏
+ Line: - \ | /
+ Bounce: ⠁ ⠂ ⠄ ⠂
+ Pulse: ◐ ◓ ◑ ◒
+
+PROGRESS (Linear)
+ Bar: ░░░░░░░░░░ → █████░░░░░ → ██████████
+ Dots: ... → ...... → ..........
+ Blocks: ▏▎▍▌▋▊▉█
+
+TRANSITION (State Change)
+ Fade in: (dim) → (normal) → (bright)
+ Slide: Move content left/right/up/down
+ Expand: Small box → Large box
+
+FEEDBACK (User Action)
+ Flash: Briefly invert colors on selection
+ Highlight: Brighten then fade
+ Shake: Horizontal jitter on error
+```
+
+### Implementation Tips
+
+```go
+// Smooth spinner (Bubbletea)
+spinner.Spinner = spinner.Spinner{
+ Frames: []string{"⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"},
+ FPS: time.Second / 10,
+}
+
+// Progress animation
+for i := 0; i <= 100; i++ {
+ filled := i * width / 100
+ bar := strings.Repeat("█", filled) + strings.Repeat("░", width-filled)
+ fmt.Printf("\r%s %d%%", bar, i)
+ time.Sleep(20 * time.Millisecond)
+}
+```
+
+---
+
+## Accessibility
+
+### Color Blindness Considerations
+
+```
+PROBLEMATIC COMBINATIONS:
+ Red + Green (8% of males affected)
+ Blue + Purple
+ Green + Brown
+
+SOLUTIONS:
+ 1. Don't rely solely on color—add symbols
+ ✓ Success (green) ✗ Error (red) ⚠ Warning (yellow)
+
+ 2. Use patterns/textures for graphs
+ █████ vs ▓▓▓▓▓ vs ░░░░░
+
+ 3. Ensure sufficient contrast
+ High contrast mode: White on black only
+```
+
+### Screen Reader Support
+
+```
+1. Provide text alternatives for visual elements
+ Progress: "50% complete" not just "██████░░░░░░"
+
+2. Announce state changes
+ "Loading started" → "Loading complete"
+
+3. Use semantic structure
+ Headers, lists, regions
+
+4. Support reduced motion
+ if (prefersReducedMotion) {
+ disableAnimations()
+ }
+```
+
+---
+
+## Responsive Design
+
+### Width Breakpoints
+
+```go
+switch {
+case width < 40:
+ // Compact mode: Stack everything vertically
+ // Hide non-essential elements
+ // Use abbreviations
+
+case width < 80:
+ // Standard mode: Single column
+ // Full labels
+ // Basic formatting
+
+case width < 120:
+ // Wide mode: Two columns possible
+ // Sidebar + main content
+ // More whitespace
+
+default:
+ // Ultra-wide: Three columns
+ // Full dashboard layouts
+ // Maximum information density
+}
+```
+
+### Graceful Degradation
+
+```
+FULL WIDTH (120+):
+┌─ Status ──────────────────┬─ Details ─────────────────────────────┐
+│ ● Server: Online │ Last checked: 2024-01-15 10:30:00 │
+│ ● Database: Connected │ Response time: 45ms │
+│ ● Cache: Active │ Memory usage: 67% │
+└───────────────────────────┴───────────────────────────────────────┘
+
+MEDIUM WIDTH (80):
+┌─ Status ──────────────────────────────────────────┐
+│ ● Server: Online │ Last check: 10:30 │
+│ ● Database: OK │ Response: 45ms │
+│ ● Cache: Active │ Memory: 67% │
+└───────────────────────────────────────────────────┘
+
+NARROW WIDTH (40):
+┌─ Status ───────────────┐
+│ ● Server Online │
+│ ● Database OK │
+│ ● Cache Active │
+│ Mem: 67% Resp: 45ms │
+└────────────────────────┘
+
+MINIMAL WIDTH (<40):
+Status: All OK
+Mem: 67% | 45ms
+```
+
+---
+
+## Component Library
+
+### Buttons
+
+```
+STANDARD:
+ [ Submit ] [ Cancel ]
+
+WITH ICONS:
+ [ ✓ Save ] [ ✗ Cancel ] [ ↻ Refresh ]
+
+STATES:
+ [ Normal ] Default state
+ [ FOCUSED ] Bold/highlighted when selected
+ [ Disabled] Dimmed, no interaction
+
+VARIANTS:
+ ┌──────────┐
+ │ Primary │ Filled background
+ └──────────┘
+
+ [ Secondary ] Outlined
+
+ ⟨ Minimal ⟩ No border
+```
+
+### Inputs
+
+```
+TEXT INPUT:
+ Label: █ Empty
+ Label: John Doe█ With value
+ Label: ████████ (hidden) Password
+
+ ┌─ Name ────────────────────────────┐
+ │ John Doe█ │ Boxed variant
+ └───────────────────────────────────┘
+
+SELECT/DROPDOWN:
+ Option: [ Option 1 ▼]
+
+ ┌─ Select Option ───────────────────┐
+ │ > Option 1 │
+ │ Option 2 │
+ │ Option 3 │
+ └───────────────────────────────────┘
+
+CHECKBOX/RADIO:
+ [✓] Option A Checkbox
+ [ ] Option B
+
+ (●) Choice A Radio
+ ( ) Choice B
+ ( ) Choice C
+```
+
+### Lists
+
+```
+SIMPLE LIST:
+ • Item one
+ • Item two
+ • Item three
+
+SELECTABLE LIST:
+ > Item one ← Selected (highlighted)
+ Item two
+ Item three
+
+HIERARCHICAL:
+ ▼ Parent
+ ├── Child 1
+ ├── Child 2
+ └── Child 3
+
+NUMBERED:
+ 1. First step
+ 2. Second step
+ 3. Third step
+```
+
+### Tables
+
+```
+SIMPLE:
+ Name Status Created
+ ─────────────────────────────────
+ Project A Active Jan 15
+ Project B Pending Jan 10
+
+BORDERED:
+ ┌─────────────┬──────────┬───────────┐
+ │ Name │ Status │ Created │
+ ├─────────────┼──────────┼───────────┤
+ │ Project A │ Active │ Jan 15 │
+ │ Project B │ Pending │ Jan 10 │
+ └─────────────┴──────────┴───────────┘
+
+WITH SELECTION:
+ ┌─────────────┬──────────┬───────────┐
+ │ Name │ Status │ Created │
+ ├─────────────┼──────────┼───────────┤
+ │ > Project A │ Active │ Jan 15 │ ← Selected row
+ │ Project B │ Pending │ Jan 10 │
+ └─────────────┴──────────┴───────────┘
+```
+
+### Status Indicators
+
+```
+BADGES:
+ [SUCCESS] [WARNING] [ERROR] [INFO]
+
+DOTS:
+ ● Online ● Degraded ● Offline
+ (green) (yellow) (red)
+
+ICONS:
+ ✓ Passed ⚠ Warning ✗ Failed ○ Pending ⋯ Running
+
+PROGRESS:
+ ████████████████░░░░░░░░ 67%
+
+ Step 1 ── Step 2 ── Step 3 ── Step 4
+ ✓ ✓ ● ○
+```
+
+---
+
+## Design Checklist
+
+### Before Shipping
+
+- [ ] Works in 80-column terminals
+- [ ] Readable without color (symbols backup color)
+- [ ] Clear information hierarchy
+- [ ] Consistent spacing and alignment
+- [ ] Keyboard fully navigable
+- [ ] Error states are helpful
+- [ ] Loading states provide feedback
+- [ ] Respects NO_COLOR environment variable
+- [ ] Works in both dark and light terminals
diff --git a/skills/tui-builder/reference/ink.md b/skills/tui-builder/reference/ink.md
new file mode 100644
index 0000000..75a85f4
--- /dev/null
+++ b/skills/tui-builder/reference/ink.md
@@ -0,0 +1,621 @@
+# Ink Reference (JavaScript/TypeScript)
+
+> React for the command line
+
+## Installation
+
+```bash
+# Create new project
+mkdir my-cli && cd my-cli
+npm init -y
+npm install ink react
+npm install -D typescript @types/react @types/node tsx
+
+# Additional components
+npm install ink-text-input ink-select-input ink-spinner ink-table
+```
+
+## Setup
+
+### tsconfig.json
+```json
+{
+ "compilerOptions": {
+ "target": "ES2020",
+ "module": "ESNext",
+ "moduleResolution": "bundler",
+ "jsx": "react-jsx",
+ "strict": true,
+ "esModuleInterop": true,
+ "skipLibCheck": true,
+ "outDir": "dist"
+ },
+ "include": ["src"]
+}
+```
+
+### package.json
+```json
+{
+ "type": "module",
+ "bin": "./dist/cli.js",
+ "scripts": {
+ "dev": "tsx src/cli.tsx",
+ "build": "tsc",
+ "start": "node dist/cli.js"
+ }
+}
+```
+
+## Core Concepts
+
+### Basic App Structure
+
+```tsx
+// src/cli.tsx
+#!/usr/bin/env node
+import React from 'react';
+import { render, Text, Box } from 'ink';
+
+const App = () => (
+ <Box flexDirection="column" padding={1}>
+ <Text bold color="green">Hello from Ink!</Text>
+ <Text>This is a CLI app built with React.</Text>
+ </Box>
+);
+
+render(<App />);
+```
+
+### Box Component (Layout)
+
+```tsx
+import { Box, Text } from 'ink';
+
+// Flexbox layout (default: row)
+<Box>
+ <Text>Left</Text>
+ <Text>Right</Text>
+</Box>
+
+// Column layout
+<Box flexDirection="column">
+ <Text>Top</Text>
+ <Text>Bottom</Text>
+</Box>
+
+// With padding/margin
+<Box padding={1} marginY={1}>
+ <Text>Padded content</Text>
+</Box>
+
+// Borders
+<Box borderStyle="round" borderColor="green" padding={1}>
+ <Text>Boxed content</Text>
+</Box>
+
+// Border styles: 'single', 'double', 'round', 'bold', 'singleDouble', 'doubleSingle', 'classic'
+
+// Dimensions
+<Box width={50} height={10}>
+ <Text>Fixed size box</Text>
+</Box>
+
+// Percentage width
+<Box width="50%">
+ <Text>Half width</Text>
+</Box>
+
+// Alignment
+<Box justifyContent="center" alignItems="center" height={10}>
+ <Text>Centered</Text>
+</Box>
+```
+
+### Text Component (Styling)
+
+```tsx
+import { Text } from 'ink';
+
+// Colors
+<Text color="green">Green text</Text>
+<Text color="#ff6600">Hex color</Text>
+<Text color="rgb(255, 100, 0)">RGB color</Text>
+
+// Background
+<Text backgroundColor="blue" color="white"> Highlighted </Text>
+
+// Styles
+<Text bold>Bold</Text>
+<Text italic>Italic</Text>
+<Text underline>Underlined</Text>
+<Text strikethrough>Strikethrough</Text>
+<Text dimColor>Dimmed</Text>
+<Text inverse>Inverted</Text>
+
+// Combine styles
+<Text bold color="cyan" backgroundColor="black">
+ Styled text
+</Text>
+
+// Wrap behavior
+<Text wrap="truncate">Very long text that will be cut off...</Text>
+<Text wrap="truncate-end">Truncate at end...</Text>
+<Text wrap="truncate-start">...Truncate at start</Text>
+<Text wrap="truncate-middle">Truncate...middle</Text>
+```
+
+## Hooks
+
+### useInput (Keyboard Input)
+
+```tsx
+import { useInput, useApp } from 'ink';
+
+const App = () => {
+ const { exit } = useApp();
+ const [count, setCount] = useState(0);
+
+ useInput((input, key) => {
+ // Single character input
+ if (input === 'q') {
+ exit();
+ }
+
+ // Special keys
+ if (key.upArrow) {
+ setCount(c => c + 1);
+ }
+ if (key.downArrow) {
+ setCount(c => c - 1);
+ }
+ if (key.return) {
+ // Enter pressed
+ }
+ if (key.escape) {
+ // Escape pressed
+ }
+
+ // Modifiers
+ if (key.ctrl && input === 'c') {
+ exit();
+ }
+ if (key.meta && input === 's') {
+ // Cmd+S on Mac
+ }
+ });
+
+ return <Text>Count: {count}</Text>;
+};
+```
+
+### useApp
+
+```tsx
+import { useApp } from 'ink';
+
+const App = () => {
+ const { exit } = useApp();
+
+ const handleDone = () => {
+ exit(); // Exit cleanly
+ };
+
+ const handleError = () => {
+ exit(new Error('Something went wrong')); // Exit with error
+ };
+
+ return <Text>Press q to quit</Text>;
+};
+```
+
+### useStdin
+
+```tsx
+import { useStdin } from 'ink';
+
+const App = () => {
+ const { stdin, isRawModeSupported, setRawMode } = useStdin();
+
+ // Read from stdin
+ useEffect(() => {
+ const handleData = (data: Buffer) => {
+ console.log('Received:', data.toString());
+ };
+
+ stdin.on('data', handleData);
+ return () => stdin.off('data', handleData);
+ }, [stdin]);
+
+ return <Text>Listening for input...</Text>;
+};
+```
+
+### useStdout
+
+```tsx
+import { useStdout } from 'ink';
+
+const App = () => {
+ const { stdout, write } = useStdout();
+
+ // Get terminal dimensions
+ const { columns, rows } = stdout;
+
+ return <Text>Terminal: {columns}x{rows}</Text>;
+};
+```
+
+### useFocus & useFocusManager
+
+```tsx
+import { useFocus, useFocusManager, Box, Text } from 'ink';
+
+const FocusableItem = ({ label }: { label: string }) => {
+ const { isFocused } = useFocus();
+
+ return (
+ <Box>
+ <Text color={isFocused ? 'green' : 'white'}>
+ {isFocused ? '> ' : ' '}{label}
+ </Text>
+ </Box>
+ );
+};
+
+const App = () => {
+ const { focus } = useFocusManager();
+
+ return (
+ <Box flexDirection="column">
+ <FocusableItem label="Option 1" />
+ <FocusableItem label="Option 2" />
+ <FocusableItem label="Option 3" />
+ <Text dimColor>Tab to navigate</Text>
+ </Box>
+ );
+};
+```
+
+## Common Components
+
+### Text Input
+
+```tsx
+import TextInput from 'ink-text-input';
+
+const App = () => {
+ const [value, setValue] = useState('');
+ const [submitted, setSubmitted] = useState(false);
+
+ const handleSubmit = (value: string) => {
+ setSubmitted(true);
+ };
+
+ if (submitted) {
+ return <Text>You entered: {value}</Text>;
+ }
+
+ return (
+ <Box>
+ <Text>Enter your name: </Text>
+ <TextInput
+ value={value}
+ onChange={setValue}
+ onSubmit={handleSubmit}
+ placeholder="Type here..."
+ />
+ </Box>
+ );
+};
+```
+
+### Select Input
+
+```tsx
+import SelectInput from 'ink-select-input';
+
+const App = () => {
+ const items = [
+ { label: 'Create new project', value: 'create' },
+ { label: 'Open existing', value: 'open' },
+ { label: 'Settings', value: 'settings' },
+ { label: 'Exit', value: 'exit' },
+ ];
+
+ const handleSelect = (item: { label: string; value: string }) => {
+ if (item.value === 'exit') {
+ process.exit(0);
+ }
+ console.log('Selected:', item.value);
+ };
+
+ return (
+ <Box flexDirection="column">
+ <Text bold>What would you like to do?</Text>
+ <SelectInput items={items} onSelect={handleSelect} />
+ </Box>
+ );
+};
+```
+
+### Spinner
+
+```tsx
+import Spinner from 'ink-spinner';
+
+const App = () => {
+ const [loading, setLoading] = useState(true);
+
+ useEffect(() => {
+ setTimeout(() => setLoading(false), 3000);
+ }, []);
+
+ if (loading) {
+ return (
+ <Text>
+ <Spinner type="dots" /> Loading...
+ </Text>
+ );
+ }
+
+ return <Text color="green">Done!</Text>;
+};
+
+// Spinner types: 'dots', 'line', 'pipe', 'simpleDots', 'simpleDotsScrolling',
+// 'star', 'balloon', 'noise', 'bounce', 'boxBounce', 'triangle', 'arc', 'circle',
+// 'squareCorners', 'circleHalves', 'toggle', 'arrow', 'bouncingBar', 'pong'
+```
+
+### Progress Bar
+
+```tsx
+import React, { useState, useEffect } from 'react';
+import { Box, Text } from 'ink';
+
+const ProgressBar = ({ percent, width = 40 }: { percent: number; width?: number }) => {
+ const filled = Math.round(width * percent);
+ const empty = width - filled;
+
+ return (
+ <Box>
+ <Text color="green">{'█'.repeat(filled)}</Text>
+ <Text color="gray">{'░'.repeat(empty)}</Text>
+ <Text> {Math.round(percent * 100)}%</Text>
+ </Box>
+ );
+};
+
+const App = () => {
+ const [progress, setProgress] = useState(0);
+
+ useEffect(() => {
+ const timer = setInterval(() => {
+ setProgress(p => {
+ if (p >= 1) {
+ clearInterval(timer);
+ return 1;
+ }
+ return p + 0.1;
+ });
+ }, 500);
+ return () => clearInterval(timer);
+ }, []);
+
+ return (
+ <Box flexDirection="column">
+ <Text>Installing dependencies...</Text>
+ <ProgressBar percent={progress} />
+ </Box>
+ );
+};
+```
+
+### Table
+
+```tsx
+import Table from 'ink-table';
+
+const App = () => {
+ const data = [
+ { name: 'Alice', age: 30, role: 'Developer' },
+ { name: 'Bob', age: 25, role: 'Designer' },
+ { name: 'Charlie', age: 35, role: 'Manager' },
+ ];
+
+ return <Table data={data} />;
+};
+```
+
+## Advanced Patterns
+
+### Multi-step Form
+
+```tsx
+const App = () => {
+ const [step, setStep] = useState(0);
+ const [data, setData] = useState({ name: '', email: '', confirm: false });
+
+ const steps = [
+ {
+ question: 'What is your name?',
+ render: () => (
+ <TextInput
+ value={data.name}
+ onChange={(value) => setData({ ...data, name: value })}
+ onSubmit={() => setStep(1)}
+ />
+ ),
+ },
+ {
+ question: 'What is your email?',
+ render: () => (
+ <TextInput
+ value={data.email}
+ onChange={(value) => setData({ ...data, email: value })}
+ onSubmit={() => setStep(2)}
+ />
+ ),
+ },
+ {
+ question: 'Confirm submission?',
+ render: () => (
+ <SelectInput
+ items={[
+ { label: 'Yes', value: true },
+ { label: 'No', value: false },
+ ]}
+ onSelect={(item) => {
+ if (item.value) {
+ // Submit
+ } else {
+ setStep(0);
+ }
+ }}
+ />
+ ),
+ },
+ ];
+
+ return (
+ <Box flexDirection="column">
+ <Text bold>{steps[step].question}</Text>
+ {steps[step].render()}
+ <Text dimColor>Step {step + 1} of {steps.length}</Text>
+ </Box>
+ );
+};
+```
+
+### Async Data Fetching
+
+```tsx
+const App = () => {
+ const [data, setData] = useState<string | null>(null);
+ const [loading, setLoading] = useState(true);
+ const [error, setError] = useState<Error | null>(null);
+
+ useEffect(() => {
+ const fetchData = async () => {
+ try {
+ const response = await fetch('https://api.example.com/data');
+ const json = await response.json();
+ setData(json);
+ } catch (err) {
+ setError(err as Error);
+ } finally {
+ setLoading(false);
+ }
+ };
+
+ fetchData();
+ }, []);
+
+ if (loading) {
+ return <Text><Spinner /> Loading...</Text>;
+ }
+
+ if (error) {
+ return <Text color="red">Error: {error.message}</Text>;
+ }
+
+ return <Text>Data: {JSON.stringify(data)}</Text>;
+};
+```
+
+### Static Output (Log-style)
+
+```tsx
+import { render, Static, Box, Text } from 'ink';
+
+const App = () => {
+ const [logs, setLogs] = useState<string[]>([]);
+
+ useEffect(() => {
+ const addLog = (msg: string) => setLogs(l => [...l, msg]);
+
+ addLog('Starting...');
+ setTimeout(() => addLog('Step 1 complete'), 1000);
+ setTimeout(() => addLog('Step 2 complete'), 2000);
+ setTimeout(() => addLog('Done!'), 3000);
+ }, []);
+
+ return (
+ <>
+ {/* Static content stays in place (scrolls up) */}
+ <Static items={logs}>
+ {(log, index) => (
+ <Text key={index}>[{new Date().toISOString()}] {log}</Text>
+ )}
+ </Static>
+
+ {/* Dynamic content at bottom */}
+ <Box marginTop={1}>
+ <Spinner /> Processing...
+ </Box>
+ </>
+ );
+};
+```
+
+## Testing
+
+```tsx
+import { render } from 'ink-testing-library';
+import App from './App';
+
+describe('App', () => {
+ it('renders welcome message', () => {
+ const { lastFrame } = render(<App />);
+ expect(lastFrame()).toContain('Welcome');
+ });
+
+ it('responds to key press', () => {
+ const { lastFrame, stdin } = render(<App />);
+
+ // Simulate key press
+ stdin.write('q');
+
+ expect(lastFrame()).toContain('Goodbye');
+ });
+
+ it('handles input', async () => {
+ const { lastFrame, stdin } = render(<App />);
+
+ // Type text
+ stdin.write('Hello');
+ stdin.write('\r'); // Enter
+
+ expect(lastFrame()).toContain('You entered: Hello');
+ });
+});
+```
+
+## CLI Arguments with Pastel
+
+```tsx
+import Pastel from 'pastel';
+
+const app = new Pastel({
+ name: 'my-cli',
+ description: 'My awesome CLI tool',
+});
+
+// Define commands
+app.command('init', 'Initialize a new project', (args) => {
+ render(<InitCommand {...args} />);
+});
+
+app.command('build', 'Build the project', (args) => {
+ render(<BuildCommand {...args} />);
+});
+
+app.run();
+```
+
+## Resources
+
+- [Ink GitHub](https://github.com/vadimdemedes/ink)
+- [Ink Docs](https://github.com/vadimdemedes/ink#readme)
+- [Ink Community Components](https://github.com/vadimdemedes/ink#useful-components)
+- [Pastel (Ink CLI Framework)](https://github.com/vadimdemedes/pastel)
diff --git a/skills/tui-builder/reference/ratatui.md b/skills/tui-builder/reference/ratatui.md
new file mode 100644
index 0000000..628e61b
--- /dev/null
+++ b/skills/tui-builder/reference/ratatui.md
@@ -0,0 +1,602 @@
+# Ratatui Reference (Rust)
+
+> Build rich terminal UIs in Rust
+
+## Installation
+
+```bash
+cargo add ratatui crossterm
+```
+
+Or in `Cargo.toml`:
+```toml
+[dependencies]
+ratatui = "0.28"
+crossterm = "0.28"
+```
+
+## Core Concepts
+
+### Basic App Structure
+
+```rust
+use std::io;
+use crossterm::{
+ event::{self, Event, KeyCode, KeyEventKind},
+ terminal::{disable_raw_mode, enable_raw_mode, EnterAlternateScreen, LeaveAlternateScreen},
+ ExecutableCommand,
+};
+use ratatui::{
+ prelude::*,
+ widgets::{Block, Borders, Paragraph},
+};
+
+fn main() -> io::Result<()> {
+ // Setup terminal
+ enable_raw_mode()?;
+ io::stdout().execute(EnterAlternateScreen)?;
+ let mut terminal = Terminal::new(CrosstermBackend::new(io::stdout()))?;
+
+ // Run app
+ let result = run(&mut terminal);
+
+ // Cleanup
+ disable_raw_mode()?;
+ io::stdout().execute(LeaveAlternateScreen)?;
+
+ result
+}
+
+fn run(terminal: &mut Terminal<impl Backend>) -> io::Result<()> {
+ loop {
+ // Draw UI
+ terminal.draw(|frame| {
+ let area = frame.area();
+ frame.render_widget(
+ Paragraph::new("Hello, Ratatui! Press 'q' to quit.")
+ .block(Block::default().title("My App").borders(Borders::ALL)),
+ area,
+ );
+ })?;
+
+ // Handle input
+ if let Event::Key(key) = event::read()? {
+ if key.kind == KeyEventKind::Press && key.code == KeyCode::Char('q') {
+ break;
+ }
+ }
+ }
+ Ok(())
+}
+```
+
+## Widgets
+
+### Paragraph (Text)
+
+```rust
+use ratatui::widgets::{Paragraph, Block, Borders, Wrap};
+use ratatui::text::{Line, Span};
+use ratatui::style::{Style, Color, Modifier};
+
+// Simple text
+let para = Paragraph::new("Hello, World!");
+
+// With styling
+let para = Paragraph::new("Styled text")
+ .style(Style::default().fg(Color::Yellow).add_modifier(Modifier::BOLD))
+ .block(Block::default().title("Title").borders(Borders::ALL))
+ .wrap(Wrap { trim: true })
+ .alignment(Alignment::Center);
+
+// Rich text with spans
+let text = vec![
+ Line::from(vec![
+ Span::raw("Hello, "),
+ Span::styled("World", Style::default().fg(Color::Green).add_modifier(Modifier::BOLD)),
+ Span::raw("!"),
+ ]),
+ Line::from("Second line"),
+];
+let para = Paragraph::new(text);
+```
+
+### List
+
+```rust
+use ratatui::widgets::{List, ListItem, ListState, Block, Borders};
+
+struct App {
+ items: Vec<String>,
+ state: ListState,
+}
+
+impl App {
+ fn new() -> Self {
+ let mut state = ListState::default();
+ state.select(Some(0));
+ Self {
+ items: vec!["Item 1".into(), "Item 2".into(), "Item 3".into()],
+ state,
+ }
+ }
+
+ fn next(&mut self) {
+ let i = match self.state.selected() {
+ Some(i) => (i + 1) % self.items.len(),
+ None => 0,
+ };
+ self.state.select(Some(i));
+ }
+
+ fn previous(&mut self) {
+ let i = match self.state.selected() {
+ Some(i) => (i + self.items.len() - 1) % self.items.len(),
+ None => 0,
+ };
+ self.state.select(Some(i));
+ }
+}
+
+// Render
+fn render(frame: &mut Frame, app: &mut App) {
+ let items: Vec<ListItem> = app.items
+ .iter()
+ .map(|i| ListItem::new(i.as_str()))
+ .collect();
+
+ let list = List::new(items)
+ .block(Block::default().title("Items").borders(Borders::ALL))
+ .highlight_style(Style::default().add_modifier(Modifier::REVERSED))
+ .highlight_symbol("> ");
+
+ frame.render_stateful_widget(list, frame.area(), &mut app.state);
+}
+```
+
+### Table
+
+```rust
+use ratatui::widgets::{Table, Row, Cell, Block, Borders, TableState};
+
+let rows = vec![
+ Row::new(vec!["Alice", "30", "Developer"]),
+ Row::new(vec!["Bob", "25", "Designer"]),
+ Row::new(vec!["Charlie", "35", "Manager"]),
+];
+
+let widths = [
+ Constraint::Length(15),
+ Constraint::Length(5),
+ Constraint::Fill(1),
+];
+
+let table = Table::new(rows, widths)
+ .header(Row::new(vec!["Name", "Age", "Role"]).style(Style::default().add_modifier(Modifier::BOLD)))
+ .block(Block::default().title("Employees").borders(Borders::ALL))
+ .highlight_style(Style::default().add_modifier(Modifier::REVERSED))
+ .highlight_symbol("> ");
+
+// Stateful rendering
+let mut state = TableState::default();
+state.select(Some(0));
+frame.render_stateful_widget(table, area, &mut state);
+```
+
+### Gauge (Progress)
+
+```rust
+use ratatui::widgets::{Gauge, Block, Borders};
+
+let gauge = Gauge::default()
+ .block(Block::default().title("Progress").borders(Borders::ALL))
+ .gauge_style(Style::default().fg(Color::Green))
+ .percent(67)
+ .label("67/100");
+
+// Line gauge (simpler)
+let line_gauge = LineGauge::default()
+ .block(Block::default().title("Download"))
+ .gauge_style(Style::default().fg(Color::Blue))
+ .ratio(0.67);
+```
+
+### Sparkline
+
+```rust
+use ratatui::widgets::Sparkline;
+
+let data = vec![0, 1, 2, 3, 4, 5, 4, 3, 2, 1, 0];
+let sparkline = Sparkline::default()
+ .block(Block::default().title("Activity"))
+ .data(&data)
+ .style(Style::default().fg(Color::Yellow));
+```
+
+### Tabs
+
+```rust
+use ratatui::widgets::Tabs;
+
+let titles = vec!["Tab1", "Tab2", "Tab3"];
+let tabs = Tabs::new(titles)
+ .block(Block::default().title("Navigation").borders(Borders::ALL))
+ .select(1) // Select second tab
+ .style(Style::default().fg(Color::White))
+ .highlight_style(Style::default().fg(Color::Yellow).add_modifier(Modifier::BOLD))
+ .divider("|");
+```
+
+### Block (Container)
+
+```rust
+use ratatui::widgets::{Block, Borders, BorderType};
+
+let block = Block::default()
+ .title("Title")
+ .title_alignment(Alignment::Center)
+ .borders(Borders::ALL)
+ .border_type(BorderType::Rounded)
+ .border_style(Style::default().fg(Color::Cyan));
+```
+
+### Chart
+
+```rust
+use ratatui::widgets::{Chart, Dataset, Axis, GraphType};
+use ratatui::symbols::Marker;
+
+let datasets = vec![
+ Dataset::default()
+ .name("data1")
+ .marker(Marker::Braille)
+ .graph_type(GraphType::Line)
+ .style(Style::default().fg(Color::Cyan))
+ .data(&[(0.0, 0.0), (1.0, 1.0), (2.0, 3.0), (3.0, 2.0)]),
+];
+
+let chart = Chart::new(datasets)
+ .block(Block::default().title("Chart").borders(Borders::ALL))
+ .x_axis(Axis::default()
+ .title("X")
+ .bounds([0.0, 4.0])
+ .labels(vec!["0", "2", "4"]))
+ .y_axis(Axis::default()
+ .title("Y")
+ .bounds([0.0, 4.0])
+ .labels(vec!["0", "2", "4"]));
+```
+
+## Layout
+
+### Constraints
+
+```rust
+use ratatui::layout::{Layout, Constraint, Direction};
+
+let chunks = Layout::default()
+ .direction(Direction::Vertical)
+ .margin(1)
+ .constraints([
+ Constraint::Length(3), // Fixed height
+ Constraint::Min(5), // Minimum height
+ Constraint::Percentage(50), // 50% of remaining
+ Constraint::Fill(1), // Fill remaining space
+ ])
+ .split(frame.area());
+
+// Horizontal layout
+let horizontal = Layout::default()
+ .direction(Direction::Horizontal)
+ .constraints([
+ Constraint::Percentage(30),
+ Constraint::Percentage(70),
+ ])
+ .split(area);
+```
+
+### Nested Layouts
+
+```rust
+fn render(frame: &mut Frame) {
+ // Main vertical split
+ let main_chunks = Layout::default()
+ .direction(Direction::Vertical)
+ .constraints([
+ Constraint::Length(3), // Header
+ Constraint::Min(0), // Body
+ Constraint::Length(1), // Footer
+ ])
+ .split(frame.area());
+
+ // Body horizontal split
+ let body_chunks = Layout::default()
+ .direction(Direction::Horizontal)
+ .constraints([
+ Constraint::Percentage(30), // Sidebar
+ Constraint::Percentage(70), // Content
+ ])
+ .split(main_chunks[1]);
+
+ // Render widgets
+ frame.render_widget(header(), main_chunks[0]);
+ frame.render_widget(sidebar(), body_chunks[0]);
+ frame.render_widget(content(), body_chunks[1]);
+ frame.render_widget(footer(), main_chunks[2]);
+}
+```
+
+## Styling
+
+### Colors
+
+```rust
+use ratatui::style::{Color, Style};
+
+// Named colors
+Color::Black
+Color::Red
+Color::Green
+Color::Yellow
+Color::Blue
+Color::Magenta
+Color::Cyan
+Color::Gray
+Color::DarkGray
+Color::LightRed
+Color::White
+Color::Reset
+
+// RGB
+Color::Rgb(255, 100, 0)
+
+// 256-color palette
+Color::Indexed(208)
+```
+
+### Modifiers
+
+```rust
+use ratatui::style::Modifier;
+
+Style::default()
+ .fg(Color::Yellow)
+ .bg(Color::Black)
+ .add_modifier(Modifier::BOLD)
+ .add_modifier(Modifier::ITALIC)
+ .add_modifier(Modifier::UNDERLINED)
+ .add_modifier(Modifier::REVERSED)
+ .add_modifier(Modifier::DIM)
+ .add_modifier(Modifier::CROSSED_OUT);
+```
+
+## Event Handling
+
+### Crossterm Events
+
+```rust
+use crossterm::event::{self, Event, KeyCode, KeyModifiers, KeyEventKind};
+use std::time::Duration;
+
+fn handle_events(app: &mut App) -> io::Result<()> {
+ // Poll with timeout (non-blocking)
+ if event::poll(Duration::from_millis(100))? {
+ match event::read()? {
+ Event::Key(key) => {
+ if key.kind == KeyEventKind::Press {
+ match key.code {
+ KeyCode::Char('q') => app.quit = true,
+ KeyCode::Char('c') if key.modifiers.contains(KeyModifiers::CONTROL) => {
+ app.quit = true;
+ }
+ KeyCode::Up | KeyCode::Char('k') => app.previous(),
+ KeyCode::Down | KeyCode::Char('j') => app.next(),
+ KeyCode::Enter => app.select(),
+ KeyCode::Esc => app.back(),
+ _ => {}
+ }
+ }
+ }
+ Event::Resize(width, height) => {
+ app.width = width;
+ app.height = height;
+ }
+ Event::Mouse(mouse) => {
+ // Handle mouse events if enabled
+ }
+ _ => {}
+ }
+ }
+ Ok(())
+}
+```
+
+### Enable Mouse Support
+
+```rust
+use crossterm::event::{EnableMouseCapture, DisableMouseCapture};
+
+// In setup
+io::stdout().execute(EnableMouseCapture)?;
+
+// In cleanup
+io::stdout().execute(DisableMouseCapture)?;
+```
+
+## App Architecture
+
+### Recommended Structure
+
+```rust
+// app.rs
+pub struct App {
+ pub running: bool,
+ pub items: Vec<String>,
+ pub selected: usize,
+ pub mode: Mode,
+}
+
+pub enum Mode {
+ Normal,
+ Editing,
+ Selecting,
+}
+
+impl App {
+ pub fn new() -> Self {
+ Self {
+ running: true,
+ items: vec!["Item 1".into(), "Item 2".into()],
+ selected: 0,
+ mode: Mode::Normal,
+ }
+ }
+
+ pub fn tick(&mut self) {
+ // Update state on each tick
+ }
+
+ pub fn quit(&mut self) {
+ self.running = false;
+ }
+}
+
+// ui.rs
+pub fn render(frame: &mut Frame, app: &App) {
+ match app.mode {
+ Mode::Normal => render_normal(frame, app),
+ Mode::Editing => render_editing(frame, app),
+ Mode::Selecting => render_selecting(frame, app),
+ }
+}
+
+// event.rs
+pub fn handle_event(app: &mut App, event: Event) {
+ match app.mode {
+ Mode::Normal => handle_normal(app, event),
+ Mode::Editing => handle_editing(app, event),
+ Mode::Selecting => handle_selecting(app, event),
+ }
+}
+
+// main.rs
+fn main() -> io::Result<()> {
+ let mut terminal = setup_terminal()?;
+ let mut app = App::new();
+
+ while app.running {
+ terminal.draw(|frame| ui::render(frame, &app))?;
+
+ if event::poll(Duration::from_millis(16))? {
+ event::handle_event(&mut app, event::read()?);
+ }
+
+ app.tick();
+ }
+
+ restore_terminal()?;
+ Ok(())
+}
+```
+
+## Async with Tokio
+
+```rust
+use tokio::sync::mpsc;
+
+enum Message {
+ Tick,
+ Key(KeyEvent),
+ DataLoaded(Vec<String>),
+}
+
+#[tokio::main]
+async fn main() -> io::Result<()> {
+ let (tx, mut rx) = mpsc::unbounded_channel();
+
+ // Spawn tick task
+ let tx_tick = tx.clone();
+ tokio::spawn(async move {
+ loop {
+ tx_tick.send(Message::Tick).unwrap();
+ tokio::time::sleep(Duration::from_millis(100)).await;
+ }
+ });
+
+ // Spawn input task
+ let tx_input = tx.clone();
+ tokio::spawn(async move {
+ loop {
+ if let Event::Key(key) = event::read().unwrap() {
+ tx_input.send(Message::Key(key)).unwrap();
+ }
+ }
+ });
+
+ // Main loop
+ let mut app = App::new();
+ while app.running {
+ terminal.draw(|f| ui::render(f, &app))?;
+
+ match rx.recv().await {
+ Some(Message::Tick) => app.tick(),
+ Some(Message::Key(key)) => handle_key(&mut app, key),
+ Some(Message::DataLoaded(data)) => app.data = data,
+ None => break,
+ }
+ }
+
+ Ok(())
+}
+```
+
+## Testing
+
+```rust
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use ratatui::backend::TestBackend;
+
+ #[test]
+ fn test_app_navigation() {
+ let mut app = App::new();
+ assert_eq!(app.selected, 0);
+
+ app.next();
+ assert_eq!(app.selected, 1);
+
+ app.previous();
+ assert_eq!(app.selected, 0);
+ }
+
+ #[test]
+ fn test_render() {
+ let backend = TestBackend::new(80, 24);
+ let mut terminal = Terminal::new(backend).unwrap();
+ let app = App::new();
+
+ terminal.draw(|frame| render(frame, &app)).unwrap();
+
+ let buffer = terminal.backend().buffer();
+ // Assert buffer contents
+ assert!(buffer.get(0, 0).symbol() == "┌");
+ }
+}
+```
+
+## Templates
+
+### Quick Start Template
+
+```bash
+cargo generate ratatui/templates simple
+```
+
+## Resources
+
+- [Ratatui Docs](https://ratatui.rs/)
+- [Ratatui GitHub](https://github.com/ratatui/ratatui)
+- [Examples](https://github.com/ratatui/ratatui/tree/main/examples)
+- [Templates](https://github.com/ratatui/templates)
+- [Awesome Ratatui](https://github.com/ratatui/awesome-ratatui)
diff --git a/skills/tui-builder/reference/style-presets.md b/skills/tui-builder/reference/style-presets.md
new file mode 100644
index 0000000..51d0ad1
--- /dev/null
+++ b/skills/tui-builder/reference/style-presets.md
@@ -0,0 +1,671 @@
+# TUI Style Presets
+
+> Ready-to-use aesthetic systems for terminal interfaces
+
+## Style Index
+
+| Style | Vibe | Best For |
+|-------|------|----------|
+| [Corporate](#corporate) | Clean, professional, trustworthy | Enterprise tools, B2B |
+| [Hacker](#hacker) | Matrix-style, technical, edgy | Dev tools, security |
+| [Retro/DOS](#retro-dos) | 80s computing, nostalgic | Games, novelty apps |
+| [Cyberpunk](#cyberpunk) | Neon, high-tech, futuristic | Monitoring, dashboards |
+| [Minimal](#minimal) | Clean, zen, focused | Productivity, writing |
+| [Pip-Boy](#pip-boy) | Fallout-inspired, amber CRT | Games, themed apps |
+| [Synthwave](#synthwave) | 80s neon, vaporwave | Music apps, creative tools |
+| [Nord](#nord) | Arctic, calm, muted | Code editors, everyday use |
+| [Dracula](#dracula) | Dark, purple-accented | Dev environments |
+| [Gruvbox](#gruvbox) | Warm, earthy, retro | Text-heavy apps |
+
+---
+
+## Corporate
+
+> Clean lines, professional blues, enterprise-grade trust
+
+### Philosophy
+Corporate design prioritizes clarity, accessibility, and professionalism. It should feel like enterprise software—reliable, not flashy.
+
+### Color Palette
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ CORPORATE PALETTE │
+├─────────────────────────────────────────────────────────────┤
+│ Background #1a1a2e ████ Deep navy │
+│ Surface #16213e ████ Slightly lighter │
+│ Primary #0f4c75 ████ Corporate blue │
+│ Accent #3282b8 ████ Bright blue │
+│ Text #e8e8e8 ████ Light gray │
+│ Muted #6b7280 ████ Gray │
+│ Success #10b981 ████ Green │
+│ Warning #f59e0b ████ Amber │
+│ Error #ef4444 ████ Red │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Visual Language
+
+```
+BORDERS: Single line, rounded corners
+╭──────────────────────────────────────────────────────────────╮
+│ │
+│ ACME CORP DASHBOARD │
+│ │
+├──────────────────────────────────────────────────────────────┤
+│ │
+│ Quarterly Report │
+│ ──────────────── │
+│ │
+│ Revenue $1,234,567 ▲ 12.5% │
+│ Users 45,678 ▲ 8.3% │
+│ Churn 2.1% ▼ 0.5% │
+│ │
+│ ┌─────────────────────────────────────────────────────┐ │
+│ │ ████████████████████████████████░░░░░░░░░░ 78% │ │
+│ │ Q4 Target Progress │ │
+│ └─────────────────────────────────────────────────────┘ │
+│ │
+│ [ View Details ] [ Export ] │
+│ │
+╰──────────────────────────────────────────────────────────────╯
+```
+
+### Lipgloss (Go)
+
+```go
+var CorporateStyle = struct {
+ Background lipgloss.Color
+ Surface lipgloss.Color
+ Primary lipgloss.Color
+ Accent lipgloss.Color
+ Text lipgloss.Color
+ Muted lipgloss.Color
+}{
+ Background: lipgloss.Color("#1a1a2e"),
+ Surface: lipgloss.Color("#16213e"),
+ Primary: lipgloss.Color("#0f4c75"),
+ Accent: lipgloss.Color("#3282b8"),
+ Text: lipgloss.Color("#e8e8e8"),
+ Muted: lipgloss.Color("#6b7280"),
+}
+
+headerStyle := lipgloss.NewStyle().
+ Background(CorporateStyle.Primary).
+ Foreground(lipgloss.Color("#ffffff")).
+ Bold(true).
+ Padding(0, 2)
+
+boxStyle := lipgloss.NewStyle().
+ Border(lipgloss.RoundedBorder()).
+ BorderForeground(CorporateStyle.Accent).
+ Padding(1, 2)
+```
+
+---
+
+## Hacker
+
+> Green-on-black Matrix aesthetic, technical and edgy
+
+### Philosophy
+Channel the feeling of being inside the machine. Dense information, scrolling text, the aesthetic of power users and security researchers.
+
+### Color Palette
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ HACKER PALETTE │
+├─────────────────────────────────────────────────────────────┤
+│ Background #0a0a0a ████ Near black │
+│ Surface #111111 ████ Slightly lighter │
+│ Primary #00ff00 ████ Matrix green │
+│ Accent #00cc00 ████ Darker green │
+│ Text #00ff00 ████ Green text │
+│ Muted #006600 ████ Dim green │
+│ Highlight #00ff00 ████ Bright green (inverted) │
+│ Error #ff0000 ████ Red alert │
+│ Warning #ffff00 ████ Yellow │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Visual Language
+
+```
+BORDERS: ASCII or single line, sharp corners
++==============================================================+
+| |
+| > SYSTEM ACCESS GRANTED |
+| > USER: root@mainframe |
+| > SESSION: 0x7F3A2B1C |
+| |
++--------------------------------------------------------------+
+| |
+| [SCANNING NETWORK...] |
+| |
+| 192.168.1.1 ████████████████████ ONLINE [ANALYZE] |
+| 192.168.1.24 ████████████░░░░░░░░ PARTIAL [ANALYZE] |
+| 192.168.1.105 ░░░░░░░░░░░░░░░░░░░░ OFFLINE [ SKIP ] |
+| |
+| > Found 2 active nodes |
+| > Scanning ports... |
+| > ████████████████░░░░░░░░ 67% [PORT 443] |
+| |
+| [ABORT] [PAUSE] [EXPORT LOG] |
+| |
++==============================================================+
+```
+
+### Animation Style
+
+```
+TYPEWRITER EFFECT:
+> Initializing connection...
+> Handshake complete
+> Decrypting payload█
+
+MATRIX RAIN:
+ ア イ ウ エ オ カ キ ク ケ コ
+ ワ ヰ ヱ ヲ ン ヴ ヵ ヶ
+ タ チ ツ テ ト ナ ニ
+ サ シ ス セ ソ
+
+SCAN LINE:
+▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
+```
+
+---
+
+## Retro DOS
+
+> 80s computing nostalgia, CGA colors, blocky aesthetic
+
+### Philosophy
+Transport users back to the DOS era. Limited color palette, blocky UI elements, that distinctive early PC feel.
+
+### Color Palette (CGA)
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ DOS/CGA PALETTE │
+├─────────────────────────────────────────────────────────────┤
+│ Background #0000aa ████ DOS Blue │
+│ Surface #000000 ████ Black │
+│ Primary #ffff55 ████ Yellow │
+│ Accent #55ffff ████ Cyan │
+│ Text #ffffff ████ White │
+│ Muted #aaaaaa ████ Gray │
+│ Highlight #ff55ff ████ Magenta │
+│ Border #ffffff ████ White │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Visual Language
+
+```
+BORDERS: Double line, blocky
+╔══════════════════════════════════════════════════════════════╗
+║ ║
+║ ██████╗ ██████╗ ███████╗ ████████╗██╗ ██╗██╗ ║
+║ ██╔══██╗██╔═══██╗██╔════╝ ╚══██╔══╝██║ ██║██║ ║
+║ ██║ ██║██║ ██║███████╗ ██║ ██║ ██║██║ ║
+║ ██║ ██║██║ ██║╚════██║ ██║ ██║ ██║██║ ║
+║ ██████╔╝╚██████╔╝███████║ ██║ ╚██████╔╝██║ ║
+║ ╚═════╝ ╚═════╝ ╚══════╝ ╚═╝ ╚═════╝ ╚═╝ ║
+║ ║
+╠══════════════════════════════════════════════════════════════╣
+║ ║
+║ C:\> dir ║
+║ ║
+║ Volume in drive C is MAIN ║
+║ Directory of C:\ ║
+║ ║
+║ COMMAND COM 47,845 01-15-24 10:30a ║
+║ CONFIG SYS 256 01-15-24 10:30a ║
+║ AUTOEXEC BAT 128 01-15-24 10:30a ║
+║ ║
+║ 3 file(s) 48,229 bytes ║
+║ 0 dir(s) 1,234,567 bytes free ║
+║ ║
+║ C:\> █ ║
+║ ║
+╚══════════════════════════════════════════════════════════════╝
+
+BUTTONS: Block style
+┌────────────────┐ ┌────────────────┐ ┌────────────────┐
+│ < Yes > │ │ < No > │ │ < Cancel > │
+└────────────────┘ └────────────────┘ └────────────────┘
+
+MENUS: Highlighted bar
+┌─ File ─────────────────┐
+│ ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ │ ← New Ctrl+N
+│ Open... Ctrl+O │
+│ Save Ctrl+S │
+│ ───────────────────── │
+│ Exit Alt+X │
+└────────────────────────┘
+```
+
+---
+
+## Cyberpunk
+
+> Neon-drenched, high-tech dystopia, glitch aesthetic
+
+### Philosophy
+Maximum visual intensity. Neon colors against dark backgrounds, glitch effects, the feeling of a rain-soaked neon cityscape.
+
+### Color Palette
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ CYBERPUNK PALETTE │
+├─────────────────────────────────────────────────────────────┤
+│ Background #0d0d0d ████ Near black │
+│ Surface #1a1a2e ████ Dark purple-black │
+│ Primary #ff00ff ████ Hot magenta │
+│ Secondary #00ffff ████ Electric cyan │
+│ Accent #ff6b6b ████ Neon coral │
+│ Text #ffffff ████ White │
+│ Muted #4a4a6a ████ Purple-gray │
+│ Warning #ffff00 ████ Yellow │
+│ Glow #ff00ff ████ Magenta glow │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Visual Language
+
+```
+BORDERS: Heavy, with glow effect (double colors)
+┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+┃ ┃
+┃ ░█▀▀░█░█░█▀▄░█▀▀░█▀▄░█▀█░█░█░█▀█░█░█ ┃
+┃ ░█░░░░█░░█▀▄░█▀▀░█▀▄░█▀▀░█░█░█░█░█▀▄ ┃
+┃ ░▀▀▀░░▀░░▀▀░░▀▀▀░▀░▀░▀░░░▀▀▀░▀░▀░▀░▀ ┃
+┃ ┃
+┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+┃ ┃
+┃ ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ ┃
+┃ NEURAL LINK ACTIVE ║ SYNC: 98.7% ┃
+┃ ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ ┃
+┃ ┃
+┃ ┌─────────────────┐ ┌─────────────────┐ ┃
+┃ │ ◢◤ UPLOAD ◢◤ │ │ ◢◤ DOWNLOAD ◢◤ │ ┃
+┃ │ 2.4 GB/s │ │ 1.8 GB/s │ ┃
+┃ └─────────────────┘ └─────────────────┘ ┃
+┃ ┃
+┃ [ JACK IN ] [ DISCONNECT ] [ TRACE ] ┃
+┃ ┃
+┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+GLITCH TEXT EFFECT:
+N̷E̵U̴R̷A̸L̶ ̵L̶I̵N̴K̵ ̶A̵C̸T̵I̵V̸E̴
+
+SCAN LINES:
+▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
+▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
+```
+
+---
+
+## Minimal
+
+> Clean, zen-like, maximum focus on content
+
+### Philosophy
+Strip away everything unnecessary. Let content breathe. Minimal borders, subtle colors, pure function.
+
+### Color Palette
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ MINIMAL PALETTE │
+├─────────────────────────────────────────────────────────────┤
+│ Background #1a1a1a ████ Soft black │
+│ Surface #2d2d2d ████ Dark gray │
+│ Primary #ffffff ████ White │
+│ Accent #888888 ████ Medium gray │
+│ Text #e0e0e0 ████ Light gray │
+│ Muted #666666 ████ Dim gray │
+│ Subtle #333333 ████ Barely visible │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Visual Language
+
+```
+BORDERS: None or very subtle
+
+ Tasks
+
+ ○ Buy groceries
+ ○ Finish report
+ ● Call mom ← Selected (filled)
+ ○ Exercise
+
+ ─────────────────────────────
+
+ Press Enter to complete, Tab to edit
+
+
+NO BOXES, JUST SPACE:
+
+ Welcome back.
+
+ You have 3 tasks remaining.
+ 2 hours of focus time logged.
+
+
+
+ What would you like to do?
+
+ > Start focus session
+ View tasks
+ Settings
+
+
+
+
+ ↑↓ navigate enter select q quit
+```
+
+---
+
+## Pip-Boy
+
+> Fallout-inspired, amber CRT, post-apocalyptic retro
+
+### Philosophy
+Channel the Fallout Pip-Boy device. Amber/green phosphor CRT aesthetic, rounded edges, that distinctive vault-tec feel.
+
+### Color Palette
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ PIP-BOY PALETTE │
+├─────────────────────────────────────────────────────────────┤
+│ Background #0a0a08 ████ CRT black │
+│ Scanline #0f0f0d ████ Scanline overlay │
+│ Primary #18ff6d ████ Pip-Boy green │
+│ Alt Primary #ffb000 ████ Amber variant │
+│ Dim #0a5528 ████ Dark green │
+│ Text #18ff6d ████ Green text │
+│ Highlight #0a0a08 ████ Inverted (green bg) │
+│ Warning #ff6600 ████ Orange │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Visual Language
+
+```
+BORDERS: Rounded, technical
+╭──────────────────────────────────────────────────────────────╮
+│ ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ │
+│ █ VAULT-TEC PIP-BOY 3000 █████████████████████████████████ │
+│ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ │
+├──────────────────────────────────────────────────────────────┤
+│ ┌─ STAT ─┬─ INV ─┬─ DATA ─┬─ MAP ─┬─ RADIO ─┐ │
+│ └────────┴───────┴────────┴───────┴─────────┘ │
+│ │
+│ HP ████████████████░░░░░░░░ 175/250 │
+│ AP ██████████░░░░░░░░░░░░░░ 85/200 │
+│ XP ████████████████████░░░░ Level 24 │
+│ │
+│ ┌─ SPECIAL ──────────────────────────────────────────────┐ │
+│ │ S:6 P:7 E:5 C:4 I:8 A:6 L:5 │ │
+│ └────────────────────────────────────────────────────────┘ │
+│ │
+│ [ STATUS ] [ EFFECTS ] [ PERKS ] │
+│ │
+│ ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ │
+╰──────────────────────────────────────────────────────────────╯
+
+CRT SCANLINE EFFECT (Apply with alternating dim lines):
+████████████████████████████████████████████████████
+▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
+████████████████████████████████████████████████████
+▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
+```
+
+---
+
+## Nord
+
+> Arctic, calm, muted palette inspired by the Nord color scheme
+
+### Color Palette
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ NORD PALETTE │
+├─────────────────────────────────────────────────────────────┤
+│ Polar Night │
+│ nord0 #2e3440 ████ Background │
+│ nord1 #3b4252 ████ Elevated surface │
+│ nord2 #434c5e ████ Selection │
+│ nord3 #4c566a ████ Comments │
+│ │
+│ Snow Storm │
+│ nord4 #d8dee9 ████ Text │
+│ nord5 #e5e9f0 ████ Light text │
+│ nord6 #eceff4 ████ Bright text │
+│ │
+│ Frost │
+│ nord7 #8fbcbb ████ Teal │
+│ nord8 #88c0d0 ████ Cyan │
+│ nord9 #81a1c1 ████ Blue │
+│ nord10 #5e81ac ████ Dark blue │
+│ │
+│ Aurora │
+│ nord11 #bf616a ████ Red │
+│ nord12 #d08770 ████ Orange │
+│ nord13 #ebcb8b ████ Yellow │
+│ nord14 #a3be8c ████ Green │
+│ nord15 #b48ead ████ Purple │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Dracula
+
+> Dark theme with purple accents, popular in dev tools
+
+### Color Palette
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ DRACULA PALETTE │
+├─────────────────────────────────────────────────────────────┤
+│ Background #282a36 ████ │
+│ Current Line #44475a ████ │
+│ Foreground #f8f8f2 ████ │
+│ Comment #6272a4 ████ │
+│ Cyan #8be9fd ████ │
+│ Green #50fa7b ████ │
+│ Orange #ffb86c ████ │
+│ Pink #ff79c6 ████ │
+│ Purple #bd93f9 ████ │
+│ Red #ff5555 ████ │
+│ Yellow #f1fa8c ████ │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Gruvbox
+
+> Retro groove, warm earthy colors
+
+### Color Palette
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ GRUVBOX DARK PALETTE │
+├─────────────────────────────────────────────────────────────┤
+│ bg #282828 ████ │
+│ bg1 #3c3836 ████ │
+│ bg2 #504945 ████ │
+│ fg #ebdbb2 ████ │
+│ fg1 #d5c4a1 ████ │
+│ red #fb4934 ████ │
+│ green #b8bb26 ████ │
+│ yellow #fabd2f ████ │
+│ blue #83a598 ████ │
+│ purple #d3869b ████ │
+│ aqua #8ec07c ████ │
+│ orange #fe8019 ████ │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Synthwave
+
+> 80s neon, vaporwave aesthetic, retro-futurism
+
+### Color Palette
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ SYNTHWAVE PALETTE │
+├─────────────────────────────────────────────────────────────┤
+│ Background #241b2f ████ Dark purple │
+│ Surface #2d1f3d ████ Purple │
+│ Primary #ff7edb ████ Hot pink │
+│ Secondary #72f1b8 ████ Mint │
+│ Accent #36f9f6 ████ Cyan │
+│ Text #f4eeff ████ Light purple-white │
+│ Yellow #fede5d ████ Gold │
+│ Orange #ff8b39 ████ Orange │
+│ Red #fe4450 ████ Red │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Visual Language
+
+```
+╔════════════════════════════════════════════════════════════╗
+║ ║
+║ ███████╗██╗ ██╗███╗ ██╗████████╗██╗ ██╗ ║
+║ ██╔════╝╚██╗ ██╔╝████╗ ██║╚══██╔══╝██║ ██║ ║
+║ ███████╗ ╚████╔╝ ██╔██╗ ██║ ██║ ███████║ ║
+║ ╚════██║ ╚██╔╝ ██║╚██╗██║ ██║ ██╔══██║ ║
+║ ███████║ ██║ ██║ ╚████║ ██║ ██║ ██║ ║
+║ ╚══════╝ ╚═╝ ╚═╝ ╚═══╝ ╚═╝ ╚═╝ ╚═╝ ║
+║ ║
+║ ▁▂▃▄▅▆▇█▇▆▅▄▃▂▁▂▃▄▅▆▇█▇▆▅▄▃▂▁▂▃▄▅▆▇█▇▆▅▄▃▂▁ ║
+║ ║
+║ ┌─────────────────────────────────────────────────────┐ ║
+║ │ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ │ ║
+║ │ ████████████████████████████████████░░░░░░░░░░░░░ │ ║
+║ │ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ │ ║
+║ └─────────────────────────────────────────────────────┘ ║
+║ ║
+║ [ PLAY ] [ STOP ] [ NEXT ] ║
+║ ║
+╚════════════════════════════════════════════════════════════╝
+```
+
+---
+
+## Quick Style Selector
+
+When implementing, use this guide:
+
+| Need | Recommended Style |
+|------|-------------------|
+| Enterprise SaaS | Corporate |
+| Developer tool | Hacker or Dracula |
+| Nostalgic/fun app | Retro DOS or Pip-Boy |
+| Monitoring dashboard | Cyberpunk |
+| Writing/productivity | Minimal or Nord |
+| Music/creative | Synthwave |
+| Code editor | Dracula or Gruvbox |
+| General purpose | Nord |
+
+---
+
+## Implementation Tips
+
+### Lipgloss Theme System (Go)
+
+```go
+type Theme struct {
+ Background lipgloss.Color
+ Surface lipgloss.Color
+ Primary lipgloss.Color
+ Secondary lipgloss.Color
+ Accent lipgloss.Color
+ Text lipgloss.Color
+ Muted lipgloss.Color
+ Success lipgloss.Color
+ Warning lipgloss.Color
+ Error lipgloss.Color
+ BorderStyle lipgloss.Border
+}
+
+var Themes = map[string]Theme{
+ "corporate": {
+ Background: lipgloss.Color("#1a1a2e"),
+ Primary: lipgloss.Color("#0f4c75"),
+ // ...
+ BorderStyle: lipgloss.RoundedBorder(),
+ },
+ "hacker": {
+ Background: lipgloss.Color("#0a0a0a"),
+ Primary: lipgloss.Color("#00ff00"),
+ // ...
+ BorderStyle: lipgloss.NormalBorder(),
+ },
+}
+
+func ApplyTheme(theme Theme) {
+ // Apply to all styles
+}
+```
+
+### Textual CSS Variables (Python)
+
+```css
+/* themes/corporate.tcss */
+$background: #1a1a2e;
+$surface: #16213e;
+$primary: #0f4c75;
+$accent: #3282b8;
+$text: #e8e8e8;
+
+/* themes/hacker.tcss */
+$background: #0a0a0a;
+$surface: #111111;
+$primary: #00ff00;
+$text: #00ff00;
+```
+
+### Ink Theme Context (React)
+
+```tsx
+const themes = {
+ corporate: {
+ background: '#1a1a2e',
+ primary: '#0f4c75',
+ text: '#e8e8e8',
+ },
+ hacker: {
+ background: '#0a0a0a',
+ primary: '#00ff00',
+ text: '#00ff00',
+ },
+};
+
+const ThemeContext = React.createContext(themes.corporate);
+
+const ThemedBox = ({ children }) => {
+ const theme = useContext(ThemeContext);
+ return (
+ <Box borderStyle="round" borderColor={theme.primary}>
+ <Text color={theme.text}>{children}</Text>
+ </Box>
+ );
+};
+```
diff --git a/skills/tui-builder/reference/textual.md b/skills/tui-builder/reference/textual.md
new file mode 100644
index 0000000..fb10b4a
--- /dev/null
+++ b/skills/tui-builder/reference/textual.md
@@ -0,0 +1,594 @@
+# Textual Reference (Python)
+
+> Modern Python framework for TUI applications
+
+## Installation
+
+```bash
+pip install textual
+# or with dev tools
+pip install "textual[dev]"
+```
+
+## Core Concepts
+
+### Basic App Structure
+
+```python
+from textual.app import App, ComposeResult
+from textual.widgets import Header, Footer, Static, Button
+from textual.containers import Container
+
+class MyApp(App):
+ """A simple Textual app."""
+
+ # CSS styling
+ CSS = """
+ Screen {
+ layout: vertical;
+ }
+
+ #welcome {
+ text-align: center;
+ padding: 2;
+ }
+ """
+
+ # Key bindings
+ BINDINGS = [
+ ("q", "quit", "Quit"),
+ ("d", "toggle_dark", "Toggle dark mode"),
+ ]
+
+ def compose(self) -> ComposeResult:
+ """Create child widgets."""
+ yield Header()
+ yield Container(
+ Static("Welcome to Textual!", id="welcome"),
+ Button("Click me!", id="btn"),
+ )
+ yield Footer()
+
+ def on_button_pressed(self, event: Button.Pressed) -> None:
+ """Handle button press."""
+ if event.button.id == "btn":
+ self.notify("Button clicked!")
+
+ def action_toggle_dark(self) -> None:
+ """Toggle dark mode."""
+ self.dark = not self.dark
+
+if __name__ == "__main__":
+ app = MyApp()
+ app.run()
+```
+
+## Widgets
+
+### Built-in Widgets
+
+```python
+from textual.widgets import (
+ Button, # Clickable button
+ Checkbox, # Toggle checkbox
+ DataTable, # Spreadsheet-like table
+ DirectoryTree, # File browser
+ Footer, # Key binding hints
+ Header, # App title bar
+ Input, # Text input
+ Label, # Text label
+ ListItem, # List item
+ ListView, # Scrollable list
+ LoadingIndicator,# Spinner
+ Log, # Scrolling log
+ Markdown, # Rendered markdown
+ MarkdownViewer, # Markdown with navigation
+ OptionList, # Selectable options
+ Placeholder, # Development placeholder
+ Pretty, # Pretty-printed data
+ ProgressBar, # Progress indicator
+ RadioButton, # Radio selection
+ RadioSet, # Group of radio buttons
+ RichLog, # Rich text log
+ Rule, # Horizontal line
+ Select, # Dropdown select
+ SelectionList, # Multi-select list
+ Sparkline, # Mini chart
+ Static, # Static text/content
+ Switch, # On/off toggle
+ TabbedContent, # Tab container
+ TabPane, # Tab panel
+ Tabs, # Tab bar
+ TextArea, # Multi-line text
+ Tree, # Tree view
+)
+```
+
+### Input Widget
+
+```python
+from textual.widgets import Input
+
+class MyApp(App):
+ def compose(self) -> ComposeResult:
+ yield Input(placeholder="Enter your name...")
+ yield Input(password=True, placeholder="Password")
+
+ def on_input_submitted(self, event: Input.Submitted) -> None:
+ value = event.value
+ self.notify(f"You entered: {value}")
+```
+
+### DataTable
+
+```python
+from textual.widgets import DataTable
+
+class MyApp(App):
+ def compose(self) -> ComposeResult:
+ yield DataTable()
+
+ def on_mount(self) -> None:
+ table = self.query_one(DataTable)
+ table.add_columns("Name", "Age", "City")
+ table.add_rows([
+ ("Alice", 30, "NYC"),
+ ("Bob", 25, "LA"),
+ ("Charlie", 35, "Chicago"),
+ ])
+
+ def on_data_table_row_selected(self, event: DataTable.RowSelected) -> None:
+ self.notify(f"Selected row: {event.row_key}")
+```
+
+### ListView
+
+```python
+from textual.widgets import ListView, ListItem, Label
+
+class MyApp(App):
+ def compose(self) -> ComposeResult:
+ yield ListView(
+ ListItem(Label("Option 1"), id="opt1"),
+ ListItem(Label("Option 2"), id="opt2"),
+ ListItem(Label("Option 3"), id="opt3"),
+ )
+
+ def on_list_view_selected(self, event: ListView.Selected) -> None:
+ self.notify(f"Selected: {event.item.id}")
+```
+
+### TabbedContent
+
+```python
+from textual.widgets import TabbedContent, TabPane, Static
+
+class MyApp(App):
+ def compose(self) -> ComposeResult:
+ with TabbedContent():
+ with TabPane("Home", id="home"):
+ yield Static("Welcome home!")
+ with TabPane("Settings", id="settings"):
+ yield Static("Settings go here")
+ with TabPane("About", id="about"):
+ yield Static("About this app")
+```
+
+### Tree
+
+```python
+from textual.widgets import Tree
+
+class MyApp(App):
+ def compose(self) -> ComposeResult:
+ tree = Tree("Root")
+ tree.root.expand()
+
+ branch1 = tree.root.add("Branch 1")
+ branch1.add_leaf("Leaf 1.1")
+ branch1.add_leaf("Leaf 1.2")
+
+ branch2 = tree.root.add("Branch 2")
+ branch2.add_leaf("Leaf 2.1")
+
+ yield tree
+```
+
+## Containers & Layout
+
+### Container Types
+
+```python
+from textual.containers import (
+ Container, # Basic container
+ Horizontal, # Horizontal layout
+ Vertical, # Vertical layout
+ Grid, # CSS Grid layout
+ ScrollableContainer, # Scrollable area
+ Center, # Center content
+ Middle, # Vertically center
+ VerticalScroll, # Vertical scrollable
+ HorizontalScroll,# Horizontal scrollable
+)
+```
+
+### Layout Examples
+
+```python
+from textual.containers import Horizontal, Vertical, Grid
+
+class MyApp(App):
+ CSS = """
+ Horizontal {
+ height: auto;
+ }
+
+ .box {
+ width: 1fr;
+ height: 5;
+ border: solid green;
+ }
+
+ Grid {
+ grid-size: 3 2;
+ grid-gutter: 1;
+ }
+ """
+
+ def compose(self) -> ComposeResult:
+ # Horizontal layout
+ with Horizontal():
+ yield Static("Left", classes="box")
+ yield Static("Middle", classes="box")
+ yield Static("Right", classes="box")
+
+ # Grid layout
+ with Grid():
+ for i in range(6):
+ yield Static(f"Cell {i}", classes="box")
+```
+
+## CSS Styling
+
+### Textual CSS (TCSS)
+
+```css
+/* styles.tcss */
+
+/* Target by type */
+Button {
+ background: $primary;
+ color: $text;
+ border: tall $accent;
+}
+
+/* Target by ID */
+#main-content {
+ width: 100%;
+ height: 1fr;
+}
+
+/* Target by class */
+.highlighted {
+ background: $warning;
+ text-style: bold;
+}
+
+/* Pseudo-classes */
+Button:hover {
+ background: $primary-lighten-1;
+}
+
+Button:focus {
+ border: heavy $accent;
+}
+
+/* Nested rules */
+#sidebar {
+ width: 30;
+
+ Button {
+ width: 100%;
+ margin: 1;
+ }
+}
+```
+
+### Common CSS Properties
+
+```css
+/* Dimensions */
+width: 50; /* Cells */
+width: 50%; /* Percentage */
+width: 1fr; /* Fraction */
+width: auto; /* Content-based */
+min-width: 20;
+max-width: 100;
+
+/* Spacing */
+margin: 1 2; /* Vertical, Horizontal */
+padding: 1 2 3 4; /* Top, Right, Bottom, Left */
+
+/* Colors */
+background: $primary;
+background: #ff6600;
+background: rgb(255, 100, 0);
+color: $text;
+
+/* Borders */
+border: solid green;
+border: double red;
+border: round $accent;
+border-title-align: center;
+
+/* Text */
+text-align: center;
+text-style: bold italic underline;
+
+/* Layout */
+layout: horizontal;
+layout: vertical;
+layout: grid;
+align: center middle;
+content-align: center middle;
+```
+
+### Loading External CSS
+
+```python
+class MyApp(App):
+ CSS_PATH = "styles.tcss" # Load from file
+
+ # Or inline CSS
+ CSS = """
+ Screen {
+ background: $surface;
+ }
+ """
+```
+
+## Reactive Attributes
+
+```python
+from textual.reactive import reactive
+
+class Counter(Static):
+ """A counter widget."""
+
+ count: reactive[int] = reactive(0)
+
+ def render(self) -> str:
+ return f"Count: {self.count}"
+
+ def watch_count(self, count: int) -> None:
+ """Called when count changes."""
+ if count >= 10:
+ self.add_class("high")
+ else:
+ self.remove_class("high")
+
+ def increment(self) -> None:
+ self.count += 1
+```
+
+## Messages & Events
+
+### Custom Messages
+
+```python
+from textual.message import Message
+
+class Counter(Static):
+ class LimitReached(Message):
+ """Message sent when limit is reached."""
+ def __init__(self, count: int) -> None:
+ self.count = count
+ super().__init__()
+
+ def increment(self) -> None:
+ self.count += 1
+ if self.count >= 10:
+ self.post_message(self.LimitReached(self.count))
+
+class MyApp(App):
+ def on_counter_limit_reached(self, message: Counter.LimitReached) -> None:
+ self.notify(f"Limit reached at {message.count}!")
+```
+
+### Event Handlers
+
+```python
+class MyApp(App):
+ # Named handler (preferred)
+ def on_button_pressed(self, event: Button.Pressed) -> None:
+ pass
+
+ # Handler for specific button
+ def on_button_pressed_submit_btn(self, event: Button.Pressed) -> None:
+ """Handle #submit-btn specifically."""
+ pass
+
+ # Mount event (widget added to DOM)
+ def on_mount(self) -> None:
+ pass
+
+ # Key press
+ def on_key(self, event: events.Key) -> None:
+ if event.key == "escape":
+ self.exit()
+```
+
+## Workers (Background Tasks)
+
+```python
+from textual import work
+from textual.worker import Worker
+
+class MyApp(App):
+ @work(exclusive=True)
+ async def fetch_data(self, url: str) -> None:
+ """Background task to fetch data."""
+ self.query_one("#status").update("Loading...")
+
+ async with httpx.AsyncClient() as client:
+ response = await client.get(url)
+ data = response.json()
+
+ self.query_one("#result").update(str(data))
+ self.query_one("#status").update("Done!")
+
+ def on_button_pressed(self, event: Button.Pressed) -> None:
+ if event.button.id == "fetch":
+ self.fetch_data("https://api.example.com/data")
+
+ # Handle worker events
+ def on_worker_state_changed(self, event: Worker.StateChanged) -> None:
+ if event.state == WorkerState.SUCCESS:
+ self.notify("Task completed!")
+```
+
+## Screens
+
+### Multiple Screens
+
+```python
+from textual.screen import Screen
+
+class HomeScreen(Screen):
+ def compose(self) -> ComposeResult:
+ yield Static("Home Screen")
+ yield Button("Go to Settings", id="to-settings")
+
+ def on_button_pressed(self, event: Button.Pressed) -> None:
+ if event.button.id == "to-settings":
+ self.app.push_screen("settings")
+
+class SettingsScreen(Screen):
+ BINDINGS = [("escape", "pop_screen", "Back")]
+
+ def compose(self) -> ComposeResult:
+ yield Static("Settings Screen")
+ yield Button("Back", id="back")
+
+ def on_button_pressed(self, event: Button.Pressed) -> None:
+ if event.button.id == "back":
+ self.app.pop_screen()
+
+class MyApp(App):
+ SCREENS = {
+ "home": HomeScreen,
+ "settings": SettingsScreen,
+ }
+
+ def on_mount(self) -> None:
+ self.push_screen("home")
+```
+
+### Modal Screens
+
+```python
+from textual.screen import ModalScreen
+
+class ConfirmDialog(ModalScreen[bool]):
+ """A modal dialog that returns True/False."""
+
+ def compose(self) -> ComposeResult:
+ yield Container(
+ Static("Are you sure?"),
+ Horizontal(
+ Button("Yes", id="yes", variant="primary"),
+ Button("No", id="no"),
+ ),
+ id="dialog",
+ )
+
+ def on_button_pressed(self, event: Button.Pressed) -> None:
+ self.dismiss(event.button.id == "yes")
+
+class MyApp(App):
+ def action_delete(self) -> None:
+ async def handle_confirm(confirmed: bool) -> None:
+ if confirmed:
+ self.notify("Deleted!")
+
+ self.push_screen(ConfirmDialog(), handle_confirm)
+```
+
+## Notifications & Logging
+
+```python
+class MyApp(App):
+ def some_action(self) -> None:
+ # Toast notification
+ self.notify("Action completed!")
+
+ # With severity
+ self.notify("Warning!", severity="warning")
+ self.notify("Error occurred!", severity="error")
+
+ # With title and timeout
+ self.notify(
+ "This is the message",
+ title="Notice",
+ timeout=5.0,
+ )
+
+ def compose(self) -> ComposeResult:
+ # RichLog for app logs
+ yield RichLog(id="log")
+
+ def log_message(self, msg: str) -> None:
+ log = self.query_one("#log", RichLog)
+ log.write(msg)
+```
+
+## Testing
+
+```python
+from textual.testing import AppTest
+
+async def test_button_press():
+ async with AppTest(MyApp()) as pilot:
+ # Click a button
+ await pilot.click("#my-button")
+
+ # Check result
+ assert pilot.app.query_one("#result").renderable == "Clicked!"
+
+async def test_input():
+ async with AppTest(MyApp()) as pilot:
+ # Type in input
+ await pilot.type("Hello, World!")
+ await pilot.press("enter")
+
+ # Check state
+ assert pilot.app.name == "Hello, World!"
+
+async def test_key_bindings():
+ async with AppTest(MyApp()) as pilot:
+ await pilot.press("q")
+ assert pilot.app.is_headless # App should quit
+```
+
+## Dev Tools
+
+```bash
+# Run with dev console
+textual run --dev my_app.py
+
+# CSS hot reloading
+textual run --dev my_app.py
+
+# Take screenshot
+textual run my_app.py --screenshot screenshot.svg
+
+# Profile performance
+textual run --profile my_app.py
+```
+
+## Resources
+
+- [Textual Docs](https://textual.textualize.io/)
+- [Textual GitHub](https://github.com/Textualize/textual)
+- [Widget Gallery](https://textual.textualize.io/widget_gallery/)
+- [CSS Reference](https://textual.textualize.io/css_types/)
diff --git a/skills/tui-builder/templates/bubbletea-starter.go b/skills/tui-builder/templates/bubbletea-starter.go
new file mode 100644
index 0000000..0503d18
--- /dev/null
+++ b/skills/tui-builder/templates/bubbletea-starter.go
@@ -0,0 +1,342 @@
+// Bubbletea TUI Starter Template
+//
+// Features:
+// - Interactive list with selection
+// - Spinner for loading states
+// - Text input form
+// - Styled output with Lipgloss
+//
+// Usage:
+// go run main.go
+
+package main
+
+import (
+ "fmt"
+ "os"
+ "strings"
+ "time"
+
+ "github.com/charmbracelet/bubbles/list"
+ "github.com/charmbracelet/bubbles/spinner"
+ "github.com/charmbracelet/bubbles/textinput"
+ tea "github.com/charmbracelet/bubbletea"
+ "github.com/charmbracelet/lipgloss"
+)
+
+// ============================================
+// Styles
+// ============================================
+
+var (
+ titleStyle = lipgloss.NewStyle().
+ Bold(true).
+ Foreground(lipgloss.Color("#FAFAFA")).
+ Background(lipgloss.Color("#7D56F4")).
+ Padding(0, 1)
+
+ boxStyle = lipgloss.NewStyle().
+ Border(lipgloss.RoundedBorder()).
+ BorderForeground(lipgloss.Color("#7D56F4")).
+ Padding(1, 2)
+
+ successStyle = lipgloss.NewStyle().
+ Foreground(lipgloss.Color("#73F59F")).
+ Bold(true)
+
+ dimStyle = lipgloss.NewStyle().
+ Foreground(lipgloss.Color("#666666"))
+)
+
+// ============================================
+// Types
+// ============================================
+
+type screen int
+
+const (
+ menuScreen screen = iota
+ formScreen
+ loadingScreen
+ resultScreen
+)
+
+type formData struct {
+ name string
+ email string
+}
+
+// Messages
+type loadingDoneMsg struct{}
+
+// ============================================
+// Model
+// ============================================
+
+type model struct {
+ screen screen
+ menuList list.Model
+ nameInput textinput.Model
+ emailInput textinput.Model
+ formStep int
+ spinner spinner.Model
+ formData formData
+ width int
+ height int
+ quitting bool
+}
+
+// List item implementation
+type menuItem struct {
+ title, desc string
+}
+
+func (i menuItem) Title() string { return i.title }
+func (i menuItem) Description() string { return i.desc }
+func (i menuItem) FilterValue() string { return i.title }
+
+func initialModel() model {
+ // Menu list
+ items := []list.Item{
+ menuItem{title: "Start New Task", desc: "Begin a new workflow"},
+ menuItem{title: "View Status", desc: "Check current progress"},
+ menuItem{title: "Settings", desc: "Configure options"},
+ menuItem{title: "Exit", desc: "Quit the application"},
+ }
+
+ l := list.New(items, list.NewDefaultDelegate(), 0, 0)
+ l.Title = "What would you like to do?"
+ l.SetShowStatusBar(false)
+ l.SetFilteringEnabled(false)
+
+ // Text inputs
+ nameInput := textinput.New()
+ nameInput.Placeholder = "John Doe"
+ nameInput.Focus()
+ nameInput.CharLimit = 50
+ nameInput.Width = 30
+
+ emailInput := textinput.New()
+ emailInput.Placeholder = "[email protected]"
+ emailInput.CharLimit = 50
+ emailInput.Width = 30
+
+ // Spinner
+ s := spinner.New()
+ s.Spinner = spinner.Dot
+ s.Style = lipgloss.NewStyle().Foreground(lipgloss.Color("205"))
+
+ return model{
+ screen: menuScreen,
+ menuList: l,
+ nameInput: nameInput,
+ emailInput: emailInput,
+ spinner: s,
+ }
+}
+
+// ============================================
+// Bubbletea Interface
+// ============================================
+
+func (m model) Init() tea.Cmd {
+ return nil
+}
+
+func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
+ switch msg := msg.(type) {
+ case tea.WindowSizeMsg:
+ m.width = msg.Width
+ m.height = msg.Height
+ m.menuList.SetSize(msg.Width-4, msg.Height-8)
+ return m, nil
+
+ case tea.KeyMsg:
+ switch msg.String() {
+ case "ctrl+c":
+ m.quitting = true
+ return m, tea.Quit
+ case "q":
+ if m.screen == menuScreen {
+ m.quitting = true
+ return m, tea.Quit
+ }
+ case "esc":
+ if m.screen != menuScreen {
+ m.screen = menuScreen
+ return m, nil
+ }
+ }
+
+ case loadingDoneMsg:
+ m.screen = resultScreen
+ return m, nil
+
+ case spinner.TickMsg:
+ if m.screen == loadingScreen {
+ var cmd tea.Cmd
+ m.spinner, cmd = m.spinner.Update(msg)
+ return m, cmd
+ }
+ }
+
+ // Route to screen-specific update
+ switch m.screen {
+ case menuScreen:
+ return m.updateMenu(msg)
+ case formScreen:
+ return m.updateForm(msg)
+ case resultScreen:
+ return m.updateResult(msg)
+ }
+
+ return m, nil
+}
+
+func (m model) updateMenu(msg tea.Msg) (tea.Model, tea.Cmd) {
+ switch msg := msg.(type) {
+ case tea.KeyMsg:
+ if msg.String() == "enter" {
+ i, ok := m.menuList.SelectedItem().(menuItem)
+ if ok {
+ switch i.title {
+ case "Start New Task":
+ m.screen = formScreen
+ m.formStep = 0
+ m.nameInput.Focus()
+ return m, textinput.Blink
+ case "View Status":
+ m.screen = loadingScreen
+ return m, tea.Batch(m.spinner.Tick, simulateLoading())
+ case "Exit":
+ m.quitting = true
+ return m, tea.Quit
+ }
+ }
+ }
+ }
+
+ var cmd tea.Cmd
+ m.menuList, cmd = m.menuList.Update(msg)
+ return m, cmd
+}
+
+func (m model) updateForm(msg tea.Msg) (tea.Model, tea.Cmd) {
+ switch msg := msg.(type) {
+ case tea.KeyMsg:
+ if msg.String() == "enter" {
+ if m.formStep == 0 {
+ m.formData.name = m.nameInput.Value()
+ m.formStep = 1
+ m.nameInput.Blur()
+ m.emailInput.Focus()
+ return m, textinput.Blink
+ } else {
+ m.formData.email = m.emailInput.Value()
+ m.screen = loadingScreen
+ return m, tea.Batch(m.spinner.Tick, simulateLoading())
+ }
+ }
+ }
+
+ var cmd tea.Cmd
+ if m.formStep == 0 {
+ m.nameInput, cmd = m.nameInput.Update(msg)
+ } else {
+ m.emailInput, cmd = m.emailInput.Update(msg)
+ }
+ return m, cmd
+}
+
+func (m model) updateResult(msg tea.Msg) (tea.Model, tea.Cmd) {
+ switch msg := msg.(type) {
+ case tea.KeyMsg:
+ if msg.String() == "b" || msg.String() == "enter" {
+ m.screen = menuScreen
+ m.nameInput.Reset()
+ m.emailInput.Reset()
+ return m, nil
+ }
+ }
+ return m, nil
+}
+
+func (m model) View() string {
+ if m.quitting {
+ return "Goodbye!\n"
+ }
+
+ var content string
+
+ switch m.screen {
+ case menuScreen:
+ content = m.menuList.View()
+ case formScreen:
+ content = m.viewForm()
+ case loadingScreen:
+ content = m.viewLoading()
+ case resultScreen:
+ content = m.viewResult()
+ }
+
+ title := titleStyle.Render("My TUI App")
+ footer := dimStyle.Render("Press q to quit, esc to go back")
+
+ return fmt.Sprintf("%s\n\n%s\n\n%s", title, content, footer)
+}
+
+func (m model) viewForm() string {
+ var b strings.Builder
+
+ if m.formStep == 0 {
+ b.WriteString("Enter your name:\n\n")
+ b.WriteString(m.nameInput.View())
+ } else {
+ b.WriteString("Enter your email:\n\n")
+ b.WriteString(m.emailInput.View())
+ }
+
+ b.WriteString(fmt.Sprintf("\n\n%s", dimStyle.Render(fmt.Sprintf("Step %d of 2", m.formStep+1))))
+
+ return boxStyle.Render(b.String())
+}
+
+func (m model) viewLoading() string {
+ return boxStyle.Render(fmt.Sprintf("%s Processing...", m.spinner.View()))
+}
+
+func (m model) viewResult() string {
+ var b strings.Builder
+
+ b.WriteString(successStyle.Render("✓ Task Complete!"))
+ b.WriteString("\n\n")
+ b.WriteString(fmt.Sprintf("Name: %s\n", m.formData.name))
+ b.WriteString(fmt.Sprintf("Email: %s\n", m.formData.email))
+ b.WriteString("\n")
+ b.WriteString(dimStyle.Render("Press 'b' to go back"))
+
+ return boxStyle.Render(b.String())
+}
+
+// ============================================
+// Commands
+// ============================================
+
+func simulateLoading() tea.Cmd {
+ return func() tea.Msg {
+ time.Sleep(2 * time.Second)
+ return loadingDoneMsg{}
+ }
+}
+
+// ============================================
+// Main
+// ============================================
+
+func main() {
+ p := tea.NewProgram(initialModel(), tea.WithAltScreen())
+ if _, err := p.Run(); err != nil {
+ fmt.Printf("Error: %v", err)
+ os.Exit(1)
+ }
+}
diff --git a/skills/tui-builder/templates/ink-starter.tsx b/skills/tui-builder/templates/ink-starter.tsx
new file mode 100644
index 0000000..9c0b117
--- /dev/null
+++ b/skills/tui-builder/templates/ink-starter.tsx
@@ -0,0 +1,227 @@
+#!/usr/bin/env node
+/**
+ * Ink TUI Starter Template
+ *
+ * Features:
+ * - Interactive menu
+ * - Progress indicator
+ * - Form input
+ * - Keyboard navigation
+ *
+ * Usage:
+ * npx tsx src/cli.tsx
+ */
+
+import React, { useState, useEffect } from 'react';
+import { render, Box, Text, useInput, useApp } from 'ink';
+import Spinner from 'ink-spinner';
+import SelectInput from 'ink-select-input';
+import TextInput from 'ink-text-input';
+
+// ============================================
+// Types
+// ============================================
+
+type Screen = 'menu' | 'form' | 'progress' | 'result';
+
+interface FormData {
+ name: string;
+ email: string;
+}
+
+// ============================================
+// Components
+// ============================================
+
+const Header = ({ title }: { title: string }) => (
+ <Box borderStyle="round" borderColor="cyan" paddingX={2}>
+ <Text bold color="cyan">{title}</Text>
+ </Box>
+);
+
+const Footer = () => (
+ <Box marginTop={1}>
+ <Text dimColor>↑/↓: Navigate | Enter: Select | q: Quit</Text>
+ </Box>
+);
+
+const Menu = ({ onSelect }: { onSelect: (value: string) => void }) => {
+ const items = [
+ { label: 'Start New Task', value: 'new' },
+ { label: 'View Status', value: 'status' },
+ { label: 'Settings', value: 'settings' },
+ { label: 'Exit', value: 'exit' },
+ ];
+
+ return (
+ <Box flexDirection="column" paddingY={1}>
+ <Text bold marginBottom={1}>What would you like to do?</Text>
+ <SelectInput items={items} onSelect={(item) => onSelect(item.value)} />
+ </Box>
+ );
+};
+
+const Form = ({ onSubmit }: { onSubmit: (data: FormData) => void }) => {
+ const [step, setStep] = useState(0);
+ const [data, setData] = useState<FormData>({ name: '', email: '' });
+
+ const handleSubmit = (value: string) => {
+ if (step === 0) {
+ setData({ ...data, name: value });
+ setStep(1);
+ } else {
+ onSubmit({ ...data, email: value });
+ }
+ };
+
+ return (
+ <Box flexDirection="column" paddingY={1}>
+ <Text bold marginBottom={1}>
+ {step === 0 ? 'Enter your name:' : 'Enter your email:'}
+ </Text>
+ <Box>
+ <Text color="green">&gt; </Text>
+ <TextInput
+ value={step === 0 ? data.name : data.email}
+ onChange={(value) =>
+ setData(step === 0 ? { ...data, name: value } : { ...data, email: value })
+ }
+ onSubmit={handleSubmit}
+ placeholder={step === 0 ? 'John Doe' : '[email protected]'}
+ />
+ </Box>
+ <Text dimColor marginTop={1}>
+ Step {step + 1} of 2
+ </Text>
+ </Box>
+ );
+};
+
+const Progress = ({ onComplete }: { onComplete: () => void }) => {
+ const [progress, setProgress] = useState(0);
+ const [status, setStatus] = useState('Initializing...');
+
+ useEffect(() => {
+ const statuses = [
+ 'Initializing...',
+ 'Connecting to server...',
+ 'Processing data...',
+ 'Finalizing...',
+ 'Complete!',
+ ];
+
+ const interval = setInterval(() => {
+ setProgress((p) => {
+ const next = p + 20;
+ setStatus(statuses[Math.floor(next / 25)] || 'Complete!');
+ if (next >= 100) {
+ clearInterval(interval);
+ setTimeout(onComplete, 500);
+ return 100;
+ }
+ return next;
+ });
+ }, 500);
+
+ return () => clearInterval(interval);
+ }, [onComplete]);
+
+ const width = 30;
+ const filled = Math.round((progress / 100) * width);
+
+ return (
+ <Box flexDirection="column" paddingY={1}>
+ <Box>
+ {progress < 100 && <Spinner type="dots" />}
+ {progress === 100 && <Text color="green">✓</Text>}
+ <Text> {status}</Text>
+ </Box>
+ <Box marginTop={1}>
+ <Text color="green">{'█'.repeat(filled)}</Text>
+ <Text color="gray">{'░'.repeat(width - filled)}</Text>
+ <Text> {progress}%</Text>
+ </Box>
+ </Box>
+ );
+};
+
+const Result = ({ data, onBack }: { data: FormData; onBack: () => void }) => {
+ useInput((input) => {
+ if (input === 'b' || input === 'q') {
+ onBack();
+ }
+ });
+
+ return (
+ <Box flexDirection="column" paddingY={1}>
+ <Text bold color="green">✓ Task Complete!</Text>
+ <Box marginTop={1} flexDirection="column">
+ <Text>Name: {data.name}</Text>
+ <Text>Email: {data.email}</Text>
+ </Box>
+ <Text dimColor marginTop={1}>Press 'b' to go back</Text>
+ </Box>
+ );
+};
+
+// ============================================
+// Main App
+// ============================================
+
+const App = () => {
+ const { exit } = useApp();
+ const [screen, setScreen] = useState<Screen>('menu');
+ const [formData, setFormData] = useState<FormData>({ name: '', email: '' });
+
+ useInput((input) => {
+ if (input === 'q' && screen === 'menu') {
+ exit();
+ }
+ });
+
+ const handleMenuSelect = (value: string) => {
+ switch (value) {
+ case 'new':
+ setScreen('form');
+ break;
+ case 'status':
+ setScreen('progress');
+ break;
+ case 'exit':
+ exit();
+ break;
+ }
+ };
+
+ const handleFormSubmit = (data: FormData) => {
+ setFormData(data);
+ setScreen('progress');
+ };
+
+ const handleProgressComplete = () => {
+ setScreen('result');
+ };
+
+ const handleBack = () => {
+ setScreen('menu');
+ };
+
+ return (
+ <Box flexDirection="column" padding={1}>
+ <Header title="My TUI App" />
+
+ {screen === 'menu' && <Menu onSelect={handleMenuSelect} />}
+ {screen === 'form' && <Form onSubmit={handleFormSubmit} />}
+ {screen === 'progress' && <Progress onComplete={handleProgressComplete} />}
+ {screen === 'result' && <Result data={formData} onBack={handleBack} />}
+
+ {screen === 'menu' && <Footer />}
+ </Box>
+ );
+};
+
+// ============================================
+// Entry Point
+// ============================================
+
+render(<App />);
diff --git a/skills/tui-builder/templates/textual-starter.py b/skills/tui-builder/templates/textual-starter.py
new file mode 100644
index 0000000..f0de03c
--- /dev/null
+++ b/skills/tui-builder/templates/textual-starter.py
@@ -0,0 +1,358 @@
+#!/usr/bin/env python3
+"""
+Textual TUI Starter Template
+
+Features:
+- Multi-screen navigation
+- Data table display
+- Form input
+- Progress indicators
+- Modal dialogs
+
+Usage:
+ python src/app.py
+"""
+
+from textual.app import App, ComposeResult
+from textual.containers import Container, Horizontal, Vertical
+from textual.screen import Screen, ModalScreen
+from textual.widgets import (
+ Header,
+ Footer,
+ Static,
+ Button,
+ Input,
+ Label,
+ DataTable,
+ ProgressBar,
+ LoadingIndicator,
+)
+from textual.binding import Binding
+from textual import work
+import asyncio
+
+
+# ============================================
+# Styles
+# ============================================
+
+CSS = """
+Screen {
+ background: $surface;
+}
+
+#main-menu {
+ layout: vertical;
+ padding: 2;
+ width: 100%;
+ height: auto;
+}
+
+.menu-button {
+ width: 100%;
+ margin: 1 0;
+}
+
+#form-container {
+ layout: vertical;
+ padding: 2;
+ border: solid $primary;
+ width: 60;
+ height: auto;
+ margin: 2 auto;
+}
+
+.form-field {
+ margin: 1 0;
+}
+
+.form-label {
+ margin-bottom: 1;
+}
+
+#progress-container {
+ layout: vertical;
+ padding: 2;
+ width: 60;
+ height: auto;
+ margin: 2 auto;
+ align: center middle;
+}
+
+#result-container {
+ layout: vertical;
+ padding: 2;
+ border: solid $success;
+ width: 60;
+ height: auto;
+ margin: 2 auto;
+}
+
+.success-text {
+ color: $success;
+ text-style: bold;
+}
+
+ConfirmDialog {
+ align: center middle;
+}
+
+#dialog-container {
+ width: 50;
+ height: auto;
+ border: solid $primary;
+ background: $surface;
+ padding: 2;
+}
+
+#dialog-buttons {
+ margin-top: 2;
+ align: center middle;
+}
+
+#dialog-buttons Button {
+ margin: 0 1;
+}
+"""
+
+
+# ============================================
+# Screens
+# ============================================
+
+class MenuScreen(Screen):
+ """Main menu screen."""
+
+ BINDINGS = [
+ Binding("q", "quit", "Quit"),
+ ]
+
+ def compose(self) -> ComposeResult:
+ yield Header()
+ yield Container(
+ Static("What would you like to do?", classes="form-label"),
+ Button("Start New Task", id="btn-new", classes="menu-button"),
+ Button("View Data", id="btn-data", classes="menu-button"),
+ Button("Settings", id="btn-settings", classes="menu-button"),
+ Button("Exit", id="btn-exit", classes="menu-button", variant="error"),
+ id="main-menu",
+ )
+ yield Footer()
+
+ def on_button_pressed(self, event: Button.Pressed) -> None:
+ if event.button.id == "btn-new":
+ self.app.push_screen("form")
+ elif event.button.id == "btn-data":
+ self.app.push_screen("data")
+ elif event.button.id == "btn-exit":
+ self.app.push_screen(ConfirmDialog("Are you sure you want to exit?"), self.handle_exit)
+
+ def handle_exit(self, confirmed: bool) -> None:
+ if confirmed:
+ self.app.exit()
+
+
+class FormScreen(Screen):
+ """Form input screen."""
+
+ BINDINGS = [
+ Binding("escape", "go_back", "Back"),
+ ]
+
+ def compose(self) -> ComposeResult:
+ yield Header()
+ yield Container(
+ Static("Enter your details:", classes="form-label"),
+ Container(
+ Label("Name:"),
+ Input(placeholder="John Doe", id="input-name"),
+ classes="form-field",
+ ),
+ Container(
+ Label("Email:"),
+ Input(placeholder="[email protected]", id="input-email"),
+ classes="form-field",
+ ),
+ Horizontal(
+ Button("Cancel", id="btn-cancel"),
+ Button("Submit", id="btn-submit", variant="primary"),
+ ),
+ id="form-container",
+ )
+ yield Footer()
+
+ def on_button_pressed(self, event: Button.Pressed) -> None:
+ if event.button.id == "btn-cancel":
+ self.app.pop_screen()
+ elif event.button.id == "btn-submit":
+ name = self.query_one("#input-name", Input).value
+ email = self.query_one("#input-email", Input).value
+ if name and email:
+ self.app.form_data = {"name": name, "email": email}
+ self.app.push_screen("progress")
+ else:
+ self.notify("Please fill in all fields", severity="warning")
+
+ def action_go_back(self) -> None:
+ self.app.pop_screen()
+
+
+class ProgressScreen(Screen):
+ """Progress/loading screen."""
+
+ def compose(self) -> ComposeResult:
+ yield Header()
+ yield Container(
+ LoadingIndicator(),
+ Static("Processing...", id="progress-status"),
+ ProgressBar(id="progress-bar", total=100),
+ id="progress-container",
+ )
+ yield Footer()
+
+ def on_mount(self) -> None:
+ self.run_task()
+
+ @work(exclusive=True)
+ async def run_task(self) -> None:
+ """Simulate a long-running task."""
+ progress_bar = self.query_one("#progress-bar", ProgressBar)
+ status = self.query_one("#progress-status", Static)
+
+ steps = [
+ (20, "Connecting..."),
+ (40, "Fetching data..."),
+ (60, "Processing..."),
+ (80, "Validating..."),
+ (100, "Complete!"),
+ ]
+
+ for progress, text in steps:
+ await asyncio.sleep(0.5)
+ progress_bar.update(progress=progress)
+ status.update(text)
+
+ await asyncio.sleep(0.5)
+ self.app.switch_screen("result")
+
+
+class DataScreen(Screen):
+ """Data table screen."""
+
+ BINDINGS = [
+ Binding("escape", "go_back", "Back"),
+ ]
+
+ def compose(self) -> ComposeResult:
+ yield Header()
+ yield DataTable(id="data-table")
+ yield Footer()
+
+ def on_mount(self) -> None:
+ table = self.query_one("#data-table", DataTable)
+ table.add_columns("ID", "Name", "Status", "Created")
+ table.add_rows([
+ ("1", "Project Alpha", "Active", "2024-01-15"),
+ ("2", "Project Beta", "Pending", "2024-01-10"),
+ ("3", "Project Gamma", "Complete", "2024-01-05"),
+ ("4", "Project Delta", "Active", "2024-01-01"),
+ ])
+
+ def action_go_back(self) -> None:
+ self.app.pop_screen()
+
+
+class ResultScreen(Screen):
+ """Result/success screen."""
+
+ BINDINGS = [
+ Binding("b", "go_back", "Back to Menu"),
+ ]
+
+ def compose(self) -> ComposeResult:
+ yield Header()
+ yield Container(
+ Static("✓ Task Complete!", classes="success-text"),
+ Static(id="result-name"),
+ Static(id="result-email"),
+ Button("Back to Menu", id="btn-back"),
+ id="result-container",
+ )
+ yield Footer()
+
+ def on_mount(self) -> None:
+ data = getattr(self.app, "form_data", {})
+ self.query_one("#result-name", Static).update(f"Name: {data.get('name', 'N/A')}")
+ self.query_one("#result-email", Static).update(f"Email: {data.get('email', 'N/A')}")
+
+ def on_button_pressed(self, event: Button.Pressed) -> None:
+ if event.button.id == "btn-back":
+ self.app.switch_screen("menu")
+
+ def action_go_back(self) -> None:
+ self.app.switch_screen("menu")
+
+
+class ConfirmDialog(ModalScreen[bool]):
+ """A modal confirmation dialog."""
+
+ def __init__(self, message: str) -> None:
+ super().__init__()
+ self.message = message
+
+ def compose(self) -> ComposeResult:
+ yield Container(
+ Static(self.message),
+ Horizontal(
+ Button("Cancel", id="btn-cancel"),
+ Button("Confirm", id="btn-confirm", variant="primary"),
+ id="dialog-buttons",
+ ),
+ id="dialog-container",
+ )
+
+ def on_button_pressed(self, event: Button.Pressed) -> None:
+ self.dismiss(event.button.id == "btn-confirm")
+
+
+# ============================================
+# Main App
+# ============================================
+
+class MyApp(App):
+ """Main application."""
+
+ CSS = CSS
+ TITLE = "My TUI App"
+
+ SCREENS = {
+ "menu": MenuScreen,
+ "form": FormScreen,
+ "progress": ProgressScreen,
+ "data": DataScreen,
+ "result": ResultScreen,
+ }
+
+ BINDINGS = [
+ Binding("ctrl+c", "quit", "Quit", show=False),
+ Binding("d", "toggle_dark", "Toggle Dark Mode"),
+ ]
+
+ def __init__(self) -> None:
+ super().__init__()
+ self.form_data: dict = {}
+
+ def on_mount(self) -> None:
+ self.push_screen("menu")
+
+ def action_toggle_dark(self) -> None:
+ self.dark = not self.dark
+
+
+# ============================================
+# Entry Point
+# ============================================
+
+if __name__ == "__main__":
+ app = MyApp()
+ app.run()