Skip to content

aprende v0.1.0 — initial release

Latest

Choose a tag to compare

@Hainrixz Hainrixz released this 12 May 05:02
· 4 commits to main since this release

🧠 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), skill stub, 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.md so Codex sees the same conventions
  • Plain Markdown + YAML — agentskills.io compatible

Hooks (ON by default, removable)

  • PostToolUse accumulates error→fix and repeated-edit signals to a scratch file
  • Stop reminds you to run /aprende if signals went unreviewed
  • Hooks never write learnings — they only accumulate signals

Community

  • CONTRIBUTING.md with 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


⭐ 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.

Made by tododeia · Maintained by @Hainrixz