Skip to content
Skills Library
AI & agents · Automation

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)

Licence
MIT
Last repository change
09.06.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
20
Scripts
2
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 09.06.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 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

  1. Route
  2. Core Workflow
  3. Best Practices
Original SKILL.md headings · 31 lines, 272 words
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

RepositoryScoreLicence
This page · Tyler-R-Kendrick/agent-skills90MIT
lucamartins/ouroboros100MIT
boykush/scraps100MIT
nicsuzor/academicops100MIT
cookys/autopilot100MIT
joelhooks/PAROL6100MIT
tw93/Waza100MIT
fainir/agent-harness100MIT
amit429/understanding-map100MIT

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…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.