aaronbassett/compact-reviewer:maintainability
plugins/compact-reviewer/skills/maintainability/SKILL.md
Use when reviewing Compact contracts for long-term maintainability, identifying technical debt, planning upgrade strategies, or assessing modularity and refactoring needs.
development
Updated Mar 26, 2026
$ install --global
skillsauthnpx skillsauth add aaronbassett/midnight-knowledgebase compact-reviewer:maintainabilityInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
4 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
4
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 16, 2026, 12:06 PM41.4s1 file scanned
SKILL.md
- name:
- compact-reviewer:maintainability
- description:
- Use when reviewing Compact contracts for long-term maintainability, identifying technical debt, planning upgrade strategies, or assessing modularity and refactoring needs.
Maintainability Skill
Evaluate long-term maintainability and identify technical debt.
When to Use
This skill activates for queries about:
- Long-term maintenance
- Technical debt
- Upgrade strategies
- Modularity
- Future changes
Trigger words: maintainability, technical debt, upgrade, modular, refactor, future-proof
Quick Reference
Maintainability Factors
| Factor | Good | Poor | |--------|------|------| | Modularity | Separated concerns | Monolithic | | Coupling | Loose | Tight | | Documentation | Current | Missing/stale | | Dependencies | Minimal | Excessive | | Complexity | Low | High |
Technical Debt Indicators
- Large circuits (>50 lines)
- Duplicated code
- Magic numbers
- Missing documentation
- Complex nesting
- Unclear names
Review Process
1. Modularity Assessment
Evaluate code separation:
- Single responsibility per circuit
- Clear module boundaries
- Minimal cross-dependencies
2. Change Impact Analysis
Consider future changes:
- How hard to add features?
- How hard to modify behavior?
- What breaks if X changes?
3. Debt Identification
Look for:
- TODOs and FIXMEs
- Commented-out code
- Workarounds
- Deprecated patterns
4. Upgrade Readiness
Check for:
- Version handling
- Migration paths
- Backward compatibility
References
- Modularity Guidelines - Module design
- Upgrade Patterns - Safe upgrades
Related Skills
- design-architecture - Structural design
- code-quality - Code organization
Related Skills
aaronbassett/midnight-tooling:midnight-setup
tools
VerifiedTrustedCommunity
Use when setting up Midnight development environment, installing Compact compiler and developer tools, configuring proof server, verifying prerequisites, or getting started with Midnight development.
SKILL.mdUpdated Mar 26, 2026
aaronbassett/plugins/midnight-tooling/skills/midnight-debugging
tools
VerifiedTrustedCommunity
--- name: midnight-tooling:midnight-debugging description: Use when encountering Midnight errors like "compact: command not found", "ERR_UNSUPPORTED_DIR_IMPORT", version mismatches, proof server failures, "@midnight-ntwrk" package errors, or compilation failures. --- # Midnight Environment Debugging Expert knowledge for identifying and resolving common Midnight development toolchain issues. ## Diagnostic Approach When encountering Midnight-related errors, follow this systematic approach: 1.
SKILL.mdUpdated Mar 26, 2026
aaronbassett/midnight-tooling:midnight-compatibility
tools
VerifiedTrustedCommunity
Use when checking Midnight version compatibility, understanding pragma language_version, verifying compiler and runtime version relationships, or troubleshooting version mismatch errors between Midnight components.
SKILL.mdUpdated Mar 26, 2026
aaronbassett/midnight-tooling:midnight-ci
tools
VerifiedTrustedCommunity
Use when setting up CI/CD for Midnight projects, configuring GitHub Actions for Compact contract compilation, running TypeScript tests in CI, validating version consistency, or automating contract builds.
SKILL.mdUpdated Mar 26, 2026