Initial commit

2025-11-29 18:50:46 +08:00
commit fa57381c8f
14 changed files with 624 additions and 0 deletions
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -0,0 +1,15 @@
+{
+  "name": "roi-calculator",
+  "description": "Calculate and present ROI for AI automation projects",
+  "version": "1.0.0",
+  "author": {
+    "name": "Claude Code Plugin Hub",
+    "url": "https://github.com/jeremylongshore/claude-code-plugins"
+  },
+  "skills": [
+    "./skills"
+  ],
+  "commands": [
+    "./commands"
+  ]
+}
--- a/README.md
+++ b/README.md
@@ -0,0 +1,3 @@
+# roi-calculator
+
+Calculate and present ROI for AI automation projects
--- a/commands/roi.md
+++ b/commands/roi.md
@@ -0,0 +1,200 @@
+---
+description: Calculate automation ROI
+---
+
+# ROI Calculator
+
+Calculate and present compelling ROI for AI automation projects.
+
+## ROI Calculation Framework
+
+### Current State Costs (Annual)
+```
+Labor Costs:
+- Hours per week: [X]
+- Hourly rate: $[X]
+- Annual cost: Hours × Rate × 52 = $[X]
+
+Error Costs:
+- Error rate: [X]%
+- Cost per error: $[X]
+- Annual error cost: $[X]
+
+Opportunity Costs:
+- Lost revenue due to delays: $[X]
+- Missed opportunities: $[X]
+
+Total Annual Cost: $[X]
+```
+
+### Automation Solution
+```
+Implementation Costs:
+- Agency fees: $[X]
+- Software licenses: $[X]/year
+- Training: $[X]
+- Total implementation: $[X]
+
+Annual Operating Costs:
+- Software licenses: $[X]
+- API costs: $[X]
+- Maintenance: $[X]
+- Total annual operating: $[X]
+```
+
+### ROI Calculation
+```
+Time Savings:
+- Current time: [X] hours/week
+- After automation: [X] hours/week
+- Time saved: [X] hours/week
+- Annual hours saved: [X] × 52 = [X]
+- Value of time saved: [X] × $[rate] = $[X]
+
+Quality Improvements:
+- Error reduction: [X]%
+- Annual error savings: $[X]
+
+Speed Improvements:
+- Faster processing: [X]%
+- Additional capacity: $[X]
+
+Total Annual Benefit: $[X]
+Net Annual Benefit: $[X] - $[X] operating = $[X]
+
+ROI: (Net Benefit / Implementation Cost) × 100 = [X]%
+Payback Period: Implementation Cost / Net Annual Benefit = [X] months
+```
+
+## ROI Presentation Template
+
+```markdown
+# ROI Analysis: [Project Name]
+
+## Executive Summary
+By implementing [solution], [Company] will save **$X per year** with an ROI of **X%** and payback period of **X months**.
+
+## Current State Analysis
+
+### Time Investment
+Currently, your team spends:
+- **X hours per week** on [process]
+- **X hours per year** total
+- **$X per year** in labor costs (at $X/hour)
+
+### Quality Issues
+- **X% error rate** costing approximately **$X per error**
+- **$X per year** in rework and corrections
+
+### Opportunity Cost
+- **X hours per week** that could be spent on higher-value work
+- Estimated **$X in missed revenue** due to capacity constraints
+
+**Total Current Annual Cost: $X**
+
+## Proposed Solution
+
+### Implementation
+- Development: $X
+- Integration: $X
+- Training: $X
+**Total Implementation: $X**
+
+### Annual Operating Costs
+- Software licenses: $X/year
+- API usage: $X/year
+- Maintenance: $X/year
+**Total Annual Operating: $X/year**
+
+## Expected Benefits
+
+### Time Savings
+- **Reduce process time by X%**
+- **Save X hours per week**
+- **$X value of time savings per year**
+
+### Quality Improvements
+- **Reduce errors by X%**
+- **Save $X per year in error costs**
+
+### Capacity Gains
+- **Free up X% of team capacity**
+- **Enable $X in additional revenue**
+
+**Total Annual Benefit: $X**
+
+## ROI Summary
+
+| Metric | Value |
+|--------|-------|
+| Implementation Cost | $X |
+| Annual Operating Cost | $X |
+| Annual Benefit | $X |
+| Net Annual Benefit | $X |
+| **ROI** | **X%** |
+| **Payback Period** | **X months** |
+| **3-Year Value** | **$X** |
+
+## Comparison: Do Nothing vs Automate
+
+### Year 1
+- Do Nothing: Lose $X in inefficiency
+- Automate: Invest $X, gain $X → Net $X
+
+### Year 2
+- Do Nothing: Lose $X (cumulative $X)
+- Automate: Gain $X (cumulative $X)
+
+### Year 3
+- Do Nothing: Lose $X (cumulative $X)
+- Automate: Gain $X (cumulative $X)
+
+**3-Year Difference: $X**
+
+## Risk Mitigation
+- Phased implementation reduces risk
+- 30-day warranty included
+- Ongoing support available
+- Proven technology stack
+
+## Next Steps
+1. Approve project scope
+2. Begin implementation (Week 1)
+3. See first results (Week 8)
+4. Full ROI realized (Month X)
+```
+
+## Industry-Specific ROI Examples
+
+### Customer Support Automation
+```
+Before: 1000 tickets/month, 15 min average = 250 hours
+After: 60% automated, 100 hours saved
+Savings: 150 hours × $35/hour = $5,250/month
+Annual: $63,000
+Implementation: $25,000
+ROI: 252% (4-month payback)
+```
+
+### Content Generation
+```
+Before: 10 posts/week, 2 hours each = 20 hours/week
+After: AI generates drafts, 30 min review = 5 hours/week
+Savings: 15 hours × $75/hour = $1,125/week
+Annual: $58,500
+Implementation: $15,000
+ROI: 390% (3-month payback)
+```
+
+### Lead Qualification
+```
+Before: 500 leads/month, 10 min each = 83 hours
+After: AI scores leads, review top 20% = 17 hours
+Savings: 66 hours × $50/hour = $3,300/month
+Plus: 25% increase in qualified leads = $10,000/month
+Annual: $159,600
+Implementation: $20,000
+ROI: 798% (1.5-month payback)
+```
+
+Use this calculator to build compelling business cases for AI automation projects.
--- a/plugin.lock.json
+++ b/plugin.lock.json
@@ -0,0 +1,85 @@
+{
+  "$schema": "internal://schemas/plugin.lock.v1.json",
+  "pluginId": "gh:jeremylongshore/claude-code-plugins-plus:plugins/ai-agency/roi-calculator",
+  "normalized": {
+    "repo": null,
+    "ref": "refs/tags/v20251128.0",
+    "commit": "cbef08c1274c8386bec40c09a9b9a22bdf6a4362",
+    "treeHash": "605d385f08f1e5942ba67918e2b667aa0b7df5abe91a1de1164aa33cbdb03b93",
+    "generatedAt": "2025-11-28T10:18:42.767179Z",
+    "toolVersion": "publish_plugins.py@0.2.0"
+  },
+  "origin": {
+    "remote": "git@github.com:zhongweili/42plugin-data.git",
+    "branch": "master",
+    "commit": "aa1497ed0949fd50e99e70d6324a29c5b34f9390",
+    "repoRoot": "/Users/zhongweili/projects/openmind/42plugin-data"
+  },
+  "manifest": {
+    "name": "roi-calculator",
+    "description": "Calculate and present ROI for AI automation projects",
+    "version": "1.0.0"
+  },
+  "content": {
+    "files": [
+      {
+        "path": "README.md",
+        "sha256": "d363d6c8d991ce41dea2aec3f0408e14da81645a8306e3deae42c4e4d45b0ee2"
+      },
+      {
+        "path": ".claude-plugin/plugin.json",
+        "sha256": "ff0ca4b8505d0ccc93602177e1a11ec57a540c9aa4f9c64d64b3542ed65345fb"
+      },
+      {
+        "path": "commands/roi.md",
+        "sha256": "2ea0ce03954aa2771f3ed6e5ffa843272c7a2c8825836dc14235ecc20c29e1d7"
+      },
+      {
+        "path": "skills/skill-adapter/references/examples.md",
+        "sha256": "922bbc3c4ebf38b76f515b5c1998ebde6bf902233e00e2c5a0e9176f975a7572"
+      },
+      {
+        "path": "skills/skill-adapter/references/best-practices.md",
+        "sha256": "c8f32b3566252f50daacd346d7045a1060c718ef5cfb07c55a0f2dec5f1fb39e"
+      },
+      {
+        "path": "skills/skill-adapter/references/README.md",
+        "sha256": "8f1a0fe46eed2823b1c8c6ccf33457223f92b0fe9d5689011a6eb9ef5905f4aa"
+      },
+      {
+        "path": "skills/skill-adapter/scripts/helper-template.sh",
+        "sha256": "0881d5660a8a7045550d09ae0acc15642c24b70de6f08808120f47f86ccdf077"
+      },
+      {
+        "path": "skills/skill-adapter/scripts/validation.sh",
+        "sha256": "92551a29a7f512d2036e4f1fb46c2a3dc6bff0f7dde4a9f699533e446db48502"
+      },
+      {
+        "path": "skills/skill-adapter/scripts/README.md",
+        "sha256": "fa0d0cfb00e2605bca2c4dd1cef3d9920bbf242dcddc37fe3155d7465a52ee0d"
+      },
+      {
+        "path": "skills/skill-adapter/assets/test-data.json",
+        "sha256": "ac17dca3d6e253a5f39f2a2f1b388e5146043756b05d9ce7ac53a0042eee139d"
+      },
+      {
+        "path": "skills/skill-adapter/assets/README.md",
+        "sha256": "0422458279c80629358bb73d4aed97d34c967169995cd2e148d47389d7edcbd1"
+      },
+      {
+        "path": "skills/skill-adapter/assets/skill-schema.json",
+        "sha256": "f5639ba823a24c9ac4fb21444c0717b7aefde1a4993682897f5bf544f863c2cd"
+      },
+      {
+        "path": "skills/skill-adapter/assets/config-template.json",
+        "sha256": "0c2ba33d2d3c5ccb266c0848fc43caa68a2aa6a80ff315d4b378352711f83e1c"
+      }
+    ],
+    "dirSha256": "605d385f08f1e5942ba67918e2b667aa0b7df5abe91a1de1164aa33cbdb03b93"
+  },
+  "security": {
+    "scannedAt": null,
+    "scannerVersion": null,
+    "flags": []
+  }
+}
--- a/skills/skill-adapter/assets/README.md
+++ b/skills/skill-adapter/assets/README.md
@@ -0,0 +1,7 @@
+# Assets
+
+Bundled resources for roi-calculator skill
+
+- [ ] roi_template.md: Markdown template for ROI reports.
+- [ ] example_roi_report.md: Example ROI report for customer support automation.
+- [ ] industry_logos/: Directory containing logos for different industries.
--- a/skills/skill-adapter/assets/config-template.json
+++ b/skills/skill-adapter/assets/config-template.json
@@ -0,0 +1,32 @@
+{
+  "skill": {
+    "name": "skill-name",
+    "version": "1.0.0",
+    "enabled": true,
+    "settings": {
+      "verbose": false,
+      "autoActivate": true,
+      "toolRestrictions": true
+    }
+  },
+  "triggers": {
+    "keywords": [
+      "example-trigger-1",
+      "example-trigger-2"
+    ],
+    "patterns": []
+  },
+  "tools": {
+    "allowed": [
+      "Read",
+      "Grep",
+      "Bash"
+    ],
+    "restricted": []
+  },
+  "metadata": {
+    "author": "Plugin Author",
+    "category": "general",
+    "tags": []
+  }
+}
--- a/skills/skill-adapter/assets/skill-schema.json
+++ b/skills/skill-adapter/assets/skill-schema.json
@@ -0,0 +1,28 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Claude Skill Configuration",
+  "type": "object",
+  "required": ["name", "description"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z0-9-]+$",
+      "maxLength": 64,
+      "description": "Skill identifier (lowercase, hyphens only)"
+    },
+    "description": {
+      "type": "string",
+      "maxLength": 1024,
+      "description": "What the skill does and when to use it"
+    },
+    "allowed-tools": {
+      "type": "string",
+      "description": "Comma-separated list of allowed tools"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Semantic version (x.y.z)"
+    }
+  }
+}
--- a/skills/skill-adapter/assets/test-data.json
+++ b/skills/skill-adapter/assets/test-data.json
@@ -0,0 +1,27 @@
+{
+  "testCases": [
+    {
+      "name": "Basic activation test",
+      "input": "trigger phrase example",
+      "expected": {
+        "activated": true,
+        "toolsUsed": ["Read", "Grep"],
+        "success": true
+      }
+    },
+    {
+      "name": "Complex workflow test",
+      "input": "multi-step trigger example",
+      "expected": {
+        "activated": true,
+        "steps": 3,
+        "toolsUsed": ["Read", "Write", "Bash"],
+        "success": true
+      }
+    }
+  ],
+  "fixtures": {
+    "sampleInput": "example data",
+    "expectedOutput": "processed result"
+  }
+}
--- a/skills/skill-adapter/references/README.md
+++ b/skills/skill-adapter/references/README.md
@@ -0,0 +1,7 @@
+# References
+
+Bundled resources for roi-calculator skill
+
+- [ ] roi_calculation_methodology.md: Detailed explanation of the ROI calculation methodology used.
+- [ ] industry_benchmarks.md: Industry-specific ROI benchmarks for various automation projects.
+- [ ] cost_benefit_analysis_guide.md: Guide on performing cost-benefit analysis for AI automation.
--- a/skills/skill-adapter/references/best-practices.md
+++ b/skills/skill-adapter/references/best-practices.md
@@ -0,0 +1,69 @@
+# Skill Best Practices
+
+Guidelines for optimal skill usage and development.
+
+## For Users
+
+### Activation Best Practices
+
+1. **Use Clear Trigger Phrases**
+   - Match phrases from skill description
+   - Be specific about intent
+   - Provide necessary context
+
+2. **Provide Sufficient Context**
+   - Include relevant file paths
+   - Specify scope of analysis
+   - Mention any constraints
+
+3. **Understand Tool Permissions**
+   - Check allowed-tools in frontmatter
+   - Know what the skill can/cannot do
+   - Request appropriate actions
+
+### Workflow Optimization
+
+- Start with simple requests
+- Build up to complex workflows
+- Verify each step before proceeding
+- Use skill consistently for related tasks
+
+## For Developers
+
+### Skill Development Guidelines
+
+1. **Clear Descriptions**
+   - Include explicit trigger phrases
+   - Document all capabilities
+   - Specify limitations
+
+2. **Proper Tool Permissions**
+   - Use minimal necessary tools
+   - Document security implications
+   - Test with restricted tools
+
+3. **Comprehensive Documentation**
+   - Provide usage examples
+   - Document common pitfalls
+   - Include troubleshooting guide
+
+### Maintenance
+
+- Keep version updated
+- Test after tool updates
+- Monitor user feedback
+- Iterate on descriptions
+
+## Performance Tips
+
+- Scope skills to specific domains
+- Avoid overlapping trigger phrases
+- Keep descriptions under 1024 chars
+- Test activation reliability
+
+## Security Considerations
+
+- Never include secrets in skill files
+- Validate all inputs
+- Use read-only tools when possible
+- Document security requirements
--- a/skills/skill-adapter/references/examples.md
+++ b/skills/skill-adapter/references/examples.md
@@ -0,0 +1,70 @@
+# Skill Usage Examples
+
+This document provides practical examples of how to use this skill effectively.
+
+## Basic Usage
+
+### Example 1: Simple Activation
+
+**User Request:**
+```
+[Describe trigger phrase here]
+```
+
+**Skill Response:**
+1. Analyzes the request
+2. Performs the required action
+3. Returns results
+
+### Example 2: Complex Workflow
+
+**User Request:**
+```
+[Describe complex scenario]
+```
+
+**Workflow:**
+1. Step 1: Initial analysis
+2. Step 2: Data processing
+3. Step 3: Result generation
+4. Step 4: Validation
+
+## Advanced Patterns
+
+### Pattern 1: Chaining Operations
+
+Combine this skill with other tools:
+```
+Step 1: Use this skill for [purpose]
+Step 2: Chain with [other tool]
+Step 3: Finalize with [action]
+```
+
+### Pattern 2: Error Handling
+
+If issues occur:
+- Check trigger phrase matches
+- Verify context is available
+- Review allowed-tools permissions
+
+## Tips & Best Practices
+
+- ✅ Be specific with trigger phrases
+- ✅ Provide necessary context
+- ✅ Check tool permissions match needs
+- ❌ Avoid vague requests
+- ❌ Don't mix unrelated tasks
+
+## Common Issues
+
+**Issue:** Skill doesn't activate
+**Solution:** Use exact trigger phrases from description
+
+**Issue:** Unexpected results
+**Solution:** Check input format and context
+
+## See Also
+
+- Main SKILL.md for full documentation
+- scripts/ for automation helpers
+- assets/ for configuration examples
--- a/skills/skill-adapter/scripts/README.md
+++ b/skills/skill-adapter/scripts/README.md
@@ -0,0 +1,7 @@
+# Scripts
+
+Bundled resources for roi-calculator skill
+
+- [ ] roi_calculation.py: Script to perform ROI calculations based on provided inputs.
+- [ ] presentation_generator.py: Script to generate a formatted ROI presentation (e.g., markdown, HTML).
+- [ ] example_data_generator.py: Script to generate example ROI data for different industries.
--- a/skills/skill-adapter/scripts/helper-template.sh
+++ b/skills/skill-adapter/scripts/helper-template.sh
@@ -0,0 +1,42 @@
+#!/bin/bash
+# Helper script template for skill automation
+# Customize this for your skill's specific needs
+
+set -e
+
+function show_usage() {
+    echo "Usage: $0 [options]"
+    echo ""
+    echo "Options:"
+    echo "  -h, --help     Show this help message"
+    echo "  -v, --verbose  Enable verbose output"
+    echo ""
+}
+
+# Parse arguments
+VERBOSE=false
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -h|--help)
+            show_usage
+            exit 0
+            ;;
+        -v|--verbose)
+            VERBOSE=true
+            shift
+            ;;
+        *)
+            echo "Unknown option: $1"
+            show_usage
+            exit 1
+            ;;
+    esac
+done
+
+# Your skill logic here
+if [ "$VERBOSE" = true ]; then
+    echo "Running skill automation..."
+fi
+
+echo "✅ Complete"
--- a/skills/skill-adapter/scripts/validation.sh
+++ b/skills/skill-adapter/scripts/validation.sh
@@ -0,0 +1,32 @@
+#!/bin/bash
+# Skill validation helper
+# Validates skill activation and functionality
+
+set -e
+
+echo "🔍 Validating skill..."
+
+# Check if SKILL.md exists
+if [ ! -f "../SKILL.md" ]; then
+    echo "❌ Error: SKILL.md not found"
+    exit 1
+fi
+
+# Validate frontmatter
+if ! grep -q "^---$" "../SKILL.md"; then
+    echo "❌ Error: No frontmatter found"
+    exit 1
+fi
+
+# Check required fields
+if ! grep -q "^name:" "../SKILL.md"; then
+    echo "❌ Error: Missing 'name' field"
+    exit 1
+fi
+
+if ! grep -q "^description:" "../SKILL.md"; then
+    echo "❌ Error: Missing 'description' field"
+    exit 1
+fi
+
+echo "✅ Skill validation passed"