learning-capture

Capture reusable workflows, conventions, and terminology from work sessions into persistent learning files.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill learning-capture-yuezhen-huang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: learning-capture
Source: https://github.com/yuezhen-huang/my-bytedance-skillhub/tree/main/learning-capture
Command: npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill learning-capture-yuezhen-huang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? AI agents repeat the same mistakes across conversations because lessons learned in one session are lost when it ends. This Skill persists error corrections, task workflows, codebase conventions, and domain terminology into structured files so future sessions start with accumulated knowledge. ## Core Features & Use Cases - Trigger-Based Capture: Activates after error recovery, when users share domain knowledge, or when existing captured learning becomes outdated. - Typed Learning Files: Classifies lessons into task workflows (task-<name>.md), repository/service conventions (convention-<name>.md), and a shared terminology.md, stored under ~/.agents/<workdir>/captured-learning/. - Memory Index Maintenance: Updates a Captured Learning section in AGENTS.md, CLAUDE.local.md, or MEMORY.md so relevant lessons are discoverable at session start. - Use Case: After a user corrects your log-search approach twice, capture the correct procedure as task-log-search.md with the error context, so the next session applies the right method immediately. ## Quick Start After I correct a mistake or share a team convention, capture the lesson into a persistent learning file and update the memory index.

Frequently Asked Questions about learning-capture

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

FAQPage Schema
How do I make an AI agent remember lessons across sessions?

Capture lessons as structured Markdown files in a persistent directory and index them in a memory file like AGENTS.md that loads at session start. Classify each lesson as a task workflow, convention, or terminology entry so it stays organized and retrievable.

When should a learning capture workflow be triggered?

Trigger it after error recovery involving multiple failed attempts, when the user shares domain terminology or conventions, or when an existing captured lesson turns out to be outdated. Skip trivial one-off fixes unlikely to recur.

How should captured task workflows be structured?

Use one file per task category with a purpose statement, a concise step list, and a lessons section recording what to do, what to avoid, and the original error context. Append new lessons over time and mark superseded ones with strikethrough.

Where are captured learning files stored?

Files are stored under ~/.agents/<workdir-with-dashes>/captured-learning/, with separate files per task category and per repository convention, plus one shared terminology.md. The index lives in the project's AGENTS.md, CLAUDE.local.md, or MEMORY.md.

What are the limitations of file-based learning capture?

It only persists what is explicitly captured at trigger time, so unrecognized lessons are still lost. It also depends on the agent scanning the memory index at session start, and stale entries require manual revision when practices change.