lesson-write

Write or update lessons in the .compass/ vault with deduplication and formatting standards.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/hodor/claude-compass --skill lesson-write
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lesson-write
Source: https://github.com/hodor/claude-compass/tree/main/plugin/skills/lesson-write
Command: npx skills add https://github.com/hodor/claude-compass --skill lesson-write

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill ensures that lessons within the .compass/ vault are accurately documented, avoiding redundancy and maintaining an up-to-date repository of project knowledge.

Core Features & Use Cases

  • Lesson Creation and Update: Write or update lessons in the .compass/ vault, applying deduplication, anti-list filters, and 5-line body caps.
  • Automated Catalog and Index Updates: Automatically update the catalog and index after each write to keep the vault synchronized.
  • Recurrence Escalation: Handles recurring lessons and escalation if they are documented too vaguely or if search retrieval fails.
  • Called Programmatically: Designed to be called by extract-lessons and /compass:learned slash command, not for direct user interaction.

Quick Start

Run the 'extract-lessons' command to automatically gather lessons and then use '/compass:learned' to trigger the lesson-write skill to update the catalog and index.

Frequently Asked Questions about lesson-write

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

FAQPage Schema
How do I automate markdown lesson catalog updates in a project knowledge vault?

You can automate markdown lesson catalog updates by writing lesson files with deduplication filters and formatting standards, which then automatically synchronizes the vault index and catalog after each update.

What is the best way to prevent duplicate project knowledge lessons in markdown format?

Preventing duplicate project knowledge lessons requires applying deduplication and anti-list filters during the markdown write process, ensuring each lesson file adheres to strict formatting and 5-line body caps.

How does recurring lesson escalation work when project knowledge documentation is too vague?

Recurring lesson escalation triggers when documented project knowledge is too vague or search retrieval fails, escalating the entry to enforce stricter documentation standards during the vault update process.

Can I write lessons directly to the vault, or do I need to call it programmatically through another command?

You cannot write lessons directly; it is designed to be called programmatically by extract-lessons inputs and the learned slash command to automate vault catalog updates and maintain formatting standards.

Does vault management for project knowledge enforce body length limits on markdown lesson files?

Yes, vault management enforces a strict 5-line body cap on markdown lesson files to maintain formatting standards, prevent verbose project knowledge entries, and ensure clean catalog indexing.

Why does my project knowledge index not update after writing a new markdown lesson to the vault?

The project knowledge index fails to update if the markdown lesson write is not triggered programmatically via extract-lessons or the learned slash command, which are required to automate catalog and index synchronization.