- name
- metaskill
- description
- Teaches AI agents how to learn better by enforcing deep correction, transfer learning, and proactive pattern recognition. Use when an error occurs and needs deep analysis (not surface patch), before starting a complex task to check past analogies, or after success to capture winning patterns. NOT for routine file reads or simple one-off commands.
Metaskill
3 Core Components
- Deep Self-Correction (
deep-correct.sh) — 3-level breakdown on errors:
- Surface: What specifically failed - Principle: The underlying rule/constraint violated - Habit: Concrete behavioral change to prevent recurrence
- Transfer Learning (
transfer-check.sh) — Before a task, search past learnings for analogous patterns. Maps domains (e.g., "auth" → "security") to prevent siloed learning.
- Proactive Pattern Recognition (
success-capture.sh) — Log what worked and why, building a repository of successful patterns.
Usage
# When an error occurs
bash skills/metaskill/scripts/deep-correct.sh "description of the error"
# Before starting a complex task
bash skills/metaskill/scripts/transfer-check.sh "description of the new task"
# After successful execution
bash skills/metaskill/scripts/success-capture.sh "what worked" "why it worked"
# Monthly health eval
bash skills/metaskill/scripts/eval.sh --saveConfiguration (LLM Provider)
Metaskill uses two provider tiers — fast (extraction) and deep (transfer/eval). Edit config.yaml to match your setup:
# config.yaml
providers:
fast: anthropic # change to: openai | ollama | gemini
deep: anthropic| Provider | Env Var | Notes |
|---|---|---|
anthropic | ANTHROPIC_API_KEY | Default |
openai | OPENAI_API_KEY | |
ollama | *(none needed)* | Local, free |
gemini | GOOGLE_API_KEY |
Ollama example (fully local, no API key):
providers:
fast: ollama
deep: ollama
models:
ollama:
fast: llama3.2
deep: llama3.1:70bIf no provider is available, metaskill falls back to manual/heuristic mode (still works, but less precise extraction).
Integration with Self-Improving-Agent
Writes to skills/self-improving-agent/.learnings/ if present, otherwise falls back to its own .learnings/ directory. No extra setup needed.
AGENTS.md Wiring (Mandatory)
Add to pre-task checklist:
- Run
transfer-check.shbefore any major task - Run
deep-correct.shimmediately after any error (not just LEARNINGS.md append) - Run
success-capture.shafter complex task completes successfully