{"id":"6d2b30b5-73d5-4c67-b5ef-be2192912a47","shortId":"k6HTbx","kind":"skill","title":"skill-debrief","tagline":"Debrief an AI agent skill (SKILL.md) after using it — capture session feedback or a retrospective and fold it back into the skill. Use whenever the user says: \"debrief the X skill\", \"let's debrief X\", \"retrospective on X\", \"feedback on X skill\", \"improve the X skill\", \"update the","description":"# Skill Debrief\n\nCapture lessons from a session into the skill that drove it. The default\nshape is **listen → propose → align → apply → re-install**.\n\n## When to use\n\nTrigger when the user wants to debrief an existing SKILL.md based on what\nhappened in the session. Examples:\n\n- \"debrief the X skill\" / \"let's debrief X\"\n- \"retrospective on X\" / \"feedback on X\"\n- \"improve the X skill\" / \"let's update X based on what we learned\"\n- \"X skill should also handle …\"\n- \"X didn't trigger when it should have\"\n\nDo NOT use this skill for:\n\n- **Greenfield skill authoring.** Use `agr init` to scaffold a SKILL.md and\n  defer the body content to the user — or to a dedicated authoring skill\n  such as `anthropics/skills/skill-creator`\n  (`agr add anthropics/skills/skill-creator`).\n- **Installing / syncing / removing skills.** That's plain `agr` CLI work\n  (`agr add`, `agr sync`, `agr upgrade`, `agr remove`).\n\n## Step 1: Identify the skill\n\nAsk which skill is being improved if it isn't obvious from context. Then\nlocate the source:\n\n```bash\nagr list                # see installed deps and short names\nls skills/              # in-repo source if present\ncat agr.toml            # see whether the dep is local-path or remote\n```\n\nTwo cases — they have different update paths:\n\n| Case | Source location | Update path |\n|---|---|---|\n| **In-repo** (`{path = \"./skills/<name>\", type = \"skill\"}` in `agr.toml`) | `skills/<name>/` | Edit source → commit → `agr upgrade <name>` |\n| **Remote** (`{handle = \"user/repo/<name>\", …}`) | Upstream GitHub repo | Cannot edit directly — see Step 5 |\n\nIf the skill isn't installed at all but the user wants to improve it, ask\nwhether to add it first (and which case applies).\n\n## Step 2: Receive feedback\n\n**Listen.** The user invoked this skill because they have something to say\n— let them say it. Do not interrogate. Do not run a checklist of questions\nat them. Take in whatever they offer, in whatever shape they offer it.\n\nOnly ask a clarifying question if you genuinely cannot proceed without one\n(e.g. the user named a skill that doesn't exist, or two skills share the\nname and you need to disambiguate). Even then, ask the minimum.\n\nBe **dynamic**. The user may surface things in any shape — a single\nsentence (\"the description should also fire on X\"), a structured list, or a\nramble that you need to distill. They may also surface things outside the\nstandard buckets below (rename a section, restructure `references/`, change\noutput format, drop a deprecated workflow, fix a typo). Apply whatever the\nuser actually says.\n\nThe buckets below are a mental map for *you* when distilling what you\nheard, not a checklist to recite at the user:\n\n- **`description` / triggers** — under-fired or over-fired\n- **Gotchas / boundaries** — a foot-gun the skill didn't warn about\n- **Workflow steps** — missing, wrong, or out of order\n- **References** — a topic kept needing more depth → new `references/<topic>.md`\n- **Examples / output format** — vague where it should be concrete\n- **Pruning** — outdated content that misled\n\n## Step 3: Propose changes\n\nSummarize what you heard, then propose specific edits. Format:\n\n> **Proposed changes to `skills/<name>/SKILL.md`** (and any references):\n>\n> 1. **Description** — add trigger phrase \"…\" (because: …)\n> 2. **Boundaries** — add: never X (because: discovered this in session)\n> 3. **New section \"Y\"** — describes the workflow that was missing\n>\n> Want me to apply these, revise, or add more?\n\nFor small edits, show the exact diff inline. For larger changes, summarize\nfirst and apply section by section.\n\n**Wait for explicit user approval before editing.** \"yes\" / \"go ahead\" /\nsimilar. If the user revises, loop back to Step 2 or 3.\n\n## Step 4: Apply (in-repo case)\n\nEdit the source file(s) under `skills/<name>/`. Then:\n\n```bash\ngit status                        # confirm only the intended files changed\ngit add skills/<name>/\ngit commit -m \"skill(<name>): <one-line summary>\"\nagr upgrade <name>                # re-installs into all configured tools, refreshes agr.lock\ngit add agr.lock\ngit commit --amend --no-edit      # or commit separately; match the repo's style\n```\n\n**Do not push.** Stop after the commit and let the user push when ready.\n\n### Commit message style\n\nUse a conventional-commits-style scope:\n\n```\nskill(<name>): <imperative summary>\n```\n\nExamples:\n\n```\nskill(agr-cli): clarify upgrade vs sync for local paths\nskill(agr-cli): add gotcha for same-repo siblings\nskill(code-review): drop outdated linter pre-check\n```\n\nIf the repo's commit style differs (check `git log --oneline -20`), match it.\n\n### Why `agr upgrade` and not `agr sync`?\n\n`agr sync` only installs **missing** deps — it does NOT re-copy a local-path\nskill that's already installed. `agr upgrade <name>` re-copies it and\nrefreshes `agr.lock`. Use `agr upgrade`.\n\n(Equivalent: `agr add ./skills/<name> --overwrite`. Pick `upgrade` for\nconsistency — it's the same verb used to refresh remote skills.)\n\n## Step 5: Apply (remote case)\n\nIf the skill is a remote dep, the change cannot be applied directly. Ask\nthe user which path they want:\n\n### Option A — File an issue upstream via `gh`\n\nBest when the change benefits everyone (a real bug or universal improvement\nin someone else's published skill).\n\nResolve the upstream repo from the handle:\n\n- `anthropics/skills/pdf` → `--repo anthropics/skills`\n- `user/myrepo/skill` → `--repo user/myrepo`\n\nConfirm the title and body with the user, then:\n\n```bash\ngh issue create \\\n  --repo <owner>/<repo> \\\n  --title \"[<skill-name>] <short summary>\" \\\n  --body \"$(cat <<'EOF'\n## What I observed\n\n<concrete scenario from the session>\n\n## Suggested change\n\n<proposed wording or workflow>\n\n## Why\n\n<reasoning>\nEOF\n)\"\n```\n\n`gh issue create` posts publicly — treat it the same as any other shared-\nstate action. **Always confirm before running.**\n\nIf the user has push access and a local clone, also offer to open a PR\ninstead of (or alongside) the issue.\n\n### Option B — Fork to in-repo\n\nBest when the change is project-specific or unlikely to be accepted\nupstream. Copies the skill into `skills/<name>/` so future retros work the\nin-repo way.\n\nSuggested flow:\n\n```bash\n# 1. Find the upstream commit (agr.lock has it)\nagr list\n\n# 2. Sparse-checkout or full clone, then copy the folder:\nmkdir -p skills\ncp -r /tmp/upstream-clone/<skill-folder> skills/<name>\n\n# 3. Swap the dep\nagr remove anthropics/skills/<name>\nagr add ./skills/<name>\n```\n\nTell the user this **forks** the skill — they're now responsible for\nkeeping it current with upstream. Then continue from Step 3 with the\nin-repo flow.\n\n### Both A and B\n\nOffer Option A first when the change is generally useful. Offer Option B\nwhen upstream is unlikely to accept, or when the user wants the change\n*now* without waiting on upstream.\n\n## Step 6: Verify\n\nAfter re-installing (in-repo case):\n\n```bash\nagr list                                          # status should be `installed`\ndiff skills/<name>/SKILL.md .claude/skills/<name>/SKILL.md   # should be empty\n```\n\nFor remote case (issue filed): confirm the issue URL with the user.\n\nTell the user what's done and what's pending (commit done, push pending; or\nissue filed, awaiting response).\n\n## Boundaries\n\n- **Don't edit a skill without explicit user approval of the proposed\n  changes.** Skills are user-owned content — never silently revise.\n- **Don't push.** Commit only; the user pushes when ready.\n- **Don't open issues or PRs without confirming the title and body** with\n  the user first. `gh issue create` is publicly visible — treat it as\n  shared-state.\n- **Don't edit `agr.lock` by hand** — `agr upgrade` regenerates it.\n- **Don't broaden the scope of the edit** beyond what was discussed. If the\n  user asked to fix one gotcha, don't also restructure the file.\n- **Don't write a skill from scratch** — that's a separate workflow.\n\n## See also\n\n- `anthropics/skills/skill-creator` — canonical greenfield skill authoring\n  (install with `agr add anthropics/skills/skill-creator` if needed)","tags":["skill","debrief","agr","computerlovetech","agent-skills","agentic-engineering","claude-code"],"capabilities":["skill","source-computerlovetech","skill-skill-debrief","topic-agent-skills","topic-agentic-engineering","topic-claude-code"],"categories":["agr"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/computerlovetech/agr/skill-debrief","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add computerlovetech/agr","source_repo":"https://github.com/computerlovetech/agr","install_from":"skills.sh"}},"qualityScore":"0.667","qualityRationale":"deterministic score 0.67 from registry signals: · indexed on github topic:agent-skills · 435 github stars · SKILL.md body (8,003 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T18:54:10.614Z","embedding":null,"createdAt":"2026-05-01T12:53:29.218Z","updatedAt":"2026-05-18T18:54:10.614Z","lastSeenAt":"2026-05-18T18:54:10.614Z","tsv":"'-20':748 '/skill.md':541,1099,1101 '/skills':258,794,1015 '/tmp/upstream-clone':1004 '1':192,545,978 '2':307,551,617,988 '3':525,561,619,1006,1037 '4':621 '5':280,811 '6':1080 'accept':959,1066 'access':923 'action':913 'actual':447 'add':171,184,299,547,553,578,645,663,720,793,1014,1255 'agent':7 'agr':147,170,180,183,185,187,189,214,267,651,707,718,752,756,758,779,789,792,986,1010,1013,1091,1203,1254 'agr-c':706,717 'agr.lock':661,664,787,983,1200 'agr.toml':231,262 'ahead':607 'ai':6 'align':71 'alongsid':937 'alreadi':777 'also':127,403,420,928,1229,1246 'alway':914 'amend':667 'anthropics/skills':870,1012 'anthropics/skills/pdf':868 'anthropics/skills/skill-creator':169,172,1247,1256 'appli':72,305,443,574,594,622,812,826 'approv':602,1145 'ask':196,296,350,384,828,1222 'author':145,165,1251 'await':1134 'b':941,1047,1060 'back':22,614 'base':89,119 'bash':213,635,883,977,1090 'benefit':847 'best':843,947 'beyond':1215 'bodi':156,878,889,1180 'boundari':481,552,1136 'broaden':1209 'bucket':426,450 'bug':851 'cannot':275,357,824 'canon':1248 'captur':13,54 'case':243,249,304,626,814,1089,1107 'cat':230,890 'chang':433,527,538,590,643,823,846,896,950,1054,1073,1149 'check':736,744 'checklist':333,465 'checkout':991 'clarifi':352,709 'claude/skills':1100 'cli':181,708,719 'clone':927,994 'code':729 'code-review':728 'commit':266,648,666,672,685,693,700,741,982,1127,1162 'concret':518 'configur':658 'confirm':638,874,915,1110,1176 'consist':799 'content':157,521,1155 'context':208 'continu':1034 'convent':699 'conventional-commits-styl':698 'copi':769,783,961,996 'cp':1002 'creat':886,901,1187 'current':1030 'debrief':3,4,31,37,53,85,97,103 'dedic':164 'default':66 'defer':154 'dep':218,235,763,821,1009 'deprec':438 'depth':506 'describ':565 'descript':401,471,546 'didn':130,488 'diff':586,1097 'differ':246,743 'direct':277,827 'disambigu':381 'discov':557 'discuss':1218 'distil':417,459 'doesn':368 'done':1122,1128 'drop':436,731 'drove':63 'dynam':388 'e.g':361 'edit':264,276,535,582,604,627,670,1139,1199,1214 'els':857 'empti':1104 'eof':891,898 'equival':791 'even':382 'everyon':848 'exact':585 'exampl':96,510,704 'exist':87,370 'explicit':600,1143 'feedback':15,42,108,309 'file':630,642,837,1109,1133,1232 'find':979 'fire':404,475,479 'first':301,592,1051,1184 'fix':440,1224 'flow':976,1043 'fold':20 'folder':998 'foot':484 'foot-gun':483 'fork':942,1020 'format':435,512,536 'full':993 'futur':967 'general':1056 'genuin':356 'gh':842,884,899,1185 'git':636,644,647,662,665,745 'github':273 'go':606 'gotcha':480,721,1226 'greenfield':143,1249 'gun':485 'hand':1202 'handl':128,270,867 'happen':92 'heard':462,531 'identifi':193 'improv':46,111,201,294,854 'in-repo':224,254,623,944,971,1040,1086 'init':148 'inlin':587 'instal':75,173,217,286,655,761,778,1085,1096,1252 'instead':934 'intend':641 'interrog':328 'invok':313 'isn':204,284 'issu':839,885,900,939,1108,1112,1132,1172,1186 'keep':1028 'kept':503 'larger':589 'learn':123 'lesson':55 'let':35,101,115,322,687 'linter':733 'list':215,409,987,1092 'listen':69,310 'local':238,714,772,926 'local-path':237,771 'locat':210,251 'log':746 'loop':613 'ls':222 'm':649 'map':455 'match':674,749 'may':391,419 'md':509 'mental':454 'messag':694 'minimum':386 'misl':523 'miss':494,570,762 'mkdir':999 'name':221,364,376 'need':379,415,504,1258 'never':554,1156 'new':507,562 'no-edit':668 'observ':894 'obvious':206 'offer':342,347,929,1048,1058 'one':360,1225 'onelin':747 'open':931,1171 'option':835,940,1049,1059 'order':499 'outdat':520,732 'output':434,511 'outsid':423 'over-fir':477 'overwrit':795 'own':1154 'p':1000 'path':239,248,253,257,715,773,832 'pend':1126,1130 'phrase':549 'pick':796 'plain':179 'post':902 'pr':933 'pre':735 'pre-check':734 'present':229 'proceed':358 'project':953 'project-specif':952 'propos':70,526,533,537,1148 'prs':1174 'prune':519 'public':903,1189 'publish':859 'push':681,690,922,1129,1161,1166 'question':335,353 'r':1003 'rambl':412 're':74,654,768,782,1024,1084 're-copi':767,781 're-instal':73,653,1083 'readi':692,1168 'real':850 'receiv':308 'recit':467 'refer':432,500,508,544 'refresh':660,786,807 'regener':1205 'remot':241,269,808,813,820,1106 'remov':175,190,1011 'renam':428 'repo':226,256,274,625,676,725,739,864,869,872,887,946,973,1042,1088 'resolv':861 'respons':1026,1135 'restructur':431,1230 'retro':968 'retrospect':18,39,105 'review':730 'revis':576,612,1158 'run':331,917 'same-repo':723 'say':30,321,324,448 'scaffold':150 'scope':702,1211 'scratch':1239 'section':430,563,595,597 'see':216,232,278,1245 'sentenc':399 'separ':673,1243 'session':14,58,95,560 'shape':67,345,396 'share':374,911,1195 'shared-st':1194 'short':220 'show':583 'sibl':726 'silent':1157 'similar':608 'singl':398 'skill':2,8,25,34,45,49,52,61,100,114,125,141,144,166,176,195,198,223,260,263,283,315,366,373,487,540,633,646,650,703,705,716,727,774,809,817,860,963,965,1001,1005,1022,1098,1141,1150,1237,1250 'skill-debrief':1 'skill-skill-debrief' 'skill.md':9,88,152 'small':581 'someon':856 'someth':319 'sourc':212,227,250,265,629 'source-computerlovetech' 'spars':990 'sparse-checkout':989 'specif':534,954 'standard':425 'state':912,1196 'status':637,1093 'step':191,279,306,493,524,616,620,810,1036,1079 'stop':682 'structur':408 'style':678,695,701,742 'suggest':895,975 'summar':528,591 'surfac':392,421 'swap':1007 'sync':174,186,712,757,759 'take':338 'tell':1016,1117 'thing':393,422 'titl':876,888,1178 'tool':659 'topic':502 'topic-agent-skills' 'topic-agentic-engineering' 'topic-claude-code' 'treat':904,1191 'trigger':79,132,472,548 'two':242,372 'type':259 'typo':442 'under-fir':473 'univers':853 'unlik':956,1064 'updat':50,117,247,252 'upgrad':188,268,652,710,753,780,790,797,1204 'upstream':272,840,863,960,981,1032,1062,1078 'url':1113 'use':11,26,78,139,146,696,788,805,1057 'user':29,82,160,291,312,363,390,446,470,601,611,689,830,881,920,1018,1070,1116,1119,1144,1153,1165,1183,1221 'user-own':1152 'user/myrepo':873 'user/myrepo/skill':871 'user/repo':271 'vagu':513 'verb':804 'verifi':1081 'via':841 'visibl':1190 'vs':711 'wait':598,1076 'want':83,292,571,834,1071 'warn':490 'way':974 'whatev':340,344,444 'whenev':27 'whether':233,297 'without':359,1075,1142,1175 'work':182,969 'workflow':439,492,567,1244 'write':1235 'wrong':495 'x':33,38,41,44,48,99,104,107,110,113,118,124,129,406,555 'y':564 'yes':605","prices":[{"id":"9410c704-14cb-4559-9f31-fbc78769cd68","listingId":"6d2b30b5-73d5-4c67-b5ef-be2192912a47","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"computerlovetech","category":"agr","install_from":"skills.sh"},"createdAt":"2026-05-01T12:53:29.218Z"}],"sources":[{"listingId":"6d2b30b5-73d5-4c67-b5ef-be2192912a47","source":"github","sourceId":"computerlovetech/agr/skill-debrief","sourceUrl":"https://github.com/computerlovetech/agr/tree/main/skills/skill-debrief","isPrimary":false,"firstSeenAt":"2026-05-01T12:53:29.218Z","lastSeenAt":"2026-05-18T18:54:10.614Z"}],"details":{"listingId":"6d2b30b5-73d5-4c67-b5ef-be2192912a47","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"computerlovetech","slug":"skill-debrief","github":{"repo":"computerlovetech/agr","stars":435,"topics":["agent-skills","agentic-engineering","claude-code"],"license":"mit","html_url":"https://github.com/computerlovetech/agr","pushed_at":"2026-05-16T07:16:54Z","description":"A package manager for AI agents. Install agent skills from GitHub with a single command.","skill_md_sha":"bf042ed8c65cb32e664fbc65dceb0ab3d25d844f","skill_md_path":"skills/skill-debrief/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/computerlovetech/agr/tree/main/skills/skill-debrief"},"layout":"multi","source":"github","category":"agr","frontmatter":{"name":"skill-debrief","description":"Debrief an AI agent skill (SKILL.md) after using it — capture session feedback or a retrospective and fold it back into the skill. Use whenever the user says: \"debrief the X skill\", \"let's debrief X\", \"retrospective on X\", \"feedback on X skill\", \"improve the X skill\", \"update the X skill\", \"let's revise X based on what we just did\", \"the X skill should also handle Y\", \"X didn't trigger when it should have\", or otherwise wants to capture lessons from a session back into the skill that drove it. Handles in-repo skills (under skills/) by editing the source, committing, and re-installing via `agr upgrade`. Handles remote/upstream skills by offering to fork them in-repo or to file a GitHub issue via `gh`. Do NOT use for greenfield skill authoring (a separate concern — see `anthropics/skills/skill-creator`) or for installing / syncing / removing skills (use the `agr` CLI directly)."},"skills_sh_url":"https://skills.sh/computerlovetech/agr/skill-debrief"},"updatedAt":"2026-05-18T18:54:10.614Z"}}