Remember Skill

Stores user preferences, conventions, and project-specific instructions in the appropriate CLAUDE.md file with proper wording and placement.

When This Skill Applies

Use this skill when the user:

• •Says "remember that...", "remember to...", "note that..."
• •Asks to "add this to CLAUDE.md"
• •Says "don't forget..." or "keep in mind..."
• •Wants to store a preference, convention, or instruction
• •Mentions something should be remembered for future sessions

Execution Steps

1. Parse the Memory

Extract the core information to remember:

• •What: The specific fact, preference, or convention
• •Context: Why it matters or when it applies
• •Scope: Project-specific or general preference

2. Locate the CLAUDE.md File

Check for CLAUDE.md in this order:

1. •Project root: ./CLAUDE.md
2. •Project .claude dir: ./.claude/CLAUDE.md
3. •If neither exists, create ./.claude/CLAUDE.md

Important: Do NOT modify the global ~/.claude/CLAUDE.md unless the user explicitly says the memory is global/applies to all projects.

3. Read Existing Content

Read the current CLAUDE.md to understand:

• •Existing sections and structure
• •Writing style and tone
• •Where the new memory fits best

4. Determine Placement

Place the memory in the most appropriate section:

If no matching section exists:

• •Add to an existing related section, OR
• •Create a new appropriate section

5. Word Appropriately

Transform the user's casual statement into a clear instruction:

User says: "remember I hate semicolons" Store as: "Omit semicolons in JavaScript/TypeScript (Prettier handles this)"

User says: "remember the API uses snake_case" Store as: "API responses use snake_case - convert to camelCase in frontend code"

User says: "don't forget to run tests before committing" Store as: "Run npm test before committing changes"

Guidelines:

• •Use imperative mood for instructions
• •Be specific and actionable
• •Include the "why" if the user provided it
• •Keep it concise but complete
• •Match the existing document's tone

6. Apply the Edit

Use the Edit tool to add the memory to CLAUDE.md:

• •Add under the appropriate section heading
• •Use consistent formatting (bullets, etc.)
• •Preserve existing content

7. Confirm to User

After adding, confirm what was stored and where:

Added to .claude/CLAUDE.md under "## Code Style":
- Omit semicolons in JavaScript/TypeScript

Examples

Example 1: Code Preference

User: "remember that I prefer functional components over class components"

Action: Add to ## Code Style or ## React section:

- Prefer functional components with hooks over class components

Example 2: Project Convention

User: "remember the database uses soft deletes"

Action: Add to ## Database or ## Architecture section:

- Database uses soft deletes (`deleted_at` timestamp) - never use hard DELETE

Example 3: Workflow Note

User: "don't forget that PR reviews require two approvals"

Action: Add to ## Workflow or ## Process section:

- Pull requests require two approvals before merging

Example 4: Avoid Pattern

User: "remember never to use any type"

Action: Add to ## TypeScript or ## Avoid section:

- Never use `any` type - use `unknown` if type is genuinely uncertain

Edge Cases

Empty or Missing CLAUDE.md

If no CLAUDE.md exists:

1. •Create ./.claude/CLAUDE.md
2. •Add a minimal header:

# Project Instructions

## Notes
- [the memory]

Duplicate Information

If similar information already exists:

• •Update the existing entry rather than adding a duplicate
• •Merge information if the new memory adds detail

Ambiguous Scope

If unclear whether memory is project-specific or global:

• •Default to project-specific (safer)
• •Ask user to clarify if it seems important

User Says "Always" or "Never"

Treat strong preferences seriously:

• •"Always" → Add as a clear instruction
• •"Never" → Add to an ## Avoid section or phrase as "Do not..."

Success Criteria

Memory storage is successful when:

• •Memory is placed in a logical section
• •Wording is clear and actionable
• •Existing content is preserved
• •User is informed of what was stored and where
• •Future Claude sessions will see and follow the instruction