mcpField
L
learn

learn

github.com/yansfilAgent workflows043 installsUpdated 19w ago
Repository

About learn

A skill for turning verified implementation experience into proposed, reusable project guidance. It requires approval before changing durable files and includes checks to avoid duplicate or one-off lessons.

Key features

  1. 01Reviews changes and verification
  2. 02Extracts reusable lessons
  3. 03Proposes destinations for lessons
  4. 04Requires approval before edits
  5. 05Checks for duplicates and validates edits

Use cases

  1. 01Documenting a recurring implementation lesson
  2. 02Deciding whether a finding belongs in project rules or a task note

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/yansfil/vibe-engineering --skill learn

After installing, type/learnin Claude Code to confirm it loaded.

Details

From the project README

learn

Use this skill after implementation and verification when something should be remembered by the project.

Do not update durable project rules without user approval.

Workflow

  1. Review what changed, what failed, and what had to be verified.
  2. Extract only reusable learnings.
  3. Propose a destination for each learning.
  4. Ask for approval before editing durable files.
  5. After approval, read the target file first.
  6. Add the smallest useful rule and avoid duplicates.
  7. Run the smallest relevant validation after editing.

Candidate Destinations

  • CLAUDE.md: durable Claude Code project behavior.
  • docs/ or specs: product, data, runtime, or operational contracts.
  • .claude/skills/<name>/SKILL.md: recurring workflow changes.
  • A checklist or task-local note: useful but not yet durable enough.

Candidate Shape

- id: L1
  learning: ...
  destination: ...
  reason: ...
  minimal_edit: ...
  skip_if: ...

Rules

  • Keep only lessons likely to matter again.
  • Do not memorialize one-off accidents as permanent rules.
  • Prefer precise paths and commands over broad principles.
  • If the target already says the same thing, skip the edit and report it.
  • If a skill is changed, mention how to verify the new skill is loaded.

Output Format

## Learning Candidates

- ...

## Needs Approval

- ...

## Applied

- ...

## Skipped

- ...

Comments

Markdown supported