skill-debrief

Skill Debrief

Capture lessons from a session into the skill that drove it. The default shape is listen → propose → align → apply → re-install.

When to use

Trigger when the user wants to debrief an existing SKILL.md based on what happened in the session. Examples:

• "debrief the X skill" / "let's debrief X"
• "retrospective on X" / "feedback on X"
• "improve the X skill" / "let's update X based on what we learned"
• "X skill should also handle …"
• "X didn't trigger when it should have"

Do NOT use this skill for:

• Greenfield skill authoring. Use agr init to scaffold a SKILL.md and defer the body content to the user — or to a dedicated authoring skill such as anthropics/skills/skill-creator (agr add anthropics/skills/skill-creator).
• Installing / syncing / removing skills. That's plain agr CLI work (agr add, agr sync, agr upgrade, agr remove).

Step 1: Identify the skill

Ask which skill is being improved if it isn't obvious from context. Then locate the source:

agr list                # see installed deps and short names
ls skills/              # in-repo source if present
cat agr.toml            # see whether the dep is local-path or remote

Two cases — they have different update paths:

Case	Source location	Update path
In-repo ({path = "./skills/<name>", type = "skill"} in agr.toml)	skills/<name>/	Edit source → commit → agr upgrade <name>
Remote ({handle = "user/repo/<name>", …})	Upstream GitHub repo	Cannot edit directly — see Step 5

If the skill isn't installed at all but the user wants to improve it, ask whether to add it first (and which case applies).

Step 2: Receive feedback

Listen. The user invoked this skill because they have something to say — let them say it. Do not interrogate. Do not run a checklist of questions at them. Take in whatever they offer, in whatever shape they offer it.

Only ask a clarifying question if you genuinely cannot proceed without one (e.g. the user named a skill that doesn't exist, or two skills share the name and you need to disambiguate). Even then, ask the minimum.