skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
wyattowalsh/agents69 installs

learn

Capture corrections and patterns as reusable knowledge. Routes to the right instruction file. Use when patterns repeat 3+ times or to save insights. NOT for one-time fixes or code review.

How do I install this agent skill?

npx skills add https://github.com/wyattowalsh/agents --skill learn
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill facilitates the capture and promotion of project-specific insights into the agent's core instruction files. While it implements safety guardrails such as a frequency threshold (3+ occurrences) and mandatory user approval, the primary security risk is the potential for indirect prompt injection, where malicious text provided as a 'learning' could be persisted into permanent configuration files.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

  • Runlayerpass

    1/7 files flagged

What does this agent skill do?

Learn — Capture and Route Project Knowledge

Record corrections, insights, and patterns. Route them to the correct instruction file. Apply kaizen principles to keep instructions lean and effective.

Dispatch

$ARGUMENTSAction
"<correction text>"Route correction to appropriate instruction file
reviewShow pending learnings and their frequency
promotePromote high-frequency learnings (3+ occurrences) to instruction files
auditCheck for stale, contradictory, or duplicate learnings
EmptyDisplay usage summary

References

FilePurpose
references/routing-rules.mdDecision tree for where to route instruction changes
references/kaizen-principles.mdError-proofing patterns, when to use hooks vs prose vs rules

Routing Protocol

Route proposed updates to the correct target:

ScopeTarget
Cross-project conventionsinstructions/global.md
Language-specific toolingConvention skill (python-conventions, etc.)
Orchestration/parallelismorchestrator skill body
Project-specific standardsProject's AGENTS.md
File-scoped enforcement.claude/rules/<topic>.md
Skill behaviorThe skill's own SKILL.md

Routing Decision Steps

  1. Determine the scope: does this apply to all projects or just one?
  2. If cross-project, does it relate to a specific language or tool?
  3. If language-specific, route to the corresponding convention skill
  4. If general, route to instructions/global.md
  5. If project-only, route to the project's AGENTS.md
  6. If file-scoped enforcement only, create a .claude/rules/ entry

Kaizen Principles

  1. Incremental > revolutionary — Smallest viable change, verify before next
  2. Poka-yoke — Prefer hooks/tooling over prose instructions (error-proof by design)
  3. Standards work — Follow existing patterns, document what works
  4. JIT — Build only what is needed, optimize when measured

Verification Checklist

  1. Verify against actual practice — confirm the pattern reflects real usage
  2. Check for contradictions with existing instructions
  3. Assess token impact — keep always-loaded content minimal
  4. Get user approval — never modify instruction files without consent
  5. Test the change — run python scripts/check.py after any instruction file edit

Critical Rules

  1. Never modify instruction files without explicit user approval
  2. Require 3+ corrections across 2+ sessions before promoting
  3. Check for contradictions with existing instructions
  4. Route to narrowest applicable scope (rule before skill, skill before global)
  5. Keep always-loaded content under token budget
  6. Run python scripts/check.py after every instruction file modification
  7. Prefer hooks/rules over prose (poka-yoke principle)

Canonical Terms

  • instruction file — any file that provides agent instructions (global.md, AGENTS.md, SKILL.md)
  • routing — the process of choosing the correct target file for a change
  • correction pattern — a repeated fix that indicates a missing or wrong instruction
  • token budget — the limit on always-loaded instruction content
  • scope — cross-project, language-specific, orchestration, project-specific, or file-scoped

Validation Contract

Run from this skill directory before declaring changes complete:

python scripts/check.py

Completion criteria:

  1. scripts/check.py exits 0.
  2. No portable-CLI violations remain under this skill directory.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/wyattowalsh/agents/learn">View learn on skillZs</a>