learnings-write

Capture and validate project learnings into structured memory files.

2|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/alex-voloshin-dev/ai-skills --skill learnings-write
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: learnings-write
Source: https://github.com/alex-voloshin-dev/ai-skills/tree/main/plugin/skills/learnings-write
Command: npx skills add https://github.com/alex-voloshin-dev/ai-skills --skill learnings-write

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the problem of fragmented or lost project knowledge by providing a structured, validated, and deduplicated way to record lessons learned and architectural decisions directly into the project memory.

Core Features & Use Cases

  • Curated Knowledge Capture: Automatically spawns a memory-curator agent to deduplicate entries, filter PII, and validate against project schemas.
  • Multi-Layer Memory: Supports writing to project-specific (L4) memory or user-global (L5) memory for cross-project patterns.
  • Use Case: After resolving a complex bug or finalizing a major architectural choice, use this skill to ensure the decision is documented, validated, and searchable for the entire team.

Quick Start

Use the learnings-write skill to capture the lesson that our team chose gRPC over REST to improve client SDK friction.

Frequently Asked Questions about learnings-write

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

FAQPage Schema
How do I capture and document architectural decisions into project memory?

To document architectural decisions into project memory, use a structured curation process that validates schemas, filters PII, and deduplicates entries before appending to local memory files for searchable team access.

What is the best way to filter PII when saving project learnings?

Filtering PII when saving project learnings requires a dedicated curator agent that performs deduplication and PII filtering before appending validated data to memory stores, ensuring compliant knowledge management.

How does a curator agent deduplicate knowledge management entries?

A curator agent deduplicates knowledge management entries by spawning a dedicated process that validates incoming learnings against project schemas and existing memory files before appending, preventing fragmented records and maintaining a clean architectural decision store.

Can I write learnings to a global memory store for cross-project patterns?

Yes, you can write learnings to a user-global memory layer to store cross-project patterns. This operates alongside project-specific memory, allowing the curator agent to validate and persist broader architectural insights for cross-project knowledge management.

Do I need schema validation to record lessons learned?

Schema validation is required to record lessons learned. The memory-curator agent enforces schema compliance and memory-discipline rules to ensure structured, validated, and deduplicated data persistence across project-specific and global memory layers.

When should I not use automated curation for knowledge capture?

Automated curation for knowledge capture should be avoided when entries cannot adhere to memory-discipline rules or schema validation. The curator agent strictly enforces PII filtering and deduplication, which may reject non-compliant architectural decision inputs.