Claude-skill-registry builder-skill-uvscript

Unified UV CLI scripts collection with builder-skill_ prefix following IndieDevDan patterns for system analysis, code generation, development tools, and automation

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/builder-skill" ~/.claude/skills/majiayu000-claude-skill-registry-builder-skill-uvscript-e86e1c && rm -rf "$T"

manifest: skills/data/builder-skill/SKILL.md

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:

# 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:

# 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:

# 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:

# 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:

# 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:

# 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

# 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