vibe-reflect-and-compound

vibe-reflect-and-compound is a skill for Claude Code from mracal/vibe-engineering. It costs 44 tokens per session (563 once invoked), scanned A, a copy of vibe-reflect-and-compound, MIT.

A record of reusable lessons from completed work, feedback, bugs, failures, or code reviews. It stores specific actions and patterns in a persistent learnings file.

In plain words
What is it for?
Use it after fixing a bug, receiving substantive feedback, completing complex work, or reviewing a failed attempt. It identifies the root cause and records what to do differently next time.
Why use it?
It turns one-off mistakes and discoveries into guidance for future work. This reduces the chance of repeating the same problem.

Skill for Claude Code

Written for Claude Code: user-invocable in frontmatter.

Good fit Use it after fixing a bug, receiving substantive feedback, completing complex work, or reviewing a failed attempt. It identifies the root cause and records what to do differently next time.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/mracal/vibe-engineering/reflect-and-compound
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.

Any agent
npx skills add mracal/vibe-engineering --skill reflect-and-compound
Clone the repo
git clone --depth 1 https://github.com/mracal/vibe-engineering

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for vibe-reflect-and-compound

README.md
[![agentmods](https://agentmods.dev/badge/skills/mracal/vibe-engineering/reflect-and-compound/github.svg)](https://agentmods.dev/skills/mracal/vibe-engineering/reflect-and-compound)
Your own site
<a href="https://agentmods.dev/skills/mracal/vibe-engineering/reflect-and-compound"><img src="https://agentmods.dev/badge/skills/mracal/vibe-engineering/reflect-and-compound/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for vibe-reflect-and-compound

Your own site · 80×15
<a href="https://agentmods.dev/skills/mracal/vibe-engineering/reflect-and-compound"><img src="https://agentmods.dev/badge/skills/mracal/vibe-engineering/reflect-and-compound.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 44 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 563 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin 100% copy Near-identical to another mod 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.1 $0.00044 $0.00563
Opus 5 $0.00022 $0.00282
Sonnet 5 $0.00009 $0.00113
Haiku 4.5 $0.00004 $0.00056

Measured 10d ago against content hash 04b7218e04da, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

vibe-reflect-and-compound 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 10d ago.

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.

Origin

This is a copy

100% identical to vibe-reflect-and-compound — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

skills/reflect-and-compound/SKILL.md · 70 lines

How it starts

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

vibe-reflect-and-compound

Every problem solved should produce reusable knowledge. Don't just fix — learn.

When to Use This Skill

  • After receiving feedback on your work (positive or negative)
  • After a failed attempt or debugging session
  • After completing a complex task
  • After a code review with substantive feedback
  • Periodically (e.g., end of week) to consolidate learnings

When NOT to Use This Skill

  • After trivial tasks (typo fixes, simple renames)
  • When there's nothing new to learn (routine work)
  • During active implementation (reflect AFTER, not DURING)

Steps

  1. Gather input — What happened?

    • What was the task/feedback/failure?
    • What was expected vs. what actually happened?
    • What was the root cause?
  2. Extract patterns — Ask:

    • "What would I do differently next time?"
    • "What pattern does this represent?"
    • "Is this a recurring theme?"
    • "What would have caught this earlier?"
  3. Formulate learnings — Each learning should be:

    • Actionable — Not "be careful" but "always run race detection before committing concurrent code"
    • Specific — Not "tests are important" but "property-based tests catch edge cases that table-driven tests miss for parser code"
    • Contextual — Include when it applies and when it doesn't
  4. Update persistent storage — Write to:

    • Project learnings file (e.g., docs/learnings.md or LEARNINGS.md)
    • Claude memory (if available)
    • Team wiki/docs
  5. Cap management — Keep max 30 active learnings. When exceeding:

    • Archive older learnings to a dated file
    • Keep only the most frequently referenced ones active
    • Merge similar learnings

Output Format

Reflection: [Context]

Trigger: [What prompted this reflection]

Learnings Extracted:

  1. [Pattern name]: [Actionable learning]

    • Applies when: [context]
    • Evidence: [what happened]
  2. [Pattern name]: [Actionable learning]

    • Applies when: [context]
    • Evidence: [what happened]

Read the full file on GitHub · 70 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. 10d ago First seen · 70 lines · 44 tokens per session scan A 04b7218e04da

Subscribe to this mod's changes

vibe-reflect-and-compound is a skill published in the GitHub repository mracal/vibe-engineering (3 stars, last pushed yesterday), licensed MIT. It adds 44 tokens to every session and 563 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. It is 100% identical to vibe-reflect-and-compound, differing in 0 lines, and is treated as a copy.