Plugin Testing
Quick Start
Test your plugin:
bash
# Validate structure /test-plugin my-plugin # Run all tests /test-plugin my-plugin --all # Detailed report /test-plugin my-plugin --report
Testing Levels
Unit Tests
Test individual components:
markdown
Agent: ✅ Description present and valid ✅ Capabilities list complete ✅ Content properly formatted ✅ Status and date included Skill: ✅ Name lowercase-hyphens ✅ Quick Start code runs ✅ 3+ concepts documented ✅ Real projects included Command: ✅ Executes without error ✅ Options documented ✅ Example output provided
Integration Tests
Test component interactions:
markdown
Agent → Agent: ✅ Agent A links to Agent B ✅ Both agents available ✅ Integration documented Agent → Skill: ✅ Agent recommends skill ✅ Skill accessible ✅ Connection clear Command → Agent: ✅ Command invokes agent ✅ Agent responds appropriately ✅ Workflow makes sense
Test Checklist
Structure Tests
json
{
"manifest_valid": {
"description": "plugin.json valid JSON",
"check": "JSON.parse(plugin.json)"
},
"files_exist": {
"description": "All referenced files exist",
"check": "For each agent/skill/command file"
},
"naming_correct": {
"description": "Files follow naming conventions",
"check": "lowercase-hyphens pattern"
},
"references_valid": {
"description": "All manifested references valid",
"check": "Check each file path"
}
}
Content Tests
markdown
Agent: ✅ YAML frontmatter valid ✅ Description < 1024 chars ✅ Capabilities 5-10 items ✅ Content 250-400 lines ✅ Markdown properly formatted Skill: ✅ YAML frontmatter valid ✅ Name < 64 chars, lowercase ✅ Quick Start code works ✅ Core concepts explained ✅ Real projects included Command: ✅ Markdown valid ✅ Usage clear ✅ Options documented ✅ Example provided ✅ Next steps suggested
Functionality Tests
markdown
Agent Invocation: ✅ Agent loads without error ✅ Content renders correctly ✅ Integrations accessible ✅ No broken links Skill Loading: ✅ Skill accessible from agent ✅ Code examples accurate ✅ Links functional ✅ Metadata correct Command Execution: ✅ Command recognized ✅ Options work as documented ✅ Output as expected ✅ Next steps provided
Test Report Example
Full Test Report
markdown
PLUGIN TEST REPORT ═══════════════════════════════════════ Plugin: my-plugin Version: 1.0.0 Date: 2025-01-18 STRUCTURE TESTS ✅ Manifest valid (5/5) ✅ Files exist (8/8) ✅ Naming correct (6/6) ├─ Result: PASS CONTENT TESTS ✅ Agents valid (3/3) ✅ Skills valid (5/5) ✅ Commands valid (4/4) ├─ Result: PASS FUNCTIONALITY TESTS ✅ Agents invoke (3/3) ✅ Skills load (5/5) ✅ Commands execute (4/4) ├─ Result: PASS QUALITY SCORE: 98% ✅ READY FOR PRODUCTION: YES ✅ ═══════════════════════════════════════
Common Test Failures
JSON Syntax Error
code
❌ Error in plugin.json line 15 Missing comma after "name": "value" Fix: "name": "value", ← Add comma "version": "1.0.0"
File Not Found
code
❌ Agent agents/missing.md referenced but not found Fix: 1. Create the file, OR 2. Remove reference from plugin.json
Invalid YAML
code
❌ Invalid YAML in agents/agent.md Fix: - Check indentation (use spaces, not tabs) - Ensure quotes around values with special chars - Verify array syntax with dashes
Content Too Short
code
⚠️ Warning: Skill content only 150 lines Recommended: 200-300 lines Fix: - Add more examples - Expand core concepts - Include more projects
Performance Testing
Load Time Baseline
code
Agent initialization: < 500ms ✅ Skill loading: < 300ms ✅ Command execution: < 2s ✅ Overall workflow: < 5s ✅
Size Limits
code
Agent files: < 400 lines ✅ Skill files: < 300 lines ✅ Command files: < 150 lines ✅ Manifest: < 50KB ✅
Automated Testing
Test Command
bash
# Quick test (5 min) /test-plugin my-plugin # Full test (10 min) /test-plugin my-plugin --full # Continuous monitoring /test-plugin my-plugin --watch
Test Categories
code
✅ Structure tests ✅ Content validation ✅ Format checking ✅ Reference validation ✅ Performance baseline ✅ Integration tests
Pre-Deployment Testing
Checklist
markdown
[ ] All structure tests pass [ ] All content validation passes [ ] No broken references [ ] Performance acceptable [ ] Documentation complete [ ] Examples working [ ] Error messages helpful [ ] Integration smooth [ ] User acceptance tested [ ] Ready for marketplace
Release Testing
code
Before release: ✅ Version bumped ✅ CHANGELOG updated ✅ All tests passing ✅ Documentation updated ✅ Examples verified ✅ Performance baseline met ✅ Code reviewed
Use this skill when:
- •Testing plugin components
- •Validating structure
- •Checking quality
- •Before deployment
- •Finding and fixing issues
Status: ✅ Production Ready | SASMP: v1.3.0 | Bonded Agent: 04-plugin-tester