Graduate Learnings to Rules
This skill promotes proven patterns from Claude's auto-memory (MEMORY.md) into the project's rule system (CLAUDE.md or .claude/rules/) for permanent enforcement. It guides the user through finding the pattern, distilling it into a concise rule, writing it to the appropriate target, and cleaning up the memory file.
✨ What it does
- Searches MEMORY.md for related entries using grep.
- Determines the appropriate target based on scope (project-wide, file-type-specific, or global).
- Distills descriptive memory notes into concise, imperative rules.
- Writes rules to CLAUDE.md or .claude/rules/ with optional YAML frontmatter for path scoping.
- Cleans up auto-memory by removing or marking promoted entries after user confirmation.
- Provides a promotion decision guide to help decide when to promote.
🎯 When to use it
- When the user runs /si:promote or asks to make a learned behavior permanent.
- When a pattern has appeared multiple times in auto-memory and should become an enforced rule.
- When the user wants to convert a descriptive memory note into a prescriptive instruction for Claude.
- When deciding whether a learning belongs in CLAUDE.md or a scoped rule file.
🚀 How to use
Trigger: /si:promote
Trigger by running the slash command /si:promote with a pattern description, optionally specifying a target with --target. The skill expects a description of the behavior to promote, and optionally a target file (e.g., claude.md or rules/testing.md) and paths for scoping. If the description is vague, it will ask clarifying questions. Example prompts:
/si:promote Use pnpm instead of npm
/si:promote API handlers need validation --target rules/api.md --paths "src/api/**/*.ts"
📄 Output: A confirmation message summarizing the promoted rule, its target, and the cleanup of MEMORY.md.
📦 Add this skill to Claude Code
# 1. Get the skills repo
git clone --depth 1 https://github.com/alirezarezvani/claude-skills /tmp/claude-skills
# 2. Copy this skill into your project (or ~/.claude/skills for all projects)
mkdir -p .claude/skills
cp -r /tmp/claude-skills/engineering-team/self-improving-agent/skills/promote .claude/skills/promoteSkill source: engineering-team/self-improving-agent/skills/promote/SKILL.md
⚠️ Good to know
Requires access to the auto-memory file (MEMORY.md) and the project's rule files; the skill assumes the pattern is already recorded in auto-memory.
❓ FAQ
What is the difference between CLAUDE.md and .claude/rules/?
CLAUDE.md is for global project rules like build commands and architecture decisions, while .claude/rules/ is for file-type-specific patterns like testing conventions or API design rules.
When should I not promote a pattern?
Do not promote one-time debugging notes, session-specific context, patterns that might change soon, or those already covered by existing rules.
How does the skill clean up auto-memory?
After promoting, it shows the matching entries in MEMORY.md and asks the user to confirm removal, then edits the file to remove the promoted entry.
🤖 Overview, features, install steps and FAQ were generated from the project's SKILL.md on Sep 4, 2026. Always check the original source before running commands.