unifi-mcp-server: Skill for Claude Code

source-command-unifi-mcp-test-coverage

Use this skill when the user asks to run the migrated source command unifi-mcp-test-coverage.

Command Template

Analyze test coverage for the UniFi MCP Server and identify areas needing improvement.

This command runs comprehensive coverage analysis and provides actionable recommendations to reach the 80% coverage target.

Steps to execute:

1. Run full test suite with detailed coverage:

   pytest --cov=src --cov-report=term-missing --cov-report=html --cov-report=json -v
   

2. Analyze coverage by module:

   • Parse coverage.json to extract per-file coverage percentages
   • Identify modules below 80% threshold
   • Prioritize based on TESTING_PLAN.md priorities

3. Generate coverage gap analysis:

   • List files with coverage < 80%
   • Show missing lines for each file
   • Calculate how many tests needed to reach 80%

4. Read TESTING_PLAN.md to understand priorities:

   • Phase 1 (Critical): API client, config, webhooks
   • Phase 2 (High): Tool modules by usage frequency
   • Phase 3 (Medium): Utility modules
   • Phase 4 (Low): Edge cases and error scenarios

5. Provide actionable recommendations:

   • Which module to focus on next
   • Specific functions/lines that need tests
   • Suggested test scenarios to add
   • Estimated effort (number of tests needed)

6. Compare with previous coverage:

   • Show coverage trend (if available)
   • Highlight improvements or regressions

Report back with:

• Current overall coverage percentage
• Coverage by category:
  • API client modules
  • Tool modules (by category)
  • Model modules
  • Utility modules
  • Webhook modules
• Top 5 files needing the most coverage
• Recommended next steps based on TESTING_PLAN.md
• Estimated tests needed to reach 80%

Example output:

Current Coverage: 34.10%
Target: 80%
Gap: 45.90%

Coverage by Category:
✓ Models: 86.62% (above target)
✗ API Client: 45.23% (needs +34.77%)
✗ Tools: 38.54% (needs +41.46%)
✗ Webhooks: 12.00% (needs +68.00%)

Top Priority Files (from TESTING_PLAN.md Phase 1):
1. src/api/client.py - 45.23% (55 missing lines)
   - Need tests for: rate limiting, error handling, retry logic
2. src/config/settings.py - 60.00% (20 missing lines)
   - Need tests for: environment variable loading, validation
3. src/webhooks/receiver.py - 12.00% (88 missing lines)
   - Need tests for: webhook validation, signature checking

Next Action: Focus on src/api/client.py
Estimated effort: 8-10 test cases
Expected coverage gain: +11.13%