From fa57381c8f5a7d4c78d24f1c678f9726bd536ca7 Mon Sep 17 00:00:00 2001 From: Zhongwei Li Date: Sat, 29 Nov 2025 18:50:46 +0800 Subject: [PATCH] Initial commit --- .claude-plugin/plugin.json | 15 ++ README.md | 3 + commands/roi.md | 200 ++++++++++++++++++ plugin.lock.json | 85 ++++++++ skills/skill-adapter/assets/README.md | 7 + .../skill-adapter/assets/config-template.json | 32 +++ skills/skill-adapter/assets/skill-schema.json | 28 +++ skills/skill-adapter/assets/test-data.json | 27 +++ skills/skill-adapter/references/README.md | 7 + .../references/best-practices.md | 69 ++++++ skills/skill-adapter/references/examples.md | 70 ++++++ skills/skill-adapter/scripts/README.md | 7 + .../skill-adapter/scripts/helper-template.sh | 42 ++++ skills/skill-adapter/scripts/validation.sh | 32 +++ 14 files changed, 624 insertions(+) create mode 100644 .claude-plugin/plugin.json create mode 100644 README.md create mode 100644 commands/roi.md create mode 100644 plugin.lock.json create mode 100644 skills/skill-adapter/assets/README.md create mode 100644 skills/skill-adapter/assets/config-template.json create mode 100644 skills/skill-adapter/assets/skill-schema.json create mode 100644 skills/skill-adapter/assets/test-data.json create mode 100644 skills/skill-adapter/references/README.md create mode 100644 skills/skill-adapter/references/best-practices.md create mode 100644 skills/skill-adapter/references/examples.md create mode 100644 skills/skill-adapter/scripts/README.md create mode 100755 skills/skill-adapter/scripts/helper-template.sh create mode 100755 skills/skill-adapter/scripts/validation.sh diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json new file mode 100644 index 0000000..e59a7e5 --- /dev/null +++ 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" + ] +} \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..778e898 --- /dev/null +++ b/README.md @@ -0,0 +1,3 @@ +# roi-calculator + +Calculate and present ROI for AI automation projects diff --git a/commands/roi.md b/commands/roi.md new file mode 100644 index 0000000..41f3da9 --- /dev/null +++ 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. diff --git a/plugin.lock.json b/plugin.lock.json new file mode 100644 index 0000000..b3f5fb2 --- /dev/null +++ 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": [] + } +} \ No newline at end of file diff --git a/skills/skill-adapter/assets/README.md b/skills/skill-adapter/assets/README.md new file mode 100644 index 0000000..a5466d8 --- /dev/null +++ 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. diff --git a/skills/skill-adapter/assets/config-template.json b/skills/skill-adapter/assets/config-template.json new file mode 100644 index 0000000..16f1712 --- /dev/null +++ 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": [] + } +} diff --git a/skills/skill-adapter/assets/skill-schema.json b/skills/skill-adapter/assets/skill-schema.json new file mode 100644 index 0000000..8dc154c --- /dev/null +++ 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)" + } + } +} diff --git a/skills/skill-adapter/assets/test-data.json b/skills/skill-adapter/assets/test-data.json new file mode 100644 index 0000000..f0cd871 --- /dev/null +++ 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" + } +} diff --git a/skills/skill-adapter/references/README.md b/skills/skill-adapter/references/README.md new file mode 100644 index 0000000..c8aebd9 --- /dev/null +++ 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. diff --git a/skills/skill-adapter/references/best-practices.md b/skills/skill-adapter/references/best-practices.md new file mode 100644 index 0000000..3505048 --- /dev/null +++ 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 diff --git a/skills/skill-adapter/references/examples.md b/skills/skill-adapter/references/examples.md new file mode 100644 index 0000000..b1d8bd2 --- /dev/null +++ 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 diff --git a/skills/skill-adapter/scripts/README.md b/skills/skill-adapter/scripts/README.md new file mode 100644 index 0000000..c11ef5f --- /dev/null +++ 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. diff --git a/skills/skill-adapter/scripts/helper-template.sh b/skills/skill-adapter/scripts/helper-template.sh new file mode 100755 index 0000000..c4aae90 --- /dev/null +++ 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" diff --git a/skills/skill-adapter/scripts/validation.sh b/skills/skill-adapter/scripts/validation.sh new file mode 100755 index 0000000..590af58 --- /dev/null +++ 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"