How do I trigger the Reflection skill?

The skill only activates when you explicitly request it using phrases like 'reflect', 'remember this for next time', or 'update your skills'.

Does this skill automatically commit to Git?

Yes, it creates a separate commit with the prefix 'chore(skills)' whenever it updates your project's learned rules.

Can I use this on a new project that doesn't have a skills folder?

Yes, if the directory doesn't exist, the Reflection skill will automatically create the necessary folder structure and starter files.

Where are the learned rules stored?

Rules are saved directly in your project's repository within the .claude/skills/ directory, making them part of the codebase.

What happens if a new rule contradicts an existing one?

The skill performs a contradiction check against existing skill files and will ask the user to resolve the conflict before proceeding.

Project Reflection & Learning

Name: Project Reflection & Learning
Author: richardhowes

byrichardhowes

Productivity & Workflow

Automates project-specific learning by documenting user corrections and coding preferences into persistent skill files.

About

This meta-skill enables Claude Code to evolve alongside a project by capturing 'lessons learned' from developer feedback and session history. When explicitly triggered, it analyzes recent interactions to extract durable, actionable rules regarding coding standards, preferred libraries, and architectural patterns. It persists these insights into the project's local .claude/skills/ directory and automatically commits them to Git, ensuring that future AI sessions benefit from past corrections and adhere strictly to established project conventions.

Key Features

Automates Git commits for skill updates using semantic commit messages
Extracts actionable coding rules from conversation history and user corrections
0 GitHub stars
Requires explicit manual triggers to prevent unintended automation
Manages persistent project-specific skill files including conventions and patterns
Validates rules against a quality bar for durability and specificity

Use Cases

Capturing architectural decisions to prevent the AI from suggesting legacy patterns
Enforcing project-specific naming conventions or library choices across sessions
Learning from manual corrections to avoid repeating the same mistakes in future tasks

About

Key Features

Automates Git commits for skill updates using semantic commit messages
Extracts actionable coding rules from conversation history and user corrections
0 GitHub stars
Requires explicit manual triggers to prevent unintended automation
Manages persistent project-specific skill files including conventions and patterns
Validates rules against a quality bar for durability and specificity

Use Cases

Capturing architectural decisions to prevent the AI from suggesting legacy patterns
Enforcing project-specific naming conventions or library choices across sessions
Learning from manual corrections to avoid repeating the same mistakes in future tasks