4-stage evaluation framework for testing Claude Code plugin component triggering. Validates skills, agents, and commands activate correctly via programmatic detection and LLM judgment.
git clone https://github.com/sjnims/cc-plugin-eval.gitThe cc-plugin-eval skill provides a robust 4-stage evaluation framework specifically designed for testing Claude Code plugin components. This skill enables developers and AI practitioners to ensure that skills, agents, and commands are activated correctly through both programmatic detection and LLM judgment. By implementing this framework, users can systematically validate their plugin functionality, ensuring a seamless integration into their existing workflows. One of the key benefits of the cc-plugin-eval skill is its ability to enhance the reliability of AI automation processes. While the exact time savings are not quantified, the structured evaluation reduces the likelihood of errors and the need for extensive debugging, ultimately leading to a more efficient development cycle. This skill is particularly beneficial for developers and product managers who are focused on maintaining high-quality standards in their AI projects, allowing them to allocate more time to innovation rather than troubleshooting. This skill is ideal for developers, product managers, and AI practitioners who are involved in creating or managing AI agents and automation workflows. Its intermediate complexity means that users should have a foundational understanding of Claude Code and AI automation principles, making it suitable for teams looking to enhance their AI-first workflows. By integrating the cc-plugin-eval skill, teams can improve their testing processes, leading to faster deployment and better-performing AI agents. Implementation of the cc-plugin-eval skill is straightforward, with an estimated time of 30 minutes to set up. This makes it an accessible option for teams looking to incorporate a reliable testing framework into their existing processes. As AI automation continues to evolve, having a structured approach to plugin evaluation will be crucial in ensuring that AI agents perform optimally, thereby enhancing overall productivity and effectiveness in AI-driven projects.
[{"step":1,"action":"Prepare your test environment: Install the [PLUGIN_NAME] plugin in Sortd for Gmail and ensure you have test data (emails, tasks, or workflows) ready. Enable debug logging in Sortd's settings to capture plugin triggers and outputs.","tip":"Use Sortd's 'Test Mode' to simulate real-world scenarios without affecting live data. Enable the 'AI Status Tracking' feature in Sortd's plugin settings to generate test data automatically."},{"step":2,"action":"Run the evaluation framework: Copy the prompt template above into your AI assistant (e.g., Claude or ChatGPT) and replace [PLUGIN_NAME], [TEST_CASE], [CRITERIA], and [TEST_DATA] with your specific plugin details. For example, [PLUGIN_NAME] = 'AI Status Tracking', [TEST_CASE] = 'Tag emails with urgency levels', and [CRITERIA] = 'accuracy > 95%, false positives < 2%'.","tip":"For Sortd plugins, use the 'Shared Inbox' feature to create test cases that mimic real team workflows. Include edge cases like empty emails or emails with attachments."},{"step":3,"action":"Execute the 4-stage evaluation: Stage 1 checks plugin detection, Stage 2 validates core functionality, Stage 3 assesses LLM judgment, and Stage 4 generates a report. Review the output for errors, false positives, or missed triggers.","tip":"Use Sortd's 'Activity Log' to cross-reference plugin triggers with the AI's output. If discrepancies are found, adjust the plugin's AI model or workflow rules and rerun the test."},{"step":4,"action":"Implement recommendations: Address any issues identified in the report (e.g., adjust AI thresholds, add manual review steps). Re-run the evaluation to confirm fixes, then deploy the plugin to production with monitoring enabled.","tip":"Set up Sortd's 'AI Monitoring Dashboard' to track plugin performance post-deployment. Use the 'Alerts' feature to notify your team of any failures or anomalies."},{"step":5,"action":"Schedule regular evaluations: Use the cc-plugin-eval framework weekly or after plugin updates to ensure ongoing reliability. Document results in Sortd's 'Workflow Documentation' section for team reference.","tip":"Automate the evaluation process by integrating cc-plugin-eval with Sortd's API. Schedule evaluations during off-peak hours to avoid disrupting team workflows."}]
No install command available. Check the GitHub repository for manual installation instructions.
git clone https://github.com/sjnims/cc-plugin-evalCopy the install command above and run it in your terminal.
Launch Claude Code, Cursor, or your preferred AI coding agent.
Use the prompt template or examples below to test the skill.
Adapt the skill to your specific use case and workflow.
Run a 4-stage evaluation of the [PLUGIN_NAME] plugin component in Sortd for Gmail using the cc-plugin-eval framework. Stage 1: Verify the plugin triggers correctly via programmatic detection (check plugin manifest, permissions, and activation logs). Stage 2: Validate the plugin's skill activation by testing its core functionality (e.g., task creation, email tagging, or workflow automation) with [TEST_CASE]. Stage 3: Assess LLM judgment by having the AI evaluate the plugin's output for accuracy, relevance, and adherence to [CRITERIA]. Stage 4: Generate a summary report including success rates, error logs, and recommendations for optimization. Use the following test data: [TEST_DATA].
### cc-plugin-eval Report: Sortd for Gmail - 'AI Status Tracking' Plugin **Stage 1: Programmatic Detection** - Plugin manifest verified: ✅ Valid JSON schema with required fields (`name`, `permissions`, `triggers`). - Permissions granted: ✅ `gmail.tasks`, `gmail.modify`, `sortd.api` (all scoped correctly). - Activation logs: ✅ Plugin triggered 12 times in the last 24 hours with no errors. - **Result**: Plugin is correctly installed and detectable. **Stage 2: Core Functionality Test** - Test Case: Automatically tag emails with 'Urgent' when AI detects complaint keywords (e.g., 'unhappy', 'disappointed'). - Input Email Subject: 'Customer Dissatisfaction with Order #12345' - Expected Output: Email tagged 'Urgent' and moved to 'High Priority' board in Sortd. - Actual Output: ✅ Tag applied within 1.2 seconds; email moved to 'High Priority' board. - **Result**: Core functionality working as expected. **Stage 3: LLM Judgment Evaluation** - Criteria: Accuracy of AI status detection (complaint vs. inquiry), relevance of tags, and adherence to Sortd's workflow rules. - AI Evaluation: - Complaint detection: ✅ Correctly identified as complaint (95% confidence). - Tagging: ✅ Applied 'Urgent' and 'Complaint' tags accurately. - Workflow adherence: ✅ Followed Sortd's 'High Priority' board rules. - **Result**: LLM judgment validated; output meets criteria. **Stage 4: Summary Report** - Success Rate: 98% (118/120 test cases passed). - Errors Detected: 2 instances where non-complaint emails were mislabeled as 'Urgent' (false positives). - Recommendations: 1. Adjust AI confidence threshold for complaint detection from 90% to 95% to reduce false positives. 2. Add a manual review step for emails tagged as 'Complaint' to ensure accuracy. 3. Monitor plugin performance over the next 7 days to validate improvements. **Final Verdict**: Plugin is production-ready with minor optimizations needed. Deploy with caution and monitor closely during the first week. --- *Generated by cc-plugin-eval (v1.2) for Sortd AI Assistant* *Next evaluation scheduled: 2023-11-15*
AI assistant built for thoughtful, nuanced conversation
Get more done every day with Microsoft Teams – powered by AI
Automate security compliance and monitor real-time security posture seamlessly.
Automate your spreadsheet tasks with AI power
Agentic AI Workflow platform
Connected workspace for docs, wikis, and projects
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan