moai-adk 0.8.0__py3-none-any.whl → 0.34.0__py3-none-any.whl

moai_adk/templates/.claude/skills/moai-skill-factory/scripts/generate-structure.sh

@@ -1,328 +0,0 @@
-#!/bin/bash
-set -euo pipefail
-
-# Skill Structure Generator
-# Creates standardized directory structure for new Skills
-# Usage: ./generate-structure.sh skill-name "Skill Display Name"
-
-# Color codes
-GREEN='\033[0;32m'
-BLUE='\033[0;34m'
-YELLOW='\033[1;33m'
-NC='\033[0m'
-
-# Arguments
-SKILL_DIR="${1:-.}"
-SKILL_NAME="${2:-New Skill}"
-
-if [[ "$SKILL_DIR" == "." ]]; then
-    echo -e "${YELLOW}⚠ Usage: generate-structure.sh <skill-dir> <display-name>${NC}"
-    echo -e "Example: generate-structure.sh my-new-skill \"Processing CSV Files\""
-    exit 1
-fi
-
-# Normalize skill directory name (kebab-case)
-SKILL_DIR=$(echo "$SKILL_DIR" | tr '[:upper:]' '[:lower:]' | sed 's/ /-/g')
-
-echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
-echo -e "${BLUE}Skill Structure Generator${NC}"
-echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
-echo
-
-# Create directories
-echo -e "${GREEN}Creating directories...${NC}"
-mkdir -p "$SKILL_DIR/scripts"
-mkdir -p "$SKILL_DIR/templates"
-echo -e "${GREEN}✓ Directories created${NC}"
-echo
-
-# Create SKILL.md if not exists
-if [[ ! -f "$SKILL_DIR/SKILL.md" ]]; then
-    cat > "$SKILL_DIR/SKILL.md" << 'EOF'
----
-name: "Skill Name Here"
-description: "What this Skill does and when to use it. Include 3+ discoverable keywords and trigger scenarios."
-allowed-tools: "Tool1, Tool2"
----
-
-# [Skill Name]
-
-> **Quick Reference**: Links to supporting files go here.
-
----
-
-## Overview
-
-Describe what this Skill provides and its core purpose.
-
-## Quick Start
-
-Provide the fastest path to getting started with this Skill.
-
-## Main Framework
-
-### Section 1: High Freedom (Principles)
-
-Provide principles, considerations, and trade-offs.
-
-### Section 2: Medium Freedom (Patterns)
-
-Include pseudocode, flowcharts, and pattern examples.
-
-### Section 3: Low Freedom (Scripts)
-
-Provide ready-to-use scripts with error handling.
-
-## See Also
-
-- [reference.md](reference.md) for detailed reference
-- [examples.md](examples.md) for real-world scenarios
-- `scripts/` for automation utilities
-- `templates/` for reusable templates
-
----
-
-**Version**: 0.1.0
-**Status**: Draft
-**Last Updated**: 2025-10-22
-EOF
-    echo -e "${GREEN}✓ Created SKILL.md${NC}"
-else
-    echo -e "${YELLOW}⊘ SKILL.md already exists${NC}"
-fi
-echo
-
-# Create reference.md if not exists
-if [[ ! -f "$SKILL_DIR/reference.md" ]]; then
-    cat > "$SKILL_DIR/reference.md" << 'EOF'
-# Reference: [Skill Name]
-
-This document provides detailed reference information for [Skill Name].
-
-## API Reference
-
-### Function/Command 1
-
-Description of what it does.
-
-**Parameters**:
-- `param1`: Description
-- `param2`: Description
-
-**Returns**: Description of return value
-
-**Example**:
-```
-code example here
-```
-
-## Configuration
-
-### Available Options
-
-- Option 1: Description
-- Option 2: Description
-
-### Configuration Format
-
-```yaml
-example: configuration
-structure: here
-```
-
-## Edge Cases
-
-### Known Limitations
-
-- Limitation 1
-- Limitation 2
-
-### Workarounds
-
-- Workaround for limitation 1
-- Workaround for limitation 2
-
-## Performance Considerations
-
-- Consideration 1
-- Consideration 2
-
-## Glossary
-
-- **Term 1**: Definition
-- **Term 2**: Definition
-
-## Related Resources
-
-- [SKILL.md](SKILL.md) for main framework
-- [examples.md](examples.md) for usage examples
-
----
-
-**Version**: 0.1.0
-**Last Updated**: 2025-10-22
-EOF
-    echo -e "${GREEN}✓ Created reference.md${NC}"
-else
-    echo -e "${YELLOW}⊘ reference.md already exists${NC}"
-fi
-echo
-
-# Create examples.md if not exists
-if [[ ! -f "$SKILL_DIR/examples.md" ]]; then
-    cat > "$SKILL_DIR/examples.md" << 'EOF'
-# Examples: [Skill Name]
-
-Real-world examples demonstrating [Skill Name] in practice.
-
-## Example 1: Basic Usage
-
-**Scenario**: [Describe a basic scenario]
-
-**Code**:
-```
-example code here
-```
-
-**Expected Output**:
-```
-expected output here
-```
-
-## Example 2: Intermediate Pattern
-
-**Scenario**: [Describe an intermediate scenario]
-
-**Code**:
-```
-example code here
-```
-
-**Expected Output**:
-```
-expected output here
-```
-
-## Example 3: Advanced Use Case
-
-**Scenario**: [Describe an advanced scenario]
-
-**Code**:
-```
-example code here
-```
-
-**Expected Output**:
-```
-expected output here
-```
-
-## Example 4: Edge Case
-
-**Scenario**: [Describe an edge case or unusual scenario]
-
-**Code**:
-```
-example code here
-```
-
-**Expected Output**:
-```
-expected output here
-```
-
-## Common Patterns
-
-### Pattern 1
-Description and example of a common pattern.
-
-### Pattern 2
-Description and example of another common pattern.
-
-## See Also
-
-- [SKILL.md](SKILL.md) for framework and concepts
-- [reference.md](reference.md) for API details
-
----
-
-**Version**: 0.1.0
-**Last Updated**: 2025-10-22
-EOF
-    echo -e "${GREEN}✓ Created examples.md${NC}"
-else
-    echo -e "${YELLOW}⊘ examples.md already exists${NC}"
-fi
-echo
-
-# Create sample script template
-if [[ ! -f "$SKILL_DIR/scripts/.gitkeep" && ! -f "$SKILL_DIR/scripts"/*.sh ]]; then
-    touch "$SKILL_DIR/scripts/.gitkeep"
-    echo -e "${GREEN}✓ Created scripts/.gitkeep${NC}"
-else
-    echo -e "${YELLOW}⊘ scripts directory already has content${NC}"
-fi
-echo
-
-# Create sample template
-if [[ ! -f "$SKILL_DIR/templates/.gitkeep" && ! -f "$SKILL_DIR/templates"/* ]]; then
-    touch "$SKILL_DIR/templates/.gitkeep"
-    echo -e "${GREEN}✓ Created templates/.gitkeep${NC}"
-else
-    echo -e "${YELLOW}⊘ templates directory already has content${NC}"
-fi
-echo
-
-# Create .gitignore if not exists
-if [[ ! -f "$SKILL_DIR/.gitignore" ]]; then
-    cat > "$SKILL_DIR/.gitignore" << 'EOF'
-# Temporary files
-*.tmp
-*.temp
-.DS_Store
-
-# IDE
-.vscode/
-.idea/
-*.swp
-*.swo
-
-# Python
-__pycache__/
-*.py[cod]
-.pytest_cache/
-.coverage
-
-# Node
-node_modules/
-.npm
-EOF
-    echo -e "${GREEN}✓ Created .gitignore${NC}"
-fi
-echo
-
-# Display summary
-echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
-echo -e "${GREEN}✅ Skill Structure Created${NC}"
-echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
-echo
-echo "Directory: $SKILL_DIR"
-echo "Files created:"
-echo "  ✓ SKILL.md (main content template)"
-echo "  ✓ reference.md (supporting reference)"
-echo "  ✓ examples.md (usage examples)"
-echo "  ✓ scripts/ (for utility scripts)"
-echo "  ✓ templates/ (for reusable templates)"
-echo "  ✓ .gitignore (version control)"
-echo
-echo -e "${BLUE}Next Steps:${NC}"
-echo "1. Edit SKILL.md with your Skill content"
-echo "2. Update metadata (name, description, allowed-tools)"
-echo "3. Add examples to examples.md"
-echo "4. Create scripts in scripts/ directory"
-echo "5. Run validation: ../../scripts/validate-skill.sh $SKILL_DIR"
-echo
-echo -e "${BLUE}Documentation:${NC}"
-echo "- See SKILL.md for content guidelines"
-echo "- See templates/ for example structures"
-echo

moai_adk/templates/.claude/skills/moai-skill-factory/scripts/validate-skill.sh

@@ -1,312 +0,0 @@
-#!/bin/bash
-set -euo pipefail
-
-# Skill Validation Script
-# Validates Skill packages against MoAI-ADK quality standards
-# Usage: ./validate-skill.sh /path/to/skill-name
-
-SKILL_PATH="${1:-.}"
-SCORE=0
-MAX_SCORE=85
-WARNINGS=0
-
-# Color codes
-GREEN='\033[0;32m'
-RED='\033[0;31m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m' # No Color
-
-# Functions
-log_pass() {
-    echo -e "${GREEN}✓${NC} $1"
-    ((SCORE+=1))
-}
-
-log_fail() {
-    echo -e "${RED}✗${NC} $1"
-}
-
-log_warn() {
-    echo -e "${YELLOW}⚠${NC} $1"
-    ((WARNINGS+=1))
-}
-
-log_info() {
-    echo -e "${BLUE}ℹ${NC} $1"
-}
-
-# Header
-echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
-echo -e "${BLUE}Skill Validation: $(basename "$SKILL_PATH")${NC}"
-echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
-echo
-
-# === METADATA COMPLETENESS (8 points) ===
-echo -e "${BLUE}[Metadata Completeness]${NC}"
-
-if [[ ! -f "$SKILL_PATH/SKILL.md" ]]; then
-    log_fail "SKILL.md not found"
-    exit 1
-fi
-
-# Check name field
-if grep -q "^name:" "$SKILL_PATH/SKILL.md"; then
-    NAME=$(grep "^name:" "$SKILL_PATH/SKILL.md" | sed 's/^name: *"\(.*\)"/\1/')
-    NAME_LEN=${#NAME}
-    if [[ $NAME_LEN -le 64 ]]; then
-        log_pass "name field present and within limit ($NAME_LEN chars)"
-        ((SCORE+=2))
-    else
-        log_fail "name field exceeds 64 characters ($NAME_LEN chars)"
-    fi
-else
-    log_fail "name field missing"
-fi
-
-# Check description field
-if grep -q "^description:" "$SKILL_PATH/SKILL.md"; then
-    log_pass "description field present"
-    ((SCORE+=2))
-    DESC=$(grep "^description:" "$SKILL_PATH/SKILL.md" | sed 's/^description: *"\(.*\)"/\1/')
-    DESC_LEN=${#DESC}
-    if [[ $DESC_LEN -le 1024 ]]; then
-        log_pass "description within limit ($DESC_LEN chars)"
-        ((SCORE+=1))
-    else
-        log_fail "description exceeds 1024 characters"
-    fi
-else
-    log_fail "description field missing"
-fi
-
-# Check allowed-tools field
-if grep -q "^allowed-tools:" "$SKILL_PATH/SKILL.md"; then
-    log_pass "allowed-tools field present"
-    ((SCORE+=2))
-else
-    log_warn "allowed-tools field missing (recommended)"
-fi
-
-# Check YAML validity
-if head -n 10 "$SKILL_PATH/SKILL.md" | grep -q "^---$"; then
-    log_pass "YAML frontmatter starts with ---"
-    ((SCORE+=1))
-else
-    log_fail "YAML frontmatter missing ---"
-fi
-
-echo
-
-# === CONTENT QUALITY (16 points) ===
-echo -e "${BLUE}[Content Quality]${NC}"
-
-# Check file size
-LINE_COUNT=$(wc -l < "$SKILL_PATH/SKILL.md")
-if [[ $LINE_COUNT -le 500 ]]; then
-    log_pass "SKILL.md within size limit ($LINE_COUNT lines)"
-    ((SCORE+=2))
-else
-    log_fail "SKILL.md exceeds 500 lines ($LINE_COUNT lines)"
-fi
-
-# Check for examples
-if grep -q "^##.*[Ee]xample" "$SKILL_PATH/SKILL.md"; then
-    EXAMPLE_COUNT=$(grep -c "^###" "$SKILL_PATH/SKILL.md" || echo 0)
-    if [[ $EXAMPLE_COUNT -ge 1 ]]; then
-        log_pass "Examples found ($EXAMPLE_COUNT examples)"
-        ((SCORE+=2))
-    else
-        log_warn "Few examples found"
-    fi
-else
-    log_warn "No examples section detected"
-fi
-
-# Check for relative paths
-if grep -q "\[.*\](.*)" "$SKILL_PATH/SKILL.md"; then
-    if grep -q "\[.*\](\.\./\|http\|/\|~" "$SKILL_PATH/SKILL.md"; then
-        log_warn "Some links may use absolute or external paths"
-        ((WARNINGS+=1))
-    else
-        log_pass "Links use relative paths"
-        ((SCORE+=2))
-    fi
-else
-    log_pass "No external links detected"
-    ((SCORE+=2))
-fi
-
-# Check for Windows paths
-if grep -q "\\\\" "$SKILL_PATH/SKILL.md"; then
-    log_fail "Windows-style paths detected (use forward slashes)"
-else
-    log_pass "No Windows-style paths"
-    ((SCORE+=1))
-fi
-
-# Check for glossary/terminology
-if grep -q "[Gg]lossary\|[Tt]ermino" "$SKILL_PATH/SKILL.md"; then
-    log_pass "Glossary or terminology section present"
-    ((SCORE+=1))
-else
-    log_warn "No glossary detected"
-fi
-
-# Check for time-sensitive data
-if grep -q "20[0-9][0-9]-[0-9][0-9]-[0-9][0-9]\|today\|current date" "$SKILL_PATH/SKILL.md"; then
-    log_fail "Time-sensitive information detected"
-else
-    log_pass "No time-sensitive data"
-    ((SCORE+=1))
-fi
-
-echo
-
-# === FILE STRUCTURE (6 points) ===
-echo -e "${BLUE}[File Structure]${NC}"
-
-# Check directory depth
-MAX_DEPTH=$(find "$SKILL_PATH" -type d | sed "s|$SKILL_PATH||" | grep -v "^$" | awk -F/ '{print NF}' | sort -rn | head -1)
-if [[ -z $MAX_DEPTH ]]; then
-    MAX_DEPTH=1
-fi
-
-if [[ $MAX_DEPTH -le 2 ]]; then
-    log_pass "Directory structure flat (max depth: $MAX_DEPTH)"
-    ((SCORE+=2))
-else
-    log_fail "Directory structure too nested (max depth: $MAX_DEPTH)"
-fi
-
-# Check for common subdirs
-if [[ -d "$SKILL_PATH/scripts" ]]; then
-    SCRIPT_COUNT=$(find "$SKILL_PATH/scripts" -type f | wc -l)
-    log_pass "scripts/ directory present ($SCRIPT_COUNT files)"
-    ((SCORE+=1))
-fi
-
-if [[ -d "$SKILL_PATH/templates" ]]; then
-    TEMPLATE_COUNT=$(find "$SKILL_PATH/templates" -type f | wc -l)
-    log_pass "templates/ directory present ($TEMPLATE_COUNT files)"
-    ((SCORE+=1))
-fi
-
-# Check for supporting docs
-if [[ -f "$SKILL_PATH/reference.md" ]]; then
-    log_pass "reference.md found"
-    ((SCORE+=1))
-fi
-
-if [[ -f "$SKILL_PATH/examples.md" ]]; then
-    log_pass "examples.md found"
-    ((SCORE+=1))
-fi
-
-echo
-
-# === MARKDOWN VALIDITY (3 points) ===
-echo -e "${BLUE}[Markdown Validity]${NC}"
-
-# Check for proper headers
-if grep -q "^#" "$SKILL_PATH/SKILL.md"; then
-    log_pass "Headers detected"
-    ((SCORE+=1))
-else
-    log_warn "No headers found"
-fi
-
-# Check for code blocks
-if grep -q "^\`\`\`" "$SKILL_PATH/SKILL.md"; then
-    log_pass "Code blocks present"
-    ((SCORE+=1))
-else
-    log_warn "No code blocks found"
-fi
-
-# Check for lists
-if grep -q "^- \|^  - " "$SKILL_PATH/SKILL.md"; then
-    log_pass "Lists present"
-    ((SCORE+=1))
-else
-    log_warn "No lists detected"
-fi
-
-echo
-
-# === SCRIPT VALIDITY (if present) ===
-if [[ -d "$SKILL_PATH/scripts" ]]; then
-    echo -e "${BLUE}[Script Validation]${NC}"
-
-    for script in "$SKILL_PATH"/scripts/*; do
-        if [[ -f "$script" && ! "$script" =~ \.gitkeep$ ]]; then
-            SCRIPT_NAME=$(basename "$script")
-
-            # Check shebang
-            if head -n 1 "$script" | grep -q "^#!/"; then
-                log_pass "$SCRIPT_NAME has shebang"
-                ((SCORE+=1))
-            else
-                log_warn "$SCRIPT_NAME missing shebang"
-            fi
-
-            # Check for error handling (Bash scripts)
-            if [[ "$script" =~ \.sh$ ]]; then
-                if grep -q "set -euo pipefail\|set -e" "$script"; then
-                    log_pass "$SCRIPT_NAME has error handling"
-                    ((SCORE+=1))
-                else
-                    log_warn "$SCRIPT_NAME lacks error handling"
-                fi
-            fi
-        fi
-    done
-    echo
-fi
-
-# === SECURITY CHECK ===
-echo -e "${BLUE}[Security Check]${NC}"
-
-# Check for credentials
-if grep -q "password\|api_key\|secret\|token.*=" "$SKILL_PATH/SKILL.md" -i; then
-    log_warn "Potential credentials detected in SKILL.md"
-    ((WARNINGS+=1))
-else
-    log_pass "No obvious credentials"
-    ((SCORE+=1))
-fi
-
-# Check for no email
-if grep -q "[a-z0-9._%+-]*@[a-z0-9.-]*\.[a-z]" "$SKILL_PATH/SKILL.md"; then
-    log_warn "Email addresses found (privacy concern?)"
-    ((WARNINGS+=1))
-else
-    log_pass "No email addresses"
-    ((SCORE+=1))
-fi
-
-echo
-
-# === SUMMARY ===
-echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
-echo -e "Score: ${BLUE}$SCORE${NC}/$MAX_SCORE"
-if [[ $WARNINGS -gt 0 ]]; then
-    echo -e "Warnings: ${YELLOW}$WARNINGS${NC}"
-fi
-echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
-
-# Determine pass/fail
-if [[ $SCORE -ge 70 ]]; then
-    echo -e "${GREEN}✅ PASS${NC}"
-    if [[ $SCORE -ge 85 ]]; then
-        echo -e "${GREEN}Ready for publication${NC}"
-        exit 0
-    else
-        echo -e "${YELLOW}Minor issues detected; review warnings${NC}"
-        exit 0
-    fi
-else
-    echo -e "${RED}❌ FAIL${NC}"
-    echo -e "${RED}Needs significant improvements${NC}"
-    exit 1
-fi