agent-self-reflection

A review skill that examines the agent’s recent work, uncertainty, mistakes, user feedback, and test results. It records lessons that may improve later work.

In plain words
What is it for?
Reviewing complex tasks, debugging sessions, failed tool calls, user corrections, and long-running work, then recording supported lessons.
Why use it?
It helps turn failures and corrections into documented, reusable improvements instead of repeating the same problems.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/codeinfinity1/stram/agent-self-reflection
Any agent
npx skills add CodeInfinity1/Stram --skill agent-self-reflection
Clone the repo
git clone --depth 1 https://github.com/CodeInfinity1/Stram

Made for: Claude Code, Codex.

Per session 41 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 600 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00041 $0.00600
Opus 5 $0.00020 $0.00300
Sonnet 5 $0.00008 $0.00120
Haiku 4.5 $0.00004 $0.00060

Measured yesterday against content hash 97a08ebd3736, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

agent-self-reflection scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/agent-core/agent-self-reflection/SKILL.md · 79 lines

How it starts

The opening of the file, as written. The whole thing — 79 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Agent Self Reflection

Purpose

Run a model-led reflection over recent work so the assistant can understand what happened, what worked, what failed, and what should change. This is a Stram-owned adaptation of external reference self-reflection patterns.

When To Use

Use after a smoke failure, user correction, long debugging session, complex implementation, or any task where future behavior should improve from evidence.

Inputs And Evidence

  • Recent audit runs and notes.
  • Current cognitive_state.
  • User corrections and preferences.
  • Test results, tool failures, and recovery actions.
  • Current commitments and follow-ups.

Tool Map

  • cognitive_self_review
  • cognitive_self_review_status
  • cognitive_interaction_review
  • cognitive_interaction_review_status
  • cognitive_skill_evolve
  • memory_write
  • memory_summary

Workflow

  1. Gather exact evidence from recent work before reflecting.
  2. Ask the model to separate facts, uncertainty, risks, user impact, and recommended changes.
  3. Record durable lessons only when supported by evidence.
  4. Use skill evolution when the lesson is reusable workflow knowledge.
  5. Use persona evolution only when the evidence reflects communication style or stable user preference.
  6. Report a concise reflection with concrete next changes.

Safety And Boundaries

  • Do not overfit one incident into a permanent rule.
  • Do not hide failures; reflection should surface evidence and limitations.
  • Do not claim improvement unless the behavior was changed or recorded.

Safety And Approval

  • Reflection must not rewrite durable memory, skills, persona, or commitments without evidence and the native tool's approval/validation path.
  • Do not store sensitive or speculative user facts from a single ambiguous event.
  • Do not use reflection to justify ignoring the user's newest instruction or active task.
  • Keep user-facing reflection concise unless the user asks for a detailed postmortem.

Native Implementation Boundaries

Read the full file on GitHub · 79 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 79 lines · 41 tokens per session scan A 97a08ebd3736

Subscribe to this mod's changes

agent-self-reflection is a skill published in the GitHub repository CodeInfinity1/Stram (10 stars, last pushed 22d ago), licensed MIT. It adds 41 tokens to every session and 600 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

skills-installer

Install, list enabled, validate, or package LiveAgent skills. Use when you need to inspect the skills enabled in the current conversation, import a local skill directory or package, search/install from ClawHub, install from a GitHub repo/tree URL, or reconcile conflicts during an upgrade.

Stack-Cairn/LiveAgent · 62 tokens

omh-jit-learn

This is a Hermes-native jit-learn workflow skill.

rlaope/oh-my-hermes · 78 tokens

omh-instinct-ledger

This is a Hermes-native instinct-ledger workflow skill.

rlaope/oh-my-hermes · 70 tokens

case-study

Craft a portfolio case study with narrative arc, process evidence, and outcomes. Use when telling a project's story to an external audience. For an internal stakeholder deck, use presentation-deck.

Owl-Listener/designer-skills · 41 tokens

xiaohongshu-title

《小红书运营手册 · AI工作台》标题生成与优化技能。用于用户明确要为小红书笔记、封面短句、图文/短视频标题、种草、教程、测评、服务内容起标题、改标题、做标题方向选择时触发。输入可以是正文草稿、选题方向、产品卖点、账号定位、图片/视频描述或已有标题。默认用快速模式输出标题;用户要求分析、首推、理由、方向、诊断或优化时用诊断/优化模式。不要在普通文章标题、论文标题、新闻标题、课程命名等非小红书/社媒场景中自动触发。.

mengke-wang/xiaohongshu-ai-workbench · 157 tokens

mulch-record-from-evidence

Turn the evidence of a finished work session — git commits, changed files, recently-touched seeds issues — into well-formed ml record invocations. Use at session close, when an agent has made changes worth preserving as mulch expertise but hasn't yet recorded them.

jayminwest/mulch · 61 tokens