skills.rest
surfingalien
surfingalienCOMMUNITY
Explore all skills by this author →
GitHub

learn-rule

Capture mistakes and corrections as persistent categorized learning rules for future sessions.

1|Updated May 6, 2026
Search Tags:#workflow#memory#categorization#persistent memory#correction#learning rules#mistake capture
One-click install
npx skills add https://github.com/surfingalien/FinSurfing --skill learn-rule-surfingalien
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: learn-rule
Source: https://github.com/surfingalien/FinSurfing/tree/main/.claude/skills/learn-rule
Command: npx skills add https://github.com/surfingalien/FinSurfing --skill learn-rule-surfingalien

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Lessons learned during a session are lost when the session ends, causing the same mistakes to repeat. This Skill turns corrections into persistent, categorized rules that are stored and retrieved in future sessions. ## Core Features & Use Cases - Rule Capture: Formats a lesson as a [LEARN] entry with category, mistake, and correction fields. - Categorization: Organizes rules into eight categories including Navigation, Editing, Testing, Git, Quality, Context, Architecture, and Performance. - Wiki Scoping: Binds rules to a specific wiki via Wiki: <slug> so they load only when that project is in scope, avoiding cross-project pollution. - Use Case: After editing the wrong utils.ts file, the user says "remember this" and the Skill proposes a Navigation rule, waits for approval, then persists it to memory. ## Quick Start Tell the assistant "remember this: always confirm the full file path when multiple files share a name" and approve the proposed rule when prompted.

Frequently Asked Questions about learn-rule

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make an AI assistant remember a correction across sessions?▼

Use a learning rule capture workflow that formats the lesson as a [LEARN] entry with a category, the mistake, and the correction. After you approve the proposed rule, it is persisted to a LEARNED section or project memory and retrieved in future sessions.

How to scope a learned rule to a single project?▼

Append a Wiki: <slug> line to the rule to bind it to one wiki. The capture hook detects the slug and links the learning via learnings_wiki, so the rule loads only when that wiki is in scope.

What categories can a learning rule use?▼

Rules are grouped into eight categories: Navigation, Editing, Testing, Git, Quality, Context, Architecture, and Performance. Each rule should be one specific, actionable line rather than a vague guideline.

Does the skill save rules automatically without confirmation?▼

No. The workflow always proposes the rule and waits for explicit user approval before persisting anything. This guardrail prevents unwanted or incorrect rules from entering permanent memory.

What makes a good learning rule versus a bad one?▼

A good rule is one line, specific, and actionable, such as "Always use snake_case for database columns". A bad rule is vague, like "Write good code", and lacks the mistake context needed to apply it later.

Related Skills

Explore More Software Engineering Skills→
ai-analyst-labai-analyst-lab
21

log-correction

Log analyst errors with fixes, datasets, and severity for review.

Official
Intermediate
AlexanderRadevichAlexanderRadevich

self-correction-loop

Detects user corrections, generalizes them into rules, and stores them in MEMORY.md.

Community
Advanced
Shockwave2kShockwave2k

consolidate-memory

Merge duplicate memory topics and prune the MEMORY.md index.

Community
Intermediate
RhyTsuiRhyTsui

design-language-md

Generate or update a project-level DESIGN.md codifying reusable design-language conventions.

Community
Intermediate