Agent skill · operations · alirezarezvani
promote
Graduate a proven pattern from auto-memory (MEMORY.md) to CLAUDE.md or .claude/rules/ for permanent enforcement. Use when the user runs /si:promote or asks to make a learned behavior permanent.
Why this skill is useful
Adds a structured workflow for promoting learned behaviors into enforceable rules, which the AI wouldn't reliably generate on its own.
What it needs
About 3k tokens when loaded. Last updated 2026-08-05. 23,939 stars on the source repository.
What this skill does
/si:promote — Graduate Learnings to Rules Moves a proven pattern from Claude's auto-memory into the project's rule system, where it becomes an enforced instruction rather than a background note. Usage Workflow Step 1: Understand the pattern Parse the user's description. If vague, ask one clarifying question: "What specific behavior should Claude follow?" "Does this apply to all files or specific paths?" Step 2: Find the pattern in auto-memory Show the matching entries and confirm they're what the user means. Step 3: Determine the right target Pattern scope Target Example --- --- --- Applies to entire project ./CLAUDE.md "Use pnpm, not npm" Applies to specific file types .claude/rules/<topic>.md "API handlers need validation" Applies to all your projects ~/.claude/CLAUDE.md "Prefer explicit error handling" If the user didn't specify a target, recommend one based on scope. Step 4: Distill into a concise rule Transform the learning from auto-memory's note format into CLAUDE.md's instruction format: Before (MEMORY.md — descriptive): The project uses pnpm workspaces. When I tried npm install it failed. The lock file is pnpm-lock.yaml. Must use pnpm install for dependencies. After (CLAUDE.md — prescriptive): Rules for distillation: One line per rule when possible Imperative voice ("Use X", "Always Y", "Never Z") Include the command or example, not just the concept No backstory — just the instruction Step 5: Write to target For CLAUDE.md: 1. Read existing CLAUDE.md 2. Find the appropriate section (or create one) 3. Append the new rule under the right heading 4. If file would exceed 200 lines, suggest using .claude/rules/ instead For .claude/rules/: 1. Create the file if it doesn't exist 2. Add YAML frontmatter with paths if scoped 3. Write the rule content Step 6: Clean up auto-memory After promoting, remove or mark the original entry in MEMORY.md: Ask the user to confirm removal. Then edit MEMORY.md to remove the promoted entry. This frees space for new learnings. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills alirezarezvani/promote--fba904