plugin-testing

name	plugin-testing
description	Master plugin testing, quality assurance, and validation. Learn unit testing, integration testing, and how to ensure plugin quality.

Plugin Testing

Quick Start

Test your plugin:

# 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:

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:

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

{
  "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

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

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

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

❌ Error in plugin.json line 15
  Missing comma after "name": "value"

Fix:
  "name": "value",  ← Add comma
  "version": "1.0.0"

File Not Found

❌ Agent agents/missing.md referenced but not found

Fix:
  1. Create the file, OR
  2. Remove reference from plugin.json

Invalid YAML

❌ 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

⚠️  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

Agent initialization:   < 500ms ✅
Skill loading:         < 300ms ✅
Command execution:     < 2s   ✅
Overall workflow:      < 5s   ✅

Size Limits

Agent files:    < 400 lines ✅
Skill files:    < 300 lines ✅
Command files:  < 150 lines ✅
Manifest:       < 50KB      ✅

Automated Testing

Test Command

# 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

✅ Structure tests
✅ Content validation
✅ Format checking
✅ Reference validation
✅ Performance baseline
✅ Integration tests

Pre-Deployment Testing

Checklist

[ ] 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

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