Repository navigation
🧠 A community skill for Claude Code & Codex that helps your agent learn from its mistakes.
🧠 Un skill comunitario para Claude Code & Codex que ayuda a tu agente a aprender de sus errores.
30-second pitch
You correct your agent. The session ends. Next week, you correct it again on the same thing.
aprende fixes that. Type /aprende at the end of a session — it scans the conversation, surfaces every correction worth preserving, asks you which to keep, and writes them where your agent will find them next time.
Corriges a tu agente. La sesión termina. La semana siguiente, lo corriges otra vez sobre lo mismo. aprende lo arregla. Escribe /aprende al final de una sesión — escanea, te propone, tú filtras, se guarda.
What's in this release
Core
- 5-pass workflow — scan → generate → dedup → confirm → execute
- 4 learning categories —
memory,lesson(Reflexion-style anti-pattern),skillstub,project-doc - Confirmation-first writes — nothing hits disk until you pick the items to keep
- Confidence labels mandatory — every candidate ships as
(high|medium|low); cap of 15 per run - Dedup annotates, never drops — overlaps are surfaced for you to decide
- Retire, don't delete — outdated lessons get
status: retired, kept for audit
Modes
/aprende— standard run/aprende --review— revalidate / retire / refresh existing lessons/aprende --portable— mirror lessons to./.aprende/for Codex/aprende --dry-run— preview without writing/learn— English alias
Cross-tool
- Dual-write to
CLAUDE.md+AGENTS.mdso Codex sees the same conventions - Plain Markdown + YAML — agentskills.io compatible
Hooks (ON by default, removable)
PostToolUseaccumulateserror→fixandrepeated-editsignals to a scratch fileStopreminds you to run/aprendeif signals went unreviewed- Hooks never write learnings — they only accumulate signals
Community
CONTRIBUTING.mdwith a "false positive reports are gold" framing- Issue templates:
false-positive,bug-report,feature-request - GitHub Actions CI validates JSON, bash syntax, and smoke-tests the hooks
- MIT license
Install
Plugin (recommended)
/plugin marketplace add Hainrixz/aprende-skill
/plugin install aprende@aprende-skill
Manual
git clone https://github.com/Hainrixz/aprende-skill.git
cp -r aprende-skill/skills/aprende ~/.claude/skills/
cp -r aprende-skill/skills/learn ~/.claude/skills/Full README: https://github.com/Hainrixz/aprende-skill#readme
Built on the shoulders of
- Reflexion (Shinn et al. 2023) — the linguistic post-mortem pattern that defines our
lessonformat - Hermes Agent (Nous Research) — synthesize skills from recurring workflows
- claude-reflect — confidence scoring against false positives
- claude-mem — hook-driven capture pattern
- The Claude Code memory system —
aprendeextends, doesn't replace
⭐ If aprende saved you from repeating a mistake
Star the repo and share it with someone whose agent keeps doing the same thing wrong.
Si aprende te salvó de repetir un error, dale una estrella y compártelo.