metacognition

Validate AI agent task approach and assumptions using a structured protocol.

48|5|Updated Sep 16, 2025
One-click install
npx skills add https://github.com/shinpr/agentic-code --skill metacognition
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: metacognition
Source: https://github.com/shinpr/agentic-code/tree/main/.agents/skills/metacognition
Command: npx skills add https://github.com/shinpr/agentic-code --skill metacognition

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured protocol for AI agents to self-assess their understanding, approach, and assumptions before, during, and after task execution, preventing errors and ensuring alignment with project goals.

Core Features & Use Cases

  • Mandatory Checkpoints: Enforces critical assessment at key stages like task changes, error occurrences, or phase transitions.
  • Assessment Questions: Guides the AI through a series of questions covering task understanding, current state, and approach validation.
  • Rule Selection Guide: Recommends relevant rules based on task type and outlines a progressive loading strategy.
  • Error Recovery Protocol: Defines steps for AI to take when encountering blockers or errors, including when to ask for user help.
  • Use Case: Before an AI begins implementing a new feature, it runs through the metacognition protocol to validate its understanding of the requirements and its planned approach, ensuring it doesn't proceed with a flawed strategy.

Quick Start

Run the metacognition skill to assess your current task and approach.

Frequently Asked Questions about metacognition

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

FAQPage Schema
How do I validate AI assumptions before starting a complex development task?

To validate AI approach before execution, apply a structured metacognition protocol enforcing self-assessment checkpoints covering task understanding, current state, and approach validation. This ensures the AI agent verifies its strategy, preventing errors and aligning with project goals before implementation begins.

What's the best way to handle AI workflow errors and phase transitions?

Handling AI workflow errors and phase transitions requires an error recovery protocol with mandatory assessment checkpoints. It defines structured steps for the AI agent to take when encountering blockers, including specific triggers for when to ask for user help during task changes or error occurrences.

When do I need self-assessment checkpoints in an AI development workflow?

Self-assessment checkpoints are needed in an AI development workflow at critical stages like task changes, error occurrences, and phase transitions. Applying a metacognition protocol at these mandatory checkpoints prevents the AI agent from proceeding with a flawed strategy.

Does this metacognition protocol apply to all task types in software engineering?

Yes, the metacognition self-assessment protocol applies to all task types, error handling, and phase transitions within an AI development workflow. It requires adherence to defined assessment questions, rule selection guides, and error recovery steps regardless of the specific software engineering task.

How do I guide an AI agent to select the right rules for a new feature implementation?

To guide an AI agent to select the right rules for feature implementation, use a rule selection guide within a metacognition protocol. It recommends relevant rules based on task type and outlines a progressive loading strategy to validate the planned approach before execution.