learn
/learn
Use when a user corrects, rejects, edits, or redirects an LLM/agent response and the correction should become a reusable reasoning strategy. Converts feedback into generalized learnings for ~/.agents/STEERING.md with linked RDF/Turtle evidence. USE FOR: user corrections, preference feedback, rejected agent behavior, reasoning strategy updates, steering file maintenance DO NOT USE FOR: storing task facts (use memory), ordinary skill authoring (use agent-skills), project instruction files unrelated to feedback (use agents-md)
- Author
- Tyler-R-Kendrick ↗
- Repository
- agent-skills ↗
- Licence
- MIT
- Last repository change
- 09.06.2026
Assessment and security
- Files in this package
- 20
- Scripts
- 2
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 09.06.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 2 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/src/learn.ts, scripts/test/learn.test.js
What it does and when to use it
Use when a user corrects, rejects, edits, or redirects an LLM/agent response and the correction should become a reusable reasoning strategy. Converts feedback into generalized learnings for ~/.agents/STEERING.md with linked RDF/Turtle evidence. USE FOR: user corrections, preference feedback, rejected agent behavior, reasoning strategy updates, steering file maintenance DO NOT USE FOR: storing task facts (use memory), ordinary skill authoring (use agent-skills), project instruction files unrelated to feedback (use agents-md)
Original author description
Use when a user corrects, rejects, edits, or redirects an LLM/agent response and the correction should become a reusable reasoning strategy. Converts feedback into generalized learnings for ~/.agents/STEERING.md with linked RDF/Turtle evidence. USE FOR: user corrections, preference feedback, rejected agent behavior, reasoning strategy updates, steering file maintenance DO NOT USE FOR: storing task facts (use memory), ordinary skill authoring (use agent-skills), project instruction files unrelated to feedback (use agents-md)
How it works
- Route
- Core Workflow
- Best Practices
SKILL.md preview
---
name: learn
description: |
Use when a user corrects, rejects, edits, or redirects an LLM/agent response and the correction should become a reusable reasoning strategy. Converts feedback into generalized learnings for ~/.agents/STEERING.md with linked RDF/Turtle evidence.
USE FOR: user corrections, preference feedback, rejected agent behavior, reasoning strategy updates, steering file maintenance
DO NOT USE FOR: storing task facts (use memory), ordinary skill authoring (use agent-skills), project instruction files unrelated to feedback (use agents-md)
license: MIT
metadata:
displayName: "Learn"
author: "Tyler-R-Kendrick"
tags:
- ai
- feedback
- steering
- learning
compatibility: claude, copilot, cursor
---
# Learn
Use this skill to turn a user correction into a generalized steering rule. Keep `STEERING.md` as an index, and keep details in linked RDF/Turtle files under `~/.agents/.steering/`.
This turns feedback loops into explicit, inspectable learnings. See [correction-to-learning.md](references/correction-to-learning.md) for the correction-to-learning model.
## Route
- IF the user corrects an agent response, read [correction-to-learning.md](references/correction-to-learning.md) and [zpd-teaching-loop.md](references/zpd-teaching-loop.md).
- IF creating or updating steering artifacts, read [steering-index-contract.md](references/steering-index-contract.md) and [rdf-contract.md](references/rdf-contract.md).
- IF using the deterministic helper, read [cli-usage.md](references/cli-usage.md) and run `node skills/ai/learn/scripts/dist/learn.js`.
- ELSE answer normally and do not create steering entries.
## Core Workflow
1. Identify the correction, the agent behavior it changes, and the broader class of future tasks it should affect.
2. Generalize the correction into a strategy or preference, not a one-off fact.
3. If memory is available, search for related prior corrections and add `memory://` evidence links; keep facts in memory, not in steering.
4. Add evidence links to docs, instruction files, conversations, or other sources.
5. Use the CLI to write the RDF entry and regenerate `STEERING.md`.
6. Briefly teach the agent what reasoning move to practice next time.
## Best Practices
- Always store durable learnings as generalized strategies or preferences, not isolated task facts.
- Keep `STEERING.md` as a conditional index and load linked RDF files only when the current task matches the entry.
- Require evidence links for every learning so agents can inspect provenance before relying on the rule.
- Use the zone of proximal development to explain the next reasoning move the correction teaches.
- Prefer deterministic CLI writes over manual steering edits to avoid broken links, duplicate IDs, or stale index rows.
Files in this package (20)
- AGENTS.md 2 KB
- README.md 1 KB
- SKILL.md 3 KB
- metadata.json 1 KB
- references/cli-usage.md 1 KB
- references/correction-to-learning.md 2 KB
- references/rdf-contract.md 2 KB
- references/steering-index-contract.md 2 KB
- references/zpd-teaching-loop.md 1 KB
- rules/_sections.md 1 KB
- rules/_template.md 1 KB
- rules/learn-always-store-durable-learnings-as-generalized-strategies-or.md 1 KB
- rules/learn-keep-steering.md 1 KB
- rules/learn-prefer-deterministic-cli-writes-over-manual-steering-edits.md 1 KB
- rules/learn-require-evidence-links-for-every-learning-so-agents-can.md 1 KB
- rules/learn-use-the-zone-of-proximal-development-to-explain-the-next.md 1 KB
- scripts/tsconfig.json 1 KB
- scripts/fixtures/sample-learning.json 1 KB
- scripts/src/learn.ts 18 KB
- scripts/test/learn.test.js 14 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · Tyler-R-Kendrick/agent-skills | 90 | MIT |
| lucamartins/ouroboros | 100 | MIT |
| boykush/scraps | 100 | MIT |
| nicsuzor/academicops | 100 | MIT |
| cookys/autopilot | 100 | MIT |
| joelhooks/PAROL6 | 100 | MIT |
| tw93/Waza | 100 | MIT |
| fainir/agent-harness | 100 | MIT |
| amit429/understanding-map | 100 | MIT |
Database snapshot: 13.11.2026 · package version 7f1025e039b0 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100self-improving-agent
Log learnings, errors, and corrections to .learnings/ for continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects the agent, (3) A knowledge gap is identified, (4) A better approach is found. Captures corrections, insights, errors, and… - 100kiro-steering
Maintain .kiro/steering/ as persistent project memory (bootstrap/sync). Use when initializing or updating steering documents. - 100steering-matcher
Match file paths against steering file glob patterns to determine applicable steering guidance. Use when you say "match steering for these files", "which steering applies to this task", or "inject steering context". Use when orchestrator needs to inject context-aware guidance… - 100steering-matcher
Match file paths against steering file glob patterns to determine applicable steering guidance. Use when you say "match steering for these files", "which steering applies to this task", or "inject steering context". Use when orchestrator needs to inject context-aware guidance… - 100kiro-steering-custom
Create custom steering documents for specialized project contexts. Use when creating domain-specific steering files. - 100rule-file-writing
Use when creating or optimizing a rule file for per-token behavioral steering. Rule files are instruction files that an AI coding assistant automatically loads for a matching user, project, or directory scope; they are NOT skills, agents, or commands. Trigger on "write a rule…