How plitzen85/aprende-skill works
aprende is a Markdown-based agent skill for turning conversation corrections into confirmed, reusable knowledge. The main workflow reviews a session, presents candidate learnings for user selection, then writes them to memory, lesson, skill-stub, or project-document destinations. Optional hooks capture error signals and remind users to run the workflow; review and portable export are additional capabilities. Relationships below are documented in the README; source excerpts were not provided.
Main entry points: SKILL.md Aprende skill · stop-suggest.sh Stop reminder hook · review-workflow.md Lesson review · capture-signal.sh Capture signal hook
Components 23
Learning workflow
- Aprende skill
skills/aprende/SKILL.md - Lesson review
skills/aprende/references/review-workflow.md - Confirmation prompt
skills/aprende/prompts/confirmation-template.md
Knowledge formats
- Memory format
skills/aprende/references/memory-format.md - Lesson format
skills/aprende/references/lesson-format.md - Signal patterns
skills/aprende/references/signal-patterns.md - Skill stub template
skills/aprende/references/skill-stub-template.md - Memory and lessons
- Skill stubs
- Project documents
- Portable lessons
Signal hooks
- Capture signal hook
hooks-handlers/capture-signal.sh - Signal log
- Stop reminder hook
hooks-handlers/stop-suggest.sh - Hook configuration
hooks/hooks.json
Commands and aliases
- Learn command
commands/aprende.md - Enable hooks command
commands/aprende-enable-hooks.md - Disable hooks command
commands/aprende-disable-hooks.md - English alias
skills/learn/SKILL.md
Other components
- User
- Conversation session
- Claude Code
- Codex
Connections 24
- User → Learn command: runs
README.md - Learn command → Aprende skill: invokes
README.md - Aprende skill → Conversation session: reviews
README.md - Aprende skill → Confirmation prompt: presents candidates
README.md - User → Confirmation prompt: selects learnings
README.md - Aprende skill → Memory and lessons: writes memories
README.md - Aprende skill → Memory and lessons: writes lessons
README.md - Aprende skill → Skill stubs: drafts stubs
README.md - Aprende skill → Project documents: dual-writes
README.md - Claude Code → Project documents: reads CLAUDE.md
README.md - Codex → Project documents: reads AGENTS.md
README.md - User → Lesson review: requests review
README.md - Lesson review → Memory and lessons: reviews lessons
README.md - User → Aprende skill: requests portable run
README.md - Aprende skill → Portable lessons: mirrors lessons
README.md - Portable lessons → Codex: provides lessons
README.md - Claude Code → Capture signal hook: dispatches after tools
README.md - Capture signal hook → Signal log: appends signals
README.md - Claude Code → Stop reminder hook: dispatches at stop
README.md - Stop reminder hook → Signal log: checks signals
README.md - Stop reminder hook → User: suggests learning
README.md - Enable hooks command → Hook configuration: installs entries
README.md - Disable hooks command → Hook configuration: removes entries
README.md - English alias → Aprende skill: aliases workflow
README.md