openclacky 0.7.2 → 0.7.4

data/lib/clacky/default_skills/new/scripts/rails_env_checker.sh

@@ -0,0 +1,389 @@
+#!/bin/bash
+# Rails Environment Checker
+# This script checks and installs required dependencies for Rails 7.x projects
+# Run this BEFORE executing bin/setup in a Rails project
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Print colored messages
+print_info() {
+    echo -e "${BLUE}ℹ${NC} $1"
+}
+
+print_success() {
+    echo -e "${GREEN}✓${NC} $1"
+}
+
+print_warning() {
+    echo -e "${YELLOW}⚠${NC} $1"
+}
+
+print_error() {
+    echo -e "${RED}✗${NC} $1"
+}
+
+print_step() {
+    echo -e "\n${BLUE}==>${NC} $1"
+}
+
+# Detect OS
+detect_os() {
+    case "$(uname -s)" in
+        Linux*)     OS=Linux;;
+        Darwin*)    OS=macOS;;
+        CYGWIN*)    OS=Windows;;
+        MINGW*)     OS=Windows;;
+        *)          OS=Unknown;;
+    esac
+    print_info "Detected OS: $OS"
+
+    # Detect Linux distribution
+    if [ "$OS" = "Linux" ]; then
+        if [ -f /etc/os-release ]; then
+            . /etc/os-release
+            DISTRO=$ID
+            print_info "Detected Linux distribution: $DISTRO"
+        else
+            DISTRO=unknown
+        fi
+    fi
+}
+
+# Check if command exists
+command_exists() {
+    command -v "$1" >/dev/null 2>&1
+}
+
+# Compare version strings
+version_ge() {
+    # Returns 0 (true) if $1 >= $2
+    printf '%s\n%s\n' "$2" "$1" | sort -V -C
+}
+
+# Check Node.js version
+check_nodejs() {
+    if command_exists node; then
+        NODE_VERSION=$(node -v | sed 's/v//')
+        print_info "Found Node.js version: $NODE_VERSION"
+
+        if version_ge "$NODE_VERSION" "22.0.0"; then
+            print_success "Node.js version is compatible (>= 22.0.0)"
+            return 0
+        else
+            print_warning "Node.js version $NODE_VERSION is too old (need >= 22.0.0)"
+            return 1
+        fi
+    else
+        print_warning "Node.js is not installed"
+        return 1
+    fi
+}
+
+# Check PostgreSQL
+check_postgresql() {
+    if command_exists psql; then
+        PG_VERSION=$(psql --version | awk '{print $3}')
+        print_info "Found PostgreSQL version: $PG_VERSION"
+        print_success "PostgreSQL is installed"
+        
+        # Check if postgres user exists
+        if command_exists createuser; then
+            print_info "Checking PostgreSQL user 'postgres'..."
+            if psql -U postgres -c '\q' 2>/dev/null; then
+                print_success "PostgreSQL user 'postgres' exists"
+            else
+                print_warning "PostgreSQL user 'postgres' does not exist"
+                print_info "You may need to create it with: createuser -s postgres"
+            fi
+        fi
+        return 0
+    else
+        print_warning "PostgreSQL is not installed"
+        return 1
+    fi
+}
+
+# Check Ruby version
+check_ruby() {
+    if command_exists ruby; then
+        RUBY_VERSION=$(ruby -e 'puts RUBY_VERSION' 2>/dev/null)
+        print_info "Found Ruby version: $RUBY_VERSION"
+
+        if version_ge "$RUBY_VERSION" "3.0.0"; then
+            print_success "Ruby version is compatible (>= 3.0.0)"
+            return 0
+        else
+            print_warning "Ruby version $RUBY_VERSION is too old (need >= 3.0.0)"
+            return 1
+        fi
+    else
+        print_warning "Ruby is not installed"
+        return 1
+    fi
+}
+
+# Install Node.js on macOS
+install_nodejs_macos() {
+    print_step "Installing Node.js on macOS..."
+    
+    if ! command_exists brew; then
+        print_error "Homebrew is not installed. Please install Homebrew first:"
+        echo "  /bin/bash -c \"\$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\""
+        return 1
+    fi
+
+    print_info "Installing Node.js via Homebrew..."
+    if brew install node@22; then
+        print_success "Node.js 22 installed successfully"
+        # Add to PATH
+        echo 'export PATH="/opt/homebrew/opt/node@22/bin:$PATH"' >> ~/.zshrc
+        export PATH="/opt/homebrew/opt/node@22/bin:$PATH"
+        return 0
+    else
+        print_error "Failed to install Node.js"
+        return 1
+    fi
+}
+
+# Install Node.js on Ubuntu/Debian
+install_nodejs_ubuntu() {
+    print_step "Installing Node.js on Ubuntu/Debian..."
+    
+    print_info "Setting up NodeSource repository for Node.js 22..."
+    if curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -; then
+        print_success "NodeSource repository added"
+    else
+        print_error "Failed to setup NodeSource repository"
+        return 1
+    fi
+
+    print_info "Installing Node.js..."
+    if sudo apt-get install -y nodejs; then
+        print_success "Node.js installed successfully"
+        return 0
+    else
+        print_error "Failed to install Node.js"
+        return 1
+    fi
+}
+
+# Install PostgreSQL on macOS
+install_postgresql_macos() {
+    print_step "Installing PostgreSQL on macOS..."
+    
+    if ! command_exists brew; then
+        print_error "Homebrew is not installed. Please install Homebrew first:"
+        echo "  /bin/bash -c \"\$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\""
+        return 1
+    fi
+
+    print_info "Installing PostgreSQL via Homebrew..."
+    if brew install postgresql@16; then
+        print_success "PostgreSQL installed successfully"
+        
+        # Start PostgreSQL service
+        print_info "Starting PostgreSQL service..."
+        brew services start postgresql@16
+        
+        # Wait for PostgreSQL to start
+        sleep 2
+        
+        # Create postgres user if needed
+        print_info "Creating PostgreSQL user 'postgres'..."
+        if createuser -s postgres 2>/dev/null; then
+            print_success "PostgreSQL user 'postgres' created"
+        else
+            print_info "PostgreSQL user 'postgres' may already exist"
+        fi
+        
+        return 0
+    else
+        print_error "Failed to install PostgreSQL"
+        return 1
+    fi
+}
+
+# Install PostgreSQL on Ubuntu/Debian
+install_postgresql_ubuntu() {
+    print_step "Installing PostgreSQL on Ubuntu/Debian..."
+    
+    print_info "Installing PostgreSQL..."
+    if sudo apt-get install -y postgresql postgresql-contrib libpq-dev; then
+        print_success "PostgreSQL installed successfully"
+        
+        # Start PostgreSQL service
+        print_info "Starting PostgreSQL service..."
+        sudo systemctl start postgresql
+        sudo systemctl enable postgresql
+        
+        # Create postgres superuser
+        print_info "Setting up PostgreSQL user 'postgres'..."
+        sudo -u postgres psql -c "ALTER USER postgres WITH PASSWORD 'postgres';" 2>/dev/null || true
+        
+        return 0
+    else
+        print_error "Failed to install PostgreSQL"
+        return 1
+    fi
+}
+
+# Suggest installation for Node.js
+suggest_nodejs_installation() {
+    print_step "Node.js Installation Required - Installing automatically..."
+    echo ""
+    
+    if [ "$OS" = "macOS" ]; then
+        install_nodejs_macos
+        return $?
+    elif [ "$OS" = "Linux" ]; then
+        if [ "$DISTRO" = "ubuntu" ] || [ "$DISTRO" = "debian" ]; then
+            install_nodejs_ubuntu
+            return $?
+        else
+            print_error "Automatic installation not supported for this Linux distribution"
+            print_info "Manual Installation:"
+            echo "  Please visit: https://nodejs.org/"
+            return 1
+        fi
+    else
+        print_error "Automatic installation not supported for this OS"
+        print_info "Please install Node.js 22 from: https://nodejs.org/"
+        return 1
+    fi
+}
+
+# Suggest installation for PostgreSQL
+suggest_postgresql_installation() {
+    print_step "PostgreSQL Installation Required - Installing automatically..."
+    echo ""
+    
+    if [ "$OS" = "macOS" ]; then
+        install_postgresql_macos
+        return $?
+    elif [ "$OS" = "Linux" ]; then
+        if [ "$DISTRO" = "ubuntu" ] || [ "$DISTRO" = "debian" ]; then
+            install_postgresql_ubuntu
+            return $?
+        else
+            print_error "Automatic installation not supported for this Linux distribution"
+            print_info "Manual Installation:"
+            echo "  Please install PostgreSQL for your distribution"
+            return 1
+        fi
+    else
+        print_error "Automatic installation not supported for this OS"
+        print_info "Please install PostgreSQL from: https://www.postgresql.org/"
+        return 1
+    fi
+}
+
+# Placeholder for future extensions
+# This script only checks dependencies, not running bin/setup
+
+# Main setup logic
+main() {
+    echo ""
+    echo "╔═══════════════════════════════════════════════════════════╗"
+    echo "║                                                           ║"
+    echo "║   🚀 Rails 7.x Project Setup                             ║"
+    echo "║                                                           ║"
+    echo "║   Checking dependencies and setting up project...        ║"
+    echo "║                                                           ║"
+    echo "╚═══════════════════════════════════════════════════════════╝"
+    echo ""
+
+    detect_os
+
+    NODEJS_OK=false
+    POSTGRESQL_OK=false
+    RUBY_OK=false
+
+    # Check Ruby
+    print_step "Checking Ruby..."
+    if check_ruby; then
+        RUBY_OK=true
+    else
+        print_error "Ruby 3.0+ is required"
+        print_info "Please install Ruby using rbenv or mise:"
+        echo "  # Using mise (recommended)"
+        echo "  curl https://mise.run | sh"
+        echo "  mise use -g ruby@3"
+        echo ""
+        echo "  # Or using rbenv"
+        echo "  rbenv install 3.3.0"
+        echo "  rbenv global 3.3.0"
+        exit 1
+    fi
+
+    # Check Node.js
+    print_step "Checking Node.js..."
+    if check_nodejs; then
+        NODEJS_OK=true
+    else
+        if ! suggest_nodejs_installation; then
+            print_warning "Node.js 22+ is required but not installed"
+            print_info "Please install Node.js 22 and run this script again"
+            exit 1
+        else
+            # Verify installation
+            if check_nodejs; then
+                NODEJS_OK=true
+            else
+                print_error "Node.js installation verification failed"
+                exit 1
+            fi
+        fi
+    fi
+
+    # Check PostgreSQL
+    print_step "Checking PostgreSQL..."
+    if check_postgresql; then
+        POSTGRESQL_OK=true
+    else
+        if ! suggest_postgresql_installation; then
+            print_warning "PostgreSQL is required but not installed"
+            print_info "Please install PostgreSQL and run this script again"
+            exit 1
+        else
+            # Verify installation
+            if check_postgresql; then
+                POSTGRESQL_OK=true
+            else
+                print_error "PostgreSQL installation verification failed"
+                exit 1
+            fi
+        fi
+    fi
+
+    # All dependencies are ready
+    if [ "$RUBY_OK" = true ] && [ "$NODEJS_OK" = true ] && [ "$POSTGRESQL_OK" = true ]; then
+        echo ""
+        echo "╔═══════════════════════════════════════════════════════════╗"
+        echo "║                                                           ║"
+        echo "║   ✨ Environment Check Complete!                         ║"
+        echo "║                                                           ║"
+        echo "╚═══════════════════════════════════════════════════════════╝"
+        echo ""
+        print_success "All required dependencies are installed:"
+        echo "  ✓ Ruby $RUBY_VERSION"
+        echo "  ✓ Node.js $NODE_VERSION"
+        echo "  ✓ PostgreSQL $PG_VERSION"
+        echo ""
+        print_info "You can now run: ./bin/setup"
+        echo ""
+        exit 0
+    else
+        print_error "Some dependencies are missing. Please install them and run this script again."
+        exit 1
+    fi
+}
+
+# Run main setup
+main

data/lib/clacky/default_skills/skill-add/SKILL.md

@@ -1,66 +1,283 @@
 ---
 name: skill-add
-description: Guide for creating new SKILL.md files
+description: Create new skills or install from GitHub - supports interactive creation, quick setup, and repository imports
 disable-model-invocation: false
 user-invocable: true
 ---
 
-# Skill Creation Guide
+# Skill Add - Enhanced Skill Creation & Installation
 
-## SKILL.md Structure
+A comprehensive skill management tool that helps you create new skills interactively or install existing skills from GitHub repositories.
 
-### 1. Front Matter (Required)
-```yaml
----
-name: skill-name
-description: Brief one-line description
-disable-model-invocation: false
-user-invocable: true
----
+## ⚠️ Usage Instructions
+
+- **GitHub URL**: Call `ruby lib/clacky/default_skills/skill-add/scripts/install_from_github.rb <url>` via safe_shell
+- **Text description or no arguments**: Handle interactively via conversation, create files with write tool
+
+## Usage Modes
+
+### 1. Install from GitHub Repository
+```
+/skill-add https://github.com/username/repo-name
+/skill-add https://github.com/username/repo-name.git
 ```
 
-### 2. Main Content
-```markdown
-# Skill Title
+**When user provides a GitHub URL, execute the `install_from_github.rb` script:**
 
-## Usage
-How to invoke: "command description" or `/skill-name`
+Use the **Skill Directory** path shown below, and call:
+```bash
+ruby <skill_directory>/scripts/install_from_github.rb <github_url>
+```
 
-## Process Steps
+The script will automatically:
+- Validate the GitHub URL
+- Clone the repository to a temporary directory
+- Search for any `skills/` directory containing SKILL.md files
+- Copy all found skills to `.clacky/skills/` in the current project
+- Report installed skills with descriptions
+- Clean up temporary files
+
+**Do NOT manually clone or copy files - the script handles everything.**
 
-### 1. First Step
-What to do
+### 2. Interactive Creation Mode
+```
+/skill-add Brief description of what the skill should do
+/skill-add Create a skill for database migrations
+```
 
-### 2. Next Step
-Continue the task
+**Process:**
+1. Understand the skill requirement from user's description
+2. Ask clarifying questions:
+   - What is the main purpose?
+   - What inputs/parameters are needed?
+   - Should it have helper scripts?
+   - Any specific commands or tools needed?
+3. Design the skill structure:
+   - Skill name (kebab-case)
+   - Description
+   - Usage instructions
+   - Step-by-step process
+   - Optional: Create helper scripts in `scripts/` subdirectory
+4. Create the skill in `.clacky/skills/{skill-name}/`
+5. Show summary of created files
+
+**Example Interaction:**
+```
+User: /skill-add Create a skill for API testing with curl
+
+Agent: I'll help you create an API testing skill. Let me ask a few questions:
+
+Q1: What's the main purpose of this skill?
+User: Test REST APIs quickly with different HTTP methods
+
+Agent: Great! A few more questions:
+Q2: Should it support authentication (API keys, tokens)?
+User: Yes, Bearer tokens
+
+Q3: Should it have pre-configured examples?
+User: Yes, for common patterns like GET, POST, PUT, DELETE
+
+Agent: Perfect! Creating skill...
+
+Created files:
+✓ .clacky/skills/api-tester/SKILL.md
+✓ .clacky/skills/api-tester/scripts/test_endpoint.sh
+✓ .clacky/skills/api-tester/scripts/examples.json
+
+You can now use: /api-tester
+```
+
+### 3. Quick Start (No Arguments)
+```
+/skill-add
+```
+
+**Process:**
+- Ask user what they want to create
+- Offer suggestions based on common patterns:
+  - Command runner
+  - Code analyzer
+  - File processor
+  - Data transformer
+  - Custom workflow
+- Guide them through creation with focused questions
+- Create the skill with best practices
+
+## Implementation Guidelines
+
+### For GitHub Installation
+
+Use the `install_from_github.rb` script (available in Supporting Files):
 
-## Commands Used
 ```bash
-# Key commands
+ruby <skill_directory>/scripts/install_from_github.rb <github_url>
 ```
 
-## Notes
-- Important points
+The Skill Directory path is shown at the bottom of this document.
+
+**Do NOT manually clone, search, or copy files - let the script handle everything.**
+
+### For Interactive Creation
+
+When user provides a description or no arguments:
+
+1. **Parse Intent**: Understand what the user wants to create from their description
+
+2. **Gather Requirements**: Ask 3-5 focused questions through conversation:
+   - What should we call this skill? (suggest a name based on description)
+   - What inputs/arguments does it need?
+   - What are the main steps it should perform?
+   - Should it have helper scripts? (bash/ruby/python)
+   - Any specific tools or commands to use?
+
+3. **Design Structure**: Based on answers, design the SKILL.md content with:
+   - Valid YAML frontmatter (name, description, etc.)
+   - Clear usage instructions
+   - Step-by-step process
+   - Examples
+   - Scripts if needed
+
+4. **Create Files** using write tool:
+   - `.clacky/skills/{skill-name}/SKILL.md`
+   - `.clacky/skills/{skill-name}/scripts/` (if needed)
+   - Helper scripts with proper permissions
+
+5. **Confirm**: Show what was created and how to use it
+
+**Example conversation flow:**
 ```
+User: /skill-add Create a skill for testing APIs
+
+Agent: I'll help you create an API testing skill. Let me ask a few questions:
+
+Q1: What should we call this skill?
+Suggestion: "api-tester"
+
+User: api-tester sounds good
 
-## File Location
-`.clacky/skills/{skill-name}/SKILL.md`
+Agent: Q2: What inputs does it need?
+User: URL, HTTP method, and optional headers
 
-## Minimal Example
+Agent: Q3: Should it have a helper script?
+User: Yes, a bash script using curl
+
+Agent: Perfect! Creating skill...
+
+Created:
+✓ .clacky/skills/api-tester/SKILL.md
+✓ .clacky/skills/api-tester/scripts/test.sh
+
+You can now use: /api-tester
+```
+
+## Skill Structure
+
+### Minimal SKILL.md
 ```markdown
 ---
-name: hello
-description: Simple greeting
+name: hello-world
+description: Simple greeting skill
 disable-model-invocation: false
 user-invocable: true
 ---
 
-# Hello Skill
+# Hello World Skill
 
 ## Usage
-Say "hello" or `/hello`
+Say "hello" or `/hello-world`
 
 ## Process Steps
-### 1. Greet user
-### 2. Offer help
+### 1. Greet the user
+### 2. Offer assistance
+```
+
+### Full-Featured Skill
+```markdown
+---
+name: db-migrate
+description: Database migration helper with rollback support
+disable-model-invocation: false
+user-invocable: true
+---
+
+# Database Migration Helper
+
+## Usage
+`/db-migrate [action] [options]`
+
+Actions:
+- create - Create new migration
+- up - Run pending migrations
+- down - Rollback last migration
+- status - Show migration status
+
+## Process Steps
+
+### 1. Determine Action
+Parse the command arguments to identify the action.
+
+### 2. Execute Action
+Run the appropriate migration script from scripts/ directory.
+
+### 3. Report Results
+Show migration status and any errors.
+
+## Scripts
+
+Helper scripts in `scripts/` directory:
+- `create_migration.rb` - Generate migration file
+- `run_migrations.rb` - Execute pending migrations
+- `rollback.rb` - Rollback migrations
+
+## Examples
+
+Create a new migration:
+```bash
+/db-migrate create add_users_table
+```
+
+Run all pending migrations:
+```bash
+/db-migrate up
+```
+
+Rollback last migration:
+```bash
+/db-migrate down
+```
 ```
+
+## Best Practices
+
+1. **Clear Naming**: Use kebab-case for skill names (e.g., `api-tester`, `code-formatter`)
+2. **Good Descriptions**: Write concise, actionable descriptions
+3. **Structured Steps**: Break down process into clear, numbered steps
+4. **Helper Scripts**: Use scripts/ directory for complex logic
+5. **Examples**: Always include usage examples
+6. **Documentation**: Explain all parameters and options
+
+## Commands Used
+
+```bash
+# Clone from GitHub
+git clone <repo-url> /tmp/skills-repo
+cp -r /tmp/skills-repo/skills/* .clacky/skills/
+
+# Create skill directory
+mkdir -p .clacky/skills/{skill-name}
+mkdir -p .clacky/skills/{skill-name}/scripts
+
+# Write skill file
+cat > .clacky/skills/{skill-name}/SKILL.md << 'EOF'
+...
+EOF
+```
+
+## Notes
+
+- Skills are installed to `.clacky/skills/` in the current project directory
+- Project skills (`.clacky/skills/`) override global skills (`~/.clacky/skills/`)
+- Skill names must be lowercase with hyphens only
+- SKILL.md must have valid YAML frontmatter
+- Scripts should be executable (chmod +x)
+- Test skills after creation with `/skill-name`