Claude Skills
CollectionsCompareWorkflowsNominate
Sign inSign up
© 2026 Curated Agent Skills·Learn more about Agent Skills
Back to repository

reflect-check

verified

Diagnostic tool for validating SpecWeave reflection system health and troubleshooting issues. Use when reflection seems stuck, learnings aren't being captured, or CLAUDE.md Skill Memories aren't updating. Checks configuration, permissions, and system state.

View on GitHub

Marketplace

specweave

anton-abyzov/specweave

Plugin

sw

development

Repository

anton-abyzov/specweave
31stars

plugins/specweave/skills/reflect-check/SKILL.md

Last Verified

February 3, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/anton-abyzov/specweave/blob/main/plugins/specweave/skills/reflect-check/SKILL.md -a claude-code --skill reflect-check

Installation paths:

Claude
.claude/skills/reflect-check/
Powered by add-skill CLI

Instructions

# Reflect Health Check

**Version**: 2.0.0
**Category**: Diagnostics
**Status**: Active

## Purpose

Diagnostic command to validate reflection system health and troubleshoot issues.

## Activation Triggers

**Primary keywords**:
- `reflect-check`
- `reflect check`
- `check reflect`
- `reflection health`
- `reflect 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:

1. **Config validation**: Checks `.specweave/config.json` reflect settings
2. **CLAUDE.md check**: Verifies Skill Memories section exists
3. **Recent activity**: Shows learnings in CLAUDE.md
4. **Hook status**: Verifies reflection hooks are working

## Execution

When activated, check these items in order:

1. Read `.specweave/config.json` for reflect configuration
2. Read `CLAUDE.md` for Skill Memories section
3. Count learnings per skill category
4. Report any issues found

## Output Format

```
REFLECT HEALTH CHECK

Configuration
   Reflection:      Enabled
   Model:           haiku
   Max/session:     3

CLAUDE.md Status
   Skill Memories:  Found
   Total learnings: 5 across 3 skills

   - devops: 1 learning
   - frontend: 2 learnings
   - general: 2 learnings

Last modified: 2026-01-29

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

- Config exists with reflect enabled
- CLAUDE.md has Skill Memories section
- Learnings are being added
- Clear actionable recommendations if issues found

## Related

- `/sw:reflect` - Manual reflection
- `/sw:reflect-status` - Show config and stats

## Project-Specific Learnings

**Before starting work, check for project-specific learnings:**

```ba

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
2290 chars