reflect-check
✓Verified·Scanned 2/17/2026
Diagnostic tool for validating SpecWeave reflection system health and troubleshooting issues. Use when reflection seems stuck, learnings aren't being captured, or MEMORY.md files aren't updating. Checks configuration, permissions, and system state.
from clawhub.ai·v79d391e·3.0 KB·0 installs
Scanned from 1.0.0 at 79d391e · Transparency log ↗
$ vett add clawhub.ai/anton-abyzov/reflect-check
Reflect Health Check
Version: 1.0.0 Category: Diagnostics Status: Active
Purpose
Diagnostic command to validate reflection system health and troubleshoot issues.
Activation Triggers
Primary keywords:
reflect-checkreflect checkcheck reflectreflection healthreflect statusreflect diagnostics
Natural language:
- "Check if reflection is working"
- "Why isn't reflection learning?"
- "Is auto-reflect enabled?"
- "Diagnose reflection issues"
- "Reflection not working"
What This Skill Does
Runs comprehensive health checks on the reflection system:
- Config validation: Checks reflect-config.json exists and is valid
- Script syntax: Validates reflect.sh has no syntax errors
- Recent activity: Shows last 10 reflection attempts
- Memory status: Lists memory files and learning counts
- Hook status: Verifies stop-reflect.sh is working
- Pre-flight checks: Runs same checks as stop-reflect.sh
Execution
When activated:
# Run health check
bash plugins/specweave/scripts/reflect-check.sh
Returns formatted health report with:
- ✅ Green checkmarks for passing checks
- ❌ Red X for failing checks
- 📊 Status information
- 💡 Suggestions for fixes
Output Format
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔍 REFLECT HEALTH CHECK
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ Configuration
Auto-reflect: ON
Max learnings: 10
Confidence: medium
✅ Script Syntax
reflect.sh: Valid
✅ Dependencies
jq: Found
bash: 5.2.26
📊 Recent Activity (last 10 attempts)
2026-01-07 08:00: Pre-flight checks passed
2026-01-07 07:30: No signals detected
...
📚 Memory Status
general.md: 4 learnings
testing.md: 3 learnings
git.md: 2 learnings
💡 RECOMMENDATIONS
- None - system healthy
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
When to Use
- Reflection seems stuck or not learning
- After marketplace updates
- User reports "reflection not working"
- Debugging silent failures
- Verifying system health
Success Criteria
- All checks pass (green checkmarks)
- Recent activity shows successful reflections
- Memory files are being updated
- Clear actionable recommendations if issues found
Related
/sw:reflect- Manual reflection/sw:reflect-status- Show config and statsstop-reflect.sh- Auto-reflection hook