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

0•

Productivity & Workflow

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

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

01Automates Git commits for skill updates using semantic commit messages

02Extracts actionable coding rules from conversation history and user corrections

030 GitHub stars

04Requires explicit manual triggers to prevent unintended automation

05Manages persistent project-specific skill files including conventions and patterns

06Validates rules against a quality bar for durability and specificity

Use Cases

01Capturing architectural decisions to prevent the AI from suggesting legacy patterns

02Enforcing project-specific naming conventions or library choices across sessions

03Learning from manual corrections to avoid repeating the same mistakes in future tasks

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add richardhowes/self-improvement-code-quality-plugin reflection

For use in Claude.ai and ChatGPT

Download Skill