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.