Skip to content
cccskills
FreePublished on GitHub

reflect

Analyzes conversation transcripts to extract user corrections, patterns, and preferences, then proposes skill improvements. Use this skill when users provide corrections, express preferences about code style, or when patterns emerge from successful approaches. Can be triggered manually with /reflect or automatically at session end when enabled.

The English summary is being prepared. Showing the original description.

haddock-development/claude-reflect-system
See how to install

Files included (22)

  • SKILL.md2.8 KB
  • .state/auto-reflection.json54 B
  • .state/last-reflection.timestamp0 B
  • commands/reflect-meta.md1.6 KB
  • commands/reflect-promote.md1.8 KB
  • commands/reflect-stats.md772 B
  • README.md7.3 KB
  • references/signal-patterns.md6.0 KB
  • scripts/extract_signals.py12.3 KB
  • scripts/hook-stop.sh2.2 KB
  • scripts/learning_ledger.py12.6 KB
  • scripts/meta_learning.py14.8 KB
  • scripts/present_review.py9.9 KB
  • scripts/promote_learning.py8.0 KB
  • scripts/reflect.py5.3 KB
  • scripts/scope_analyzer.py8.3 KB
  • scripts/semantic_detector.py8.1 KB
  • scripts/toggle-off.sh431 B
  • scripts/toggle-on.sh499 B
  • scripts/toggle-status.sh2.5 KB
  • scripts/update_skill.py8.2 KB
  • USER_GUIDE.md21.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Reflect - Self-Improving Skills

Overview

This skill enables Claude Code to learn from conversations by analyzing corrections, approvals, and patterns, then proposing updates to relevant skills. It implements a "correct once, never again" learning system.

Usage Modes

1. Manual Reflection (/reflect)

Trigger analysis of the current conversation:

/reflect [skill-name]
  • Without skill-name: Analyzes all skills used in conversation
  • With skill-name: Focuses on specific skill

2. Automatic Reflection

When enabled via /reflect-on, runs automatically at session end via Stop hook.

3. Toggle Commands

  • /reflect-on - Enable automatic reflection
  • /reflect-off - Disable automatic reflection
  • /reflect-status - Show current configuration

Confidence Levels

HIGH - Explicit corrections:

  • User contradicts Claude's approach with specific alternative
  • Pattern: "Don't do X, do Y instead"
  • Action: Direct updates with deprecation warnings

MEDIUM - Approvals and patterns:

  • User approves specific approach
  • Pattern succeeds multiple times
  • Action: Add to "Best Practices" section

LOW - Observations:

  • User questions or suggests alternatives
  • Pattern: "Have you considered..." or "Why not try..."
  • Action: Add to "Considerations" section

Workflow

  1. Signal Detection - Scan transcript for corrections/patterns
  2. Context Analysis - Extract 5-message context around signals
  3. Skill Mapping - Match signals to relevant skills
  4. Change Proposal - Generate diff of proposed updates
  5. User Review - Interactive approval with natural language editing
  6. Application - Safe YAML/markdown updates with backups
  7. Git Commit - Automatic commit with descriptive message

Scripts

Core Engine

  • scripts/reflect.py - Main orchestration logic
  • scripts/extract_signals.py - Pattern detection engine
  • scripts/update_skill.py - Safe skill file updates
  • scripts/present_review.py - Interactive review interface

Automation

  • scripts/hook-stop.sh - Stop hook integration
  • scripts/toggle-on.sh - Enable auto-reflection
  • scripts/toggle-off.sh - Disable auto-reflection
  • scripts/toggle-status.sh - Show status

Safety Features

  • Timestamped backups before all edits
  • YAML validation before writing
  • Lock files prevent concurrent runs
  • Graceful error handling with rollback
  • Git status checks before commits

References

See references/signal-patterns.md for detailed pattern library.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

python-project-creator

Free

Creates Python projects with proper structure, virtual environments, and dependency management. Use when users request to create a new Python project, set up a Python development environment, or initialize a Python application with standard tooling.

The English summary is being prepared. Showing the original description.

haddock-development/claude-reflect-system383Updated Jan 17, 2026

See all skills by haddock-development

Report a problem with this skill