agent-introspection

Run structured self-audits with clarifying questions and safety checks.

3|1|Updated May 21, 2026
One-click install
npx skills add https://github.com/qwwiwi/agentos-skills-public --skill agent-introspection
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-introspection
Source: https://github.com/qwwiwi/agentos-skills-public/tree/main/skills/agent-introspection
Command: npx skills add https://github.com/qwwiwi/agentos-skills-public --skill agent-introspection

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you avoid avoidable mistakes by prompting structured self-review, targeted clarifying questions, and weekly learning so your work quality improves over time.

Core Features & Use Cases

  • Pre-flight clarification: asks concise questions when context is missing, before you start coding or deciding.
  • Self-review before sending: runs a checklist covering correctness, safety, cleanliness, and compatibility to catch issues early.
  • Root-cause post-mortem with LEARNINGS: identifies causes after errors and records actionable rules to prevent repeats.
  • Weekly introspection: answers a curated set of prompts to uncover automation opportunities, drifting assumptions, memory gaps, and quality improvements.
  • Proactive improvement: encourages turning repeated patterns into future guardrails (script/skill/template suggestions).

Quick Start

Use the agent-introspection skill when you are about to write code or finish a task and want 2–3 focused questions plus a pre-submit self-check.

Frequently Asked Questions about agent-introspection

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

FAQPage Schema
How do I run a post-mortem to capture root causes after a code error?

To run a post-mortem after a code error, you identify the root cause and record actionable rules into a LEARNINGS log to prevent repeats. This structured recovery improves future task completion and overall quality.

What are clarifying questions and why are they needed before coding?

Clarifying questions are concise pre-flight prompts used to verify missing context before you start coding or making decisions. They are needed to ensure correctness and avoid avoidable mistakes early in the agent workflow.

How do I set up a self-audit checklist for code review and task completion?

You set up a self-audit checklist by defining review criteria for correctness, safety, cleanliness, and compatibility. Running this checklist before sending outputs catches issues early and enforces post-output guardrails during task completion.

Does structured weekly introspection help improve agent workflow quality?

Yes, structured weekly introspection improves agent workflow quality by answering curated prompts that uncover automation opportunities, drifting assumptions, and memory gaps. This iterative learning loop turns repeated patterns into future guardrails.

What is the best way to prevent repeated mistakes in software engineering tasks?

The best way to prevent repeated mistakes is establishing an iterative learning loop that records explicit root-cause captures into LEARNINGS. Turning these repeated patterns into proactive guardrails ensures continuous quality improvement.