manage-learn

Append atomic learning insights to lessons.jsonl with stable INS-ids.

511|63|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/catlog22/Maestro-Flow --skill manage-learn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: manage-learn
Source: https://github.com/catlog22/Maestro-Flow/tree/main/.codex/skills/manage-learn
Command: npx skills add https://github.com/catlog22/Maestro-Flow --skill manage-learn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Captures lightweight, atomic learning insights produced during active work and stores them in a shared append-only lessons.jsonl so transient observations are not lost and can be referenced later.

Core Features & Use Cases

  • Capture: Record single insights with inferred category, tags, confidence, phase linking, and a stable INS-id without invoking LLMs.
  • List & Search: Query the learning-index.json and lessons.jsonl by tag, category, phase, lens, or free-text to find relevant insights.
  • Show: Retrieve the full record for an INS-id to inspect routing metadata and linked artifacts.
  • Use Case: While implementing a feature, capture a gotcha about a library behavior and later include it in a retrospective or quality report.

Quick Start

Use the manage-learn command to record an insight, for example: $manage-learn "Always read state.json before planning to detect current phase".

Frequently Asked Questions about manage-learn

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

FAQPage Schema
How do I capture and store team learning insights during active development?

Capture team learning insights by appending atomic observations, antipatterns, and tool notes as records with stable INS-ids into a shared lessons.jsonl file, ensuring transient project knowledge is not lost.

What is the best way to search a jsonl knowledge base for specific project gotchas?

Search a jsonl knowledge base by querying the learning-index.json file using tags, category, phase, lens, or free-text filters to retrieve relevant project gotchas and recorded decisions without invoking external agents.

Can I record development observations locally without relying on an LLM or external API?

Yes, you can record development observations locally without an LLM. The system performs pure file reads and writes, bootstrapping the learning directory and index heuristically while generating stable identifiers offline.

Does capturing atomic learning insights require a pre-existing index file?

No, capturing atomic learning insights does not require a pre-existing index file. The system automatically bootstraps the learning directory and generates the learning-index.json when missing during the capture process.

What metadata is inferred when logging a development decision to a jsonl file?

When logging a development decision to a jsonl file, the system heuristically infers the category and phase, assigns tags and confidence levels, and links artifacts to a generated stable INS-{8hex} identifier.

How do I retrieve the full record for a specific learning insight using its INS-id?

Retrieve the full record for a specific learning insight by using the show operation with its INS-id, allowing you to inspect routing metadata, inferred category, and linked artifacts stored in the jsonl file.