Shell
chore: Update skills-manifest to v3.0.0 with full inventory
Eddie Belaval6a45f7f2755e
diff --git a/skills-manifest.json b/skills-manifest.jsonindex 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.mdnew file mode 100644index 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 gallerydiff --git a/skills/tui-builder/reference/bubbletea.md b/skills/tui-builder/reference/bubbletea.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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 terminalsdiff --git a/skills/tui-builder/reference/ink.md b/skills/tui-builder/reference/ink.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.gonew file mode 100644index 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.tsxnew file mode 100644index 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">> </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.pynew file mode 100644index 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()