builder-skill-uvscript

--- ## Quick Reference (30 seconds) **Unified UV CLI Scripts Collection** **What It Does**: Consolidated collection of 23 UV CLI scripts with unified `builder-skill_` prefix following IndieDevDan patterns for system analysis, code generation, development tools, documentation, and automation. **Core Capabilities**: - 🔍 **System Analysis**: 12 scripts for CPU, memory, disk, network, battery, thermal analysis - 🏗️ **Code Generation**: 4 scripts for agent, skill, command, and test scaffolding - 🛠️ **Development Tools**: 2 scripts for debugging and performance analysis - 📚 **Documentation**: 2 scripts for linting and diagram validation - ⚙️ **BaaS Integration**: 2 scripts for provider selection and migration - 📝 **Template Tools**: 1 script for template generation **Progressive Disclosure Workflow**: ``` User Request → SKILL.md (200 tokens) → Script --help (0 tokens) → Execute ↓ ↓ ↓ ↓ Dormant Quick Check Full Documentation Implementation ``` **When to Use**: - System resource analysis and optimization - Code generation and scaffolding - Development workflow automation - Documentation validation - BaaS provider management - Template generation --- ## Script Categories ### 1. System Analysis (12 scripts) All system analysis scripts follow PEP 723 format with embedded dependencies. **Usage Pattern**: ```bash # Analyze specific resource uv run .claude/skills/builder-skill-uvscript/scripts/builder-skill_analyze_cpu.py # Analyze all resources uv run .claude/skills/builder-skill-uvscript/scripts/builder-skill_analyze_all.py # Generate comprehensive report uv run .claude/skills/builder-skill-uvscript/scripts/builder-skill_generate_report.py --format=markdown ``` **Scripts**: - `builder-skill_analyze_all.py` - Analyze all system resources - `builder-skill_analyze_battery.py` - Battery status and power analysis - `builder-skill_analyze_cpu.py` - CPU usage and performance - `builder-skill_analyze_disk.py` - Disk I/O and storage - `builder-skill_analyze_memory.py` - Memory usage and optimization - `builder-skill_analyze_network.py` - Network bandwidth and connections - `builder-skill_analyze_thermal.py` - Thermal management and cooling - `builder-skill_cache_management.py` - Cache and temporary file management - `builder-skill_monitor_resources.py` - Continuous resource monitoring - `builder-skill_optimize_system.py` - System performance optimization - `builder-skill_generate_report.py` - Comprehensive system reports - `builder-skill_check_status.py` - System status and health checks --- ### 2. Code Generation (4 scripts) AI-powered code scaffolding with Context7 integration and TRUST 5 validation. **Usage Pattern**: ```bash # Generate agent uv run .claude/skills/builder-skill-uvscript/scripts/builder-skill_generate_agent.py \ --name expert-api --description "API specialist" # Generate skill uv run .claude/skills/builder-skill-uvscript/scripts/builder-skill_generate_skill.py \ --name moai-connector-rest --description "REST API toolkit" # Generate command uv run .claude/skills/builder-skill-uvscript/scripts/builder-skill_generate_command.py \ --name analyze-performance --description "Performance analysis" # Generate tests uv run .claude/skills/builder-skill-uvscript/scripts/builder-skill_scaffold_test.py \ --source src/user.py --framework pytest ``` **Scripts**: - `builder-skill_generate_agent.py` - Generate MoAI agent YAML with frontmatter - `builder-skill_generate_command.py` - Generate slash command files - `builder-skill_generate_skill.py` - Generate skill with SKILL.md and scripts - `builder-skill_scaffold_test.py` - Generate test files from existing code --- ### 3. Development Tools (2 scripts) AI-powered debugging and performance analysis. **Usage Pattern**: ```bash # Debug helper uv run .claude/skills/builder-skill-uvscript/scripts/builder-skill_debug_code.py \ --error "AttributeError: 'NoneType' object has no attribute 'name'" # Performance analyzer uv run .claude/skills/builder-skill-uvscript/scripts/builder-skill_analyze_performance.py \ --profile output.prof --threshold 1.0 ``` **Scripts**: - `builder-skill_debug_code.py` - AI-powered debug helper with error pattern recognition - `builder-skill_analyze_performance.py` - AI-powered performance analyzer with bottleneck detection --- ### 4. BaaS Integration (2 scripts) Backend-as-a-Service provider selection and migration. **Usage Pattern**: ```bash # Select provider uv run .claude/skills/builder-skill-uvscript/scripts/builder-skill_select_provider.py \ --requirements auth,database,storage # Migrate provider uv run .claude/skills/builder-skill-uvscript/scripts/builder-skill_migrate_provider.py \ --from firebase --to supabase ``` **Scripts**: - `builder-skill_select_provider.py` - Select optimal BaaS provider based on requirements - `builder-skill_migrate_provider.py` - Migrate between BaaS providers with data preservation --- ### 5. Documentation (2 scripts) Documentation validation and quality assurance. **Usage Pattern**: ```bash # Lint Korean docs uv run .claude/skills/builder-skill-uvscript/scripts/builder-skill_lint_docs.py \ --path .moai/docs/ # Validate Mermaid diagrams uv run .claude/skills/builder-skill-uvscript/scripts/builder-skill_validate_diagrams.py \ --path .moai/docs/ ``` **Scripts**: - `builder-skill_lint_docs.py` - Lint Korean documentation for quality and consistency - `builder-skill_validate_diagrams.py` - Validate Mermaid diagrams for syntax and rendering --- ### 6. Template Tools (1 script) Project template generation and management. **Usage Pattern**: ```bash # Generate template uv run .claude/skills/builder-skill-uvscript/scripts/builder-skill_generate_template.py \ --type nextjs --features "auth,database,api" ``` **Scripts**: - `builder-skill_generate_template.py` - Generate project templates with best practices --- ## Architecture **Design Principles**: - **Self-Contained Scripts**: Each script is 200-300 lines with embedded dependencies (PEP 723) - **Progressive Disclosure**: Scripts dormant at 0 tokens until invoked - **Dual Output**: Human-readable (default) + JSON mode (--json flag) - **MCP-Wrappable**: Stateless, JSON output, no interactive prompts - **Unified Naming**: `builder-skill_` prefix for all scripts - **Zero Context**: Most scripts require no context loading (23/23 zero_context: true/false) **Integration Points**: - **expert-backend**: Backend code generation - **expert-frontend**: Frontend component generation - **manager-tdd**: Test generation workflow - **builder-agent**: Agent creation patterns - **builder-skill**: Skill structure patterns - **builder-command**: Command file patterns - **macos-resource-optimizer**: System analysis and optimization --- ## IndieDevDan Pattern Compliance All 23 scripts follow **13 IndieDevDan rules** documented in `builder-workflow.md`: ✅ Size Constraints: 200-300 lines target (max 500) ✅ ASTRAL UV: PEP 723 `# /// script` dependency blocks ✅ Directory Organization: Flat `scripts/` directory ✅ Self-Containment: Embedded HTTP clients, no shared imports ✅ CLI Interface: Click framework, --help, --json flags ✅ Structure: 9-section template (Shebang, Docstring, Imports, Constants, Project Root, Data Models, Core Logic, Formatters, CLI, Entry Point) ✅ Dependency Management: 0-3 packages, minimum version pinning ✅ Documentation: Google-style docstrings, comprehensive --help ✅ Testing: Basic unit tests (5-10 per script) ✅ Single-File: No multi-file dependencies ✅ Error Handling: Dual-mode errors (human + JSON) ✅ Configuration: Environment variables, no hardcoded secrets ✅ Progressive Disclosure: 0-token dormant, SKILL.md listing --- ## Migration History **Consolidation Date**: 2025-11-30 **Previous Locations** (deprecated): - `macos-resource-optimizer/scripts/` (12 scripts) → Moved to builder-skill-uvscript - `moai-platform-baas/scripts/` (2 scripts) → Moved to builder-skill-uvscript - `moai-toolkit-codegen/scripts/` (4 scripts) → Moved to builder-skill-uvscript - `moai-toolkit-essentials/scripts/` (2 scripts) → Moved to builder-skill-uvscript - `moai-workflow-docs/scripts/` (2 scripts) → Moved to builder-skill-uvscript - `moai-workflow-templates/scripts/` (1 script) → Moved to builder-skill-uvscript **Backward Compatibility**: Old skill folders maintain skill functionality with deprecation notices pointing to builder-skill-uvscript. --- ## Quick Start ```bash # 1. Analyze system resources uv run .claude/skills/builder-skill-uvscript/scripts/builder-skill_analyze_all.py # 2. Generate a new agent uv run .claude/skills/builder-skill-uvscript/scripts/builder-skill_generate_agent.py \ --name expert-api --description "API specialist" # 3. Generate a new skill uv run .claude/skills/builder-skill-uvscript/scripts/builder-skill_generate_skill.py \ --name moai-connector-rest --description "REST API toolkit" # 4. Debug code uv run .claude/skills/builder-skill-uvscript/scripts/builder-skill_debug_code.py \ --error "TypeError: unsupported operand type(s)" # 5. Generate comprehensive report uv run .claude/skills/builder-skill-uvscript/scripts/builder-skill_generate_report.py \ --format=markdown --output=.moai/reports/ ``` --- **Version**: 1.0.0 **Status**: ✅ Active (Consolidated) **Scripts**: 23 total (all MCP-ready, all PEP 723 compliant) **Naming Convention**: `builder-skill_` prefix + 2 descriptive words **Last Updated**: 2025-11-30