agentleFS
deciqAIdeciqAI/knowledge-skills/metacognition/SKILL.md

metacognition

Skill13 starsChanged 4 months agoMITView on GitHub

Activate when: user says 'I'm stuck and don't know why', 'I keep making the same mistake', 'my analysis feels right but I'm not sure', 'am I solving the right problem', 'I should understand this but I don't', or asks about calibration / thinking about thinking.

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 5 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈5

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Check fit against When to Use / When NOT to use.

    line 35
  2. Distinctive:

    Run The Process one stage at a time with their input.

    line 38
  3. Distinctive:

    Run Pólya's Four-Stage Protocol with Explicit Monitoring (Pólya 1945 + Schoenfeld 1985).

    line 45
  4. Distinctive:

    Calibrate confidence explicitly: After any conclusion: *"How confident, 0–100?

    line 52
  5. Distinctive:

    No time-budget on current strategy · Deliberation > 1 week with no convergence

    line 105

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Metacognition

Overview

Metacognition is the live monitoring loop during reasoning — "am I doing this right now; what strategy am I using; should I switch?" — not after-the-fact reflection. Coined by Flavell (1979); operationalized by Pólya's 1945 four-stage protocol; empirically validated by Schoenfeld (1985): experts spend 30–40% of problem-solving time monitoring; novices spend 5%. The expert-novice gap is less raw knowledge than this loop.

Compose: first-principles to interrogate assumptions · probabilistic-thinking to calibrate confidence · inversion to ask "how could my reasoning be wrong?" Metacognition is the background process that decides which other skills to deploy.

When to Use

Apply when:

  • Stuck > 15 minutes with no progress — the most reliable trigger
  • Analysis feels confident but suspiciously fast (speed without monitoring = invisible errors)
  • Same kind of mistake keeps recurring across problems
  • Cannot tell whether you understand a topic or just recognize it (illusion of fluency)
  • Deciding whether to trust an AI copilot's fluent answer or slow down and verify it (AI adoption, automation complacency, "should I trust the AI here")
  • Someone says: "metacognition," "calibration," "am I stuck on the right problem," "I should know this but I don't"

When NOT to use: routine fluent tasks; real-time emergencies; creative flow states; already-overactive worriers who would spiral.

Coaching Novices (Adaptive Front Door)

  • Engine mode: concrete reasoning task → run The Process directly.
  • Coach mode: user unfamiliar or no concrete case → guide step by step.

In Coach mode, respond one step at a time. Each [WAIT] is a hard stop — output only that step's question, then stop.

  1. One-line what-it-is: metacognition is paying attention to how you are thinking while you think — catching when you're stuck, when confidence outruns understanding, when you should switch tactic. Experts spend 30–40% of problem-solving time on this loop; novices 5%.
  2. Check fit against When to Use / When NOT to use. Routine task / flow / over-worrier → redirect.
  3. Elicit their real case — a specific problem they're stuck on, an analysis they're running, or a decision they're making. "I'm thinking about my career" is too vague; need something concrete.

[WAIT — do not advance until user responds]

  1. Run The Process one stage at a time with their input. Pause at each stage for their answer.

[WAIT — do not advance until user responds]

  1. Close by naming the specific monitoring move they used (or skipped). They leave knowing the exact question to ask themselves next time.

[WAIT — do not advance until user responds]

The Process

Run Pólya's Four-Stage Protocol with Explicit Monitoring (Pólya 1945 + Schoenfeld 1985).

  1. Understand (with monitoring). Restate the problem in your own words; identify unknowns, data, constraints. Ask: "Do I genuinely understand this, or just recognize the topic?"
  2. Devise a plan (with monitoring). Choose a strategy. Ask: "Why this strategy?" — if you can't articulate it, you're pattern-matching. Set a time-budget: "I'll give this 20 minutes."
  3. Carry out the plan (with monitoring). Execute. At each step: "Is this advancing me, or just generating motion?" Set re-evaluation triggers (every N minutes, every dead end).
  4. Look back (with monitoring). Did it work? Why? What was the moment to have switched? Record the meta-lesson, not just the solution.
  5. Recognize the stuck-loop. 30+ minutes cycling with no progress → restate to someone else (rubber-duck), give up your current framing, or take a real break.
  6. Calibrate confidence explicitly. After any conclusion: "How confident, 0–100? What would change this?"
  7. Pre-commit re-monitoring schedule. For work longer than a day: "I will re-monitor at days 3, 7, 14."

Output: Metacognitive Worksheet

Stage 1 — Understand: Restate problem | unknowns/data/constraints | honest check: "understand or just recognize?"
Stage 2 — Plan: Strategy | reason for strategy | time-budget (N min) | reset trigger
Stage 3 — Execute: Steps | re-eval checkpoints (every N min / each dead end)
Stage 4 — Look back: Did it work? Why? | could have gotten here faster? | meta-lesson (1 sentence)
Stuck-loop: Cycled > 30 min? → rubber-duck / reframe / break
Confidence: 0–100 | evidence that would change this
Re-monitoring: Day 3 / Day 7 / Day 14 / per-sprint

→ Method in Action: Pólya at Stanford and Schoenfeld at Berkeley (1942 → 1985) → 2026 lens: Metacognition while working with AI copilots (2024–2026)

Monitoring Packs

Domain-specific time-scales and prompts: Math (~5 min loop) · Debugging (~30 min loop) · Strategy (~1 week loop) · Creative writing (schedule at breakpoints, not mid-flow). Adding a pack = one file covering stuck-loop signals, cadence, domain prompts, and flow trade-off.

Applying It Well

  • Make monitoring explicit and protocol-driven until automatic (~12 weeks per Schoenfeld). Time-budget strategies — "I'll give this 20 minutes" makes re-evaluation scheduled, not post-hoc.
  • Calibrate confidence out loud or in writing — "80% confident" is trackable; "pretty sure" is not.
  • Don't skip Stage 4 — this is where metacognition compounds into expertise.
  • Beware the flow trade-off — schedule monitoring at breakpoints for creative work, not mid-flow.

→ Primary sources: references/sources.md

Common Rationalizations

[D] = designed upfront | [O] = observed in real use. [O] entries are more valuable.

Fake moveReality
[D] "I know how I think"Knowing you have thinking ≠ monitoring it in real time. Subjective sense of awareness is not the protocol-driven monitoring loop Schoenfeld measured.
[D] Skipping Stage 1 because the problem "looks familiar"The illusion of fluency. Recognizing a topic produces confidence without understanding. The honesty check catches this.
[D] No time-budget on strategiesWithout "I'll give this 20 minutes," strategies extend indefinitely. Novices kept executing failed strategies for the full session.
[D] No re-evaluation triggers during executionMid-execution monitoring is what experts do. "Check at each dead end" turns it automatic.
[D] Skipping Stage 4 (look back)The meta-lesson is the durable artifact. Skipping it solves this problem but does not improve future ones.
[D] Over-monitoring and breaking flowCreative / routine / expert-fluent work benefits from suppressed monitoring. Schedule at breakpoints.
[D] Confusing monitoring with anxietyMonitoring is operational ("is this working?"); anxiety is affective ("what if I fail?"). Anxiety dressed as metacognition doesn't improve performance.
[D] Confidence without calibration"Pretty sure" is not a calibration. "0–100 confident" is. Forecasters track which they use; performance differs (Tetlock 2015).
[D] No pre-committed re-monitoring scheduleFor ongoing work, monitoring lapses silently. Pre-commit to Day-3/7/14 check-ins.
[D] Treating monitoring as one-offMetacognition is a protocol practiced repeatedly until automatic. One use of the checklist does not produce expert-level monitoring.
→ Add [O] entries here after each real use — paste the actual failure patternWhat went wrong and why

Red Flags

  • Same mistake recurring across problems · Strategy executing > 30 min with no re-evaluation
  • Stage 4 (look back) skipped because answer was reached · Confidence expressed vaguely without a number
  • No time-budget on current strategy · Deliberation > 1 week with no convergence
  • User feels stuck but cannot articulate what they've tried

Verification

  • Stage 1 includes the honest "do I genuinely understand?" check
  • Stage 2 names the strategy AND the reason for choosing it
  • Stage 2 includes a time-budget
  • Stage 3 includes pre-committed re-evaluation triggers
  • Stage 4 (look back) completed even when solution is in hand
  • Confidence calibrated with a 0–100 number, not a vague phrase
  • Re-monitoring schedule exists for ongoing work
  • Stuck-loop signals recognized and broken (rubber-duck, reframe, break)

Part of deciqAI Knowledge Skills — 253 open-source thinking skills that make rigor executable for AI agents. The same skills power every deciqAI agent, which runs them autonomously to operate your company. See it run → https://www.deciqai.com/s/metacognition · Built by deciqAI · github.com/deciqAI · Contributions welcome.

Agents: latest version & machine-readable metadata → https://www.deciqai.com/s/metacognition.json

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.