Agent skill

Aar

by neurofoo in neurofoo/agent-skills

After-Action Review—structured debrief asking what was expected, what happened, why the difference, and what next.

MITAuto-check passedProduct & Project Management

Install Aar

skills CLI
$ npx skills add neurofoo/agent-skills --skill aar -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install neurofoo/agent-skills aar --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/neurofoo/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/aar .claude/skills/aar && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
aar
GitHub stars
119
Token cost
~608 tokens
SKILL.md length
269 words
Files
4 (incl. references)
Skills in repo
22
Repo updated
First seen
Licence
MIT

At a glance

After-Action Review—structured debrief asking what was expected, what happened, why the difference, and what next.

  • Works in 4 steps: What Was Expected? → What Actually Happened? → Why the Difference? → …
  • Tasks that involve Retrospectives
  • SKILL.md covers Instructions, 1. What Was Expected?, 2. What Actually Happened? and 3. Why the Difference?, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Aar is an agent skill from neurofoo/agent-skills. After-Action Review—structured debrief asking what was expected, what happened, why the difference, and what next. Use after projects, launches, presentations, or any significant event.

Its SKILL.md is about 610 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `commands/aar.md`, `commands/review.md` and `references/examples.md`).

It sits in Product & Project Management, covering Retrospectives. The repository describes itself as: Agent Skills for Claude Code and OpenCode. The licence is MIT.

When your agent uses it

  • Tasks that involve Retrospectives

Example prompts

  • “/aar”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. What Was Expected?
  2. What Actually Happened?
  3. Why the Difference?
  4. What Do We Do Next?

What it can do on your machine

Read from SKILL.md and the folder at commit 0e7ac2a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Aar loads about 608 tokens when it runs, and up to ~2.7k if it reads all its reference files. Until then it costs about 47 tokens; SKILL.md has 269 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~47
When it runs · the whole SKILL.md, loaded when a task matches
~608
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from neurofoo/agent-skills at commit 0e7ac2a, republished under its MIT licence (© neurofoo). 269 words, ~608 tokens.

Download SKILL.mdSave it as .claude/skills/aar/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
aar
description
After-Action Review—structured debrief asking what was expected, what happened, why the difference, and what next. Use after projects, launches, presentations, or any significant event.
user-invocable
true

After-Action Review

Conduct a structured debrief to extract learning from any significant event or experience.

Instructions

Work through the four core questions honestly and specifically. Focus on events and systems, not blaming individuals.

Output Format

Event: What are we reviewing? Date: When did it happen? Participants: Who was involved?


1. What Was Expected?

Before the event, what did we think would happen?

Goals/Objectives

  • [What were we trying to achieve?]

Plan

  • [What was the plan to achieve it?]

Success Criteria

  • [How would we know if we succeeded?]

Assumptions

  • [What did we assume would be true?]

2. What Actually Happened?

Facts only—what occurred, not why

Timeline

TimeEvent
[When][What happened]

Outcomes

  • [What results did we get?]

Compared to Expected

ExpectedActualGap
[expectation][reality][+/-]

3. Why the Difference?

Analysis of the gap between expected and actual

What Went Well (sustain these)

SuccessContributing Factors
[what worked][why it worked]

What Didn't Go Well (improve these)

ProblemRoot Cause
[what failed][why it failed]

Surprises

  • [Things we didn't anticipate]

4. What Do We Do Next?

Specific actions to sustain or improve

Sustain (keep doing these)

ActionOwnerHow to Protect It
[what to continue][who][mechanism]

Improve (change these)

ActionOwnerBy When
[what to change][who][deadline]

Key Takeaways Top 3 lessons from this review:

  1. [Lesson]
  2. [Lesson]
  3. [Lesson]

Follow-up When will we check if improvements are working?

Guidelines

  • Do this soon—memory fades fast
  • Be specific: "Communication failed" → "We didn't update Slack until hour 3"
  • Balance: Include what went well, not just problems
  • Assign owners: Insights without ownership become forgotten
  • Make it safe: Blame shuts down honesty

$ARGUMENTS

© neurofoo, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in aar of neurofoo/agent-skills.

  • SKILL.md
  • commands/aar.md
  • commands/review.md
  • references/examples.md

Open the folder on GitHubat commit 0e7ac2a

Compare with similar skills

Aar next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Aar compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Aar this skillneurofoo/agent-skills119—~608Automated safety check: PassMIT
Weekly Engineering Retrogarrytan/gstack136k—~2.4kAutomated safety check: PassMIT
Dough Execute Planterryyin/lizard2.5k—~4.3kAutomated safety check: PassCustom licence
After Action Reportrampstackco/claude-skills9351 repos~2.5kAutomated safety check: PassMIT
Oral Paper SkillAdkid-Zephyr/oral-paper-skill333—~1.9kAutomated safety check: PassNone
Deck Retroasheshgoplani/agent-deck1k—~1.8kAutomated safety check: PassMIT

Similar skills

  • Builds a weekly engineering retrospective from git history: commit counts, per-person contributions, work patterns and code quality numbers over a chosen window.

    136k GitHub stars~2.4k tokensUpdated today
    Product & Project ManagementAuto-check passed
  • Dough Execute Plan

    terryyin/lizard

    Executes one selected story or bounded retrospective correction through an executable plan, or one authorized planless slice from a selected simple story or a contextual instruction, with…

    2.5k GitHub stars~4.3k tokensUpdated today
    Product & Project ManagementAuto-check passed
  • After Action Report

    rampstackco/claude-skills

    Run a structured after-action review (postmortem, retrospective) on a launch, incident, or completed project to capture timeline, root cause analysis, contributing factors, and actionable lessons.

    935 GitHub starsUsed in 1 repo~2.5k tokens
    Product & Project ManagementAuto-check passed
  • Oral Paper Skill

    Adkid-Zephyr/oral-paper-skill

    Help authors learn from exemplary ICLR, ICML, and NeurIPS papers through source-linked manuscript comparisons, concrete writing and experiment suggestions, and guided reflection.

    333 GitHub stars~1.9k tokensUpdated 19 days ago
    Product & Project ManagementAuto-check passed
  • Deck Retro

    asheshgoplani/agent-deck

    Run a fully local agent-deck retrospective over the user's own transcripts, Recall index and logs.

    1k GitHub stars~1.8k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • Reviews planned, completed planless quick, or quick-to-planned execution against original intent, aggregate commits, current whole-product architecture, and tests, including after cleanup.

    2.5k GitHub stars~4k tokensUpdated today
    Product & Project ManagementAuto-check passed

More from neurofoo/agent-skills

All 22 skills in this repo
  • Five Whys Analysis

    neurofoo/agent-skills

    Runs a Five Whys root cause analysis, asking why repeatedly from the stated problem until it reaches an actionable cause, then lists corrective actions and verification.

    119 GitHub starsUsed in 1 repo~875 tokens
    Auto-check passed
  • Eisenhower Matrix Prioritizer

    neurofoo/agent-skills

    Sorts a task list into the four Eisenhower quadrants (do, schedule, delegate, eliminate) with reasons, a time distribution check and first actions.

    119 GitHub stars~705 tokensUpdated 8 mo ago
    Auto-check passed
  • OODA Loop Analysis

    neurofoo/agent-skills

    Walks a problem or decision through the OODA loop: observe the facts, orient on causes and assumptions, decide among at least three options, and plan the execution.

    119 GitHub starsUsed in 1 repo~904 tokens
    Auto-check passed
  • Cynefin Problem Classifier

    neurofoo/agent-skills

    Sorts a problem into the Cynefin domains of simple, complicated, complex, chaotic or confused, then recommends a way of working that fits that domain.

    119 GitHub starsUsed in 1 repo~696 tokens
    Auto-check passed
  • Wardley Map Analysis

    neurofoo/agent-skills

    Maps a user need's value chain against evolution stages to guide build-versus-buy decisions and show competitive dynamics.

    119 GitHub stars~776 tokensUpdated 8 mo ago
    Auto-check passed
  • Jtbd

    neurofoo/agent-skills

    Jobs to Be Done analysis to understand what customers really want.

    119 GitHub starsUsed in 1 repo~754 tokens
    Auto-check passed

Questions about Aar

What does Aar do?

After-Action Review—structured debrief asking what was expected, what happened, why the difference, and what next. Aar is an agent skill from neurofoo/agent-skills. After-Action Review—structured debrief asking what was expected, what happened, why the difference, and what next.

When should I use Aar?

Aar fits situations like: tasks that involve Retrospectives.

How do I install Aar in Claude Code?

Run `npx skills add neurofoo/agent-skills --skill aar -a claude-code`. Or copy the skill folder (aar in neurofoo/agent-skills) into .claude/skills/aar in your project. Claude Code loads it when a task matches its description.

How do I install Aar in Codex?

Run `npx skills add neurofoo/agent-skills --skill aar -a codex`. Or copy the skill folder (aar in neurofoo/agent-skills) into .agents/skills/aar in your project. Codex loads it when a task matches its description.

Can I use Aar in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add neurofoo/agent-skills --skill aar -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/aar, .gemini/skills/aar, .github/skills/aar and .opencode/skills/aar in your project.

What does Aar need to run?

SKILL.md names no scripts, command-line tools or credentials: Aar is instructions for the agent only.

Does Aar access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Aar safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Aar use?

Aar is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Aar use?

About 608 tokens (SKILL.md is roughly 2.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.1k tokens, read only when the agent opens those files.

What are the alternatives to Aar?

Skills that share tags, products or a category with Aar: Weekly Engineering Retro (garrytan/gstack, 136k stars), Dough Execute Plan (terryyin/lizard, 2.5k stars), After Action Report (rampstackco/claude-skills, 935 stars) and Oral Paper Skill (Adkid-Zephyr/oral-paper-skill, 333 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Aar?

neurofoo (a GitHub user) maintains it in neurofoo/agent-skills, which has 119 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on January 19, 2026.

Source: neurofoo/agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.