metacognition

Convert experiences and feedback into evolving metacognitive perceptions and overrides.

12|1|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/velumkai/metacognition-skill --skill metacognition-velumkai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: metacognition
Source: https://github.com/velumkai/metacognition-skill/tree/main
Command: npx skills add https://github.com/velumkai/metacognition-skill --skill metacognition-velumkai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps an AI agent turn experiences and human corrections into a continuously improving metacognitive system, so it can learn from errors and preserve what works over time.

Core Features & Use Cases

  • Perception learning: Stores perception shifts that strengthen with reinforcement and decay when irrelevant.
  • Failure-driven guardrails: Records overrides that become non-negotiable behavioral constraints after failures.
  • Self-model & protected behaviors: Tracks what the agent knows about itself and what emergent behaviors must be preserved.
  • Decision tracing for auditing: Keeps decision entries tied to confidence (primarily for traceability).
  • Curiosity lifecycle: Maintains active curiosities that evolve with evidence and can resolve into perceptions or self-observations.
  • Feedback loop: Uses human feedback (e.g., “wrong”) to weaken specific active entries using Hebbian-style reinforcement/pruning.

Quick Start

Add a new perception by telling the agent: "After X, I now see Y differently" with a confidence score and an optional domain.

Frequently Asked Questions about metacognition

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a feedback loop for AI agent self-improvement?

To build a feedback loop for AI agent self-improvement, this skill converts human corrections and experiences into evolving perceptions, behavioral guardrails, and self-observations. It strengthens relevant entries through reinforcement and prunes outdated ones using time-based decay.

What is metacognitive tracking for autonomous agents?

Metacognitive tracking for autonomous agents records what an agent knows about itself, its protected behaviors, and decision confidence. It maintains a self-model that uses evidence and curiosities to continuously adapt operational constraints and perceptions.

How do I create behavioral guardrails from agent failures?

To create behavioral guardrails from agent failures, you record overrides during error-correction loops. These overrides become non-negotiable behavioral constraints that prevent the agent from repeating the same failure in future workflows.

Can I use a root SKILL.md entry point for agent metacognition?

Yes, you can use a root SKILL.md entry point with YAML frontmatter for agent metacognition. The skill compiles active metacognitive entries from memory storage into a lens for BOOT.md injection, enabling continuous self-correction.

Does confidence tracing work for auditing AI agent decisions?

Yes, confidence tracing works for auditing AI agent decisions by keeping decision entries tied to confidence scores. This provides clear traceability for error-correction loops and helps evaluate the reliability of autonomous behaviors.

How do I add a new perception to an AI agent?

To add a new perception to an AI agent, you tell the agent: "After X, I now see Y differently" with a confidence score and an optional domain. This creates a perception shift that strengthens with reinforcement and decays when irrelevant.