learn

Capture and persist conversation learnings into CLAUDE.md, SKILL.md, and repo notes.

1|Updated May 12, 2018
One-click install
npx skills add https://github.com/tbroadley/dotfiles --skill learn-tbroadley
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: learn
Source: https://github.com/tbroadley/dotfiles/tree/main/claude/skills/learn
Command: npx skills add https://github.com/tbroadley/dotfiles --skill learn-tbroadley

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps capture and persist actionable learnings from conversations to CLAUDE.md, skill-specific learnings, and repo documentation, reducing repetition and improving future sessions.

Core Features & Use Cases

  • Extract insights: Identify user feedback, surprising discoveries, and process preferences from conversations.
  • Organize learnings: Group insights into global rules, skill-specific notes, and repository-specific gotchas.
  • Apply changes: Update the global CLAUDE.md, the relevant skill's SKILL.md (claude/skills/learn/SKILL.md), and repo notes (AGENTS.md/CLAUDE.md) as appropriate.
  • Workflow automation: Commit and push changes, and propagate updates in dev containers using install.sh when available.

Quick Start

Use the learn skill to extract actionable learnings from this conversation and persist them to CLAUDE.md, the learn skill's SKILL.md, and repo notes (AGENTS.md/CLAUDE.md) for the current project.

Frequently Asked Questions about learn

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

FAQPage Schema
How do I save conversation learnings to CLAUDE.md automatically?

You can save conversation learnings to CLAUDE.md by using this Skill to extract actionable insights, organize them into global rules or repo-specific gotchas, and apply the updates directly to your project documentation files.

What's the best way to document repository gotchas from chat sessions?

Documenting repository gotchas from chat sessions is done by extracting surprising discoveries and process preferences, then writing them directly into repo notes like AGENTS.md or CLAUDE.md to prevent future repetition.

How does persisting knowledge to SKILL.md improve future coding sessions?

Persisting knowledge to SKILL.md improves future sessions by capturing skill-specific guidance and user feedback, ensuring the assistant applies learned preferences and avoids repeating past mistakes across different projects.

Can I commit and push documentation updates directly from a conversation?

Yes, you can commit and push documentation updates directly from a conversation. The Skill gathers context, drafts the changes, applies them to the relevant files, and commits the updates via git.

Do I need an install.sh script to propagate knowledge updates in dev containers?

You do not strictly need an install.sh script, but if one is available, the Skill uses it to automatically propagate the updated CLAUDE.md and repository notes across your dev containers.

How do I organize conversation insights into global rules versus skill-specific notes?

Organizing conversation insights involves grouping user feedback into global rules for general guidance, skill-specific notes for targeted SKILL.md updates, and repository-specific gotchas for project-level AGENTS.md files.