lessons-capture

Retrieve and append agent-context lessons to guide ongoing workflows.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/j-mckerracher/agent-research --skill lessons-capture-j-mckerracher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lessons-capture
Source: https://github.com/j-mckerracher/agent-research/tree/main/dated-agents/4-6-2026/.claude/skills/lessons-capture
Command: npx skills add https://github.com/j-mckerracher/agent-research --skill lessons-capture-j-mckerracher

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Agent-scoped lessons retrieval and capture to ensure only relevant lessons are delivered and corrected lessons are appended for future runs.

Core Features & Use Cases

  • Scoped retrieval of applicable lessons by agent, stage, and task-context.
  • Immediate lesson capture after user corrections.
  • Append-only storage at agent-context/lessons.md with fallback artifact emission when writing is restricted.

Quick Start

Retrieve relevant lessons for the current task and then trigger lesson capture with a user correction.

Frequently Asked Questions about lessons-capture

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

FAQPage Schema
How do I capture and retrieve agent lessons for ongoing workflow improvement?

Agent lessons are captured and retrieved by fetching relevant context during workflow stages and appending new entries after user corrections to an append-only store for future runs.

What is scoped retrieval of agent-context lessons?

Scoped retrieval delivers only applicable lessons filtered by agent, workflow stage, and task-context, ensuring bounded-context delivery instead of irrelevant information overload.

How do I store agent lessons when direct file writing is restricted?

When direct append is unavailable, agent lessons use fallback artifact emission to preserve captured corrections without requiring write access to the append-only store.

When do I need to capture lessons during agent workflows?

Lesson capture applies during intake, planning, assignment, execution, QA, and lessons-optimizer stages whenever a user correction provides feedback worth preserving for future runs.

Can I integrate a Reference Librarian for bounded-context lesson delivery?

Yes, the Skill integrates with a Reference Librarian to handle scoped retrieval and bounded-context delivery of agent lessons stored at agent-context/lessons.md.

What are the limitations of append-only lesson storage?

Append-only storage at agent-context/lessons.md requires write access for direct capture; when restricted, fallback artifact emission is used, and retrieval depends on Reference Librarian integration for scoped filtering.