Weekly Engineering Retro
garrytan/gstack
Builds a weekly engineering retrospective from git history: commit counts, per-person contributions, work patterns and code quality numbers over a chosen window.
CP-7 retrospective: audit checkpoints, evidence quality, action items, and harvest candidates.
Install Retro
$ npx skills add huytieu/COG-second-brain --skill retro -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install huytieu/COG-second-brain retro --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/huytieu/COG-second-brain.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/retro .claude/skills/retro && rm -rf skills-srcUse ~/.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/
Install the "retro" agent skill from https://github.com/huytieu/COG-second-brain/tree/main/skills/retro into .claude/skills/retro/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "retro", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/huytieu/COG-second-brain/tree/main/skills/retroType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add huytieu/COG-second-brain --skill retro -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install huytieu/COG-second-brain retro --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/huytieu/COG-second-brain.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/retro .agents/skills/retro && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "retro" agent skill from https://github.com/huytieu/COG-second-brain/tree/main/skills/retro into .agents/skills/retro/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "retro", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add huytieu/COG-second-brain --skill retro -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install huytieu/COG-second-brain retro --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/huytieu/COG-second-brain.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/retro .cursor/skills/retro && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "retro" agent skill from https://github.com/huytieu/COG-second-brain/tree/main/skills/retro into .cursor/skills/retro/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "retro", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/huytieu/COG-second-brain.git --path skills/retro--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add huytieu/COG-second-brain --skill retro -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install huytieu/COG-second-brain retro --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/huytieu/COG-second-brain.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/retro .gemini/skills/retro && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "retro" agent skill from https://github.com/huytieu/COG-second-brain/tree/main/skills/retro into .gemini/skills/retro/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "retro", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install huytieu/COG-second-brain retroInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add huytieu/COG-second-brain --skill retro -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/huytieu/COG-second-brain.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/retro .github/skills/retro && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "retro" agent skill from https://github.com/huytieu/COG-second-brain/tree/main/skills/retro into .github/skills/retro/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "retro", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add huytieu/COG-second-brain --skill retro -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install huytieu/COG-second-brain retro --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/huytieu/COG-second-brain.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/retro .opencode/skills/retro && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "retro" agent skill from https://github.com/huytieu/COG-second-brain/tree/main/skills/retro into .opencode/skills/retro/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "retro", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
retro- GitHub stars
- 1.3k
- Token cost
- ~571 tokens
- SKILL.md length
- 263 words
- Files
- 2 (incl. references)
- Skills in repo
- 37
- Repo updated
- First seen
- Licence
- MIT
At a glance
CP-7 retrospective: audit checkpoints, evidence quality, action items, and harvest candidates.
- Works in 5 steps: Gather evidence bundle → Checkpoint audit → Evidence quality pass → …
- Tasks that involve Retrospectives
- SKILL.md covers When to run, Phase 1 — Gather evidence bundle, Phase 2 — Checkpoint audit and Phase 3 — Evidence quality pass, plus 3 more sections
- Calls bash
What it does
Retro is an agent skill from huytieu/COG-second-brain. CP-7 retrospective: audit checkpoints, evidence quality, action items, and harvest candidates. Closes the V-model cycle and feeds the next run. Use via /retro after ship, escalate, or significant session.
Its SKILL.md is about 570 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/retro-template.md`).
It sits in Product & Project Management, covering Retrospectives. The repository describes itself as: Self-evolving second brain with 35 AI skills, 10 agents, and people CRM. Closed-loop harness: a V-model verification lifecycle where the worker never grades its own homework… The licence is MIT.
When your agent uses it
- Tasks that involve Retrospectives
Example prompts
- “/retro”
Workflow steps
5 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 36ac9d7. 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
Shell commands in SKILL.md call:
bash
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
Retro loads about 571 tokens when it runs, and up to ~788 if it reads all its reference files. Until then it costs about 53 tokens; SKILL.md has 263 words of instructions outside code blocks.
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 huytieu/COG-second-brain at commit 36ac9d7, republished under its MIT licence (© huytieu). 263 words, ~571 tokens.
Download SKILL.mdSave it as
.claude/skills/retro/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.- name
- retro
- description
- CP-7 retrospective: audit checkpoints, evidence quality, action items, and harvest candidates. Closes the V-model cycle and feeds the next run. Use via /retro after ship, escalate, or significant session.
/retro — CP-7 close the V
Every non-tiny shipped or escalated run gets a retro. Retro is advisory but strongly expected: it is how the harness improves.
When to run
- After CP-6 ship (approved publish, merged PR, vault deliverable done)
- After escalate (capture why verifier failed)
- End of an
/ultragoalphase (one retro per phase) - Manual:
/retro <run-dir or spec path>
Phase 1 — Gather evidence bundle
Read:
- Spec or card description + acceptance criteria
04-projects/harness/runs/<id>/evidence/(ledger, checkpoints.tsv, CP-* files).claude/logs/loop-ledger.tsv(last rows for this run)04-projects/<goal>/STATUS.mdif an ultragoal phase
Phase 2 — Checkpoint audit
For each CP the lane required, mark Expected vs Actual vs Gap:
| CP | tiny | normal | full |
|---|---|---|---|
| CP-1 spec | skip | required | required |
| CP-3v component | skip | required | required |
| CP-4 integration | skip | skip | required if multi-task |
| CP-5 acceptance | if mutate | required | required |
| CP-6 ship | if external | if external | required |
Phase 3 — Evidence quality pass
Ask:
- Any AC-n shipped without a PASS evidence row? (traceability violation)
- Any PASS row where observation is tool-return not artifact? (confident-but-unchecked)
- Any criterion that wasn't falsifiable? (fix in next spec)
Phase 4 — Write retro
Copy references/retro-template.md to:
04-projects/harness/retro/YYYY-MM-DD-<slug>.md
Fill all sections. Action items get IDs (AI-01…).
Phase 5 — Feed forward
- Harvest: append action items + lessons to today's harvest staging
- Backlog: add
AI-nrows to04-projects/harness/BACKLOG.mdif harness work - STATUS.md: if an ultragoal phase, advance the phase state + log open
AC-n - Spec checkpoint log: update spec
## Checkpoint logCP-7 row - Record:
bash .claude/lib/checkpoint.sh record <run-dir> CP-7 PASS "retro: <path>"
Output to the user
TL;DR: outcome, top lesson, top action item, retro path.
© huytieu, 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 1 other file (references) in skills/retro of huytieu/COG-second-brain.
- SKILL.md
- references/retro-template.md
Open the folder on GitHubat commit 36ac9d7
Compare with similar skills
Retro 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Retro this skillhuytieu/COG-second-brain | 1.3k | — | ~571 | Automated safety check: Pass | MIT | |
| Weekly Engineering Retrogarrytan/gstack | 136k | — | ~2.4k | Automated safety check: Pass | MIT | |
| Dough Execute Planterryyin/lizard | 2.6k | — | ~4.3k | Automated safety check: Pass | Custom licence | |
| Oral Paper SkillAdkid-Zephyr/oral-paper-skill | 350 | — | ~1.9k | Automated safety check: Pass | None | |
| Deck Retroasheshgoplani/agent-deck | 1k | — | ~1.8k | Automated safety check: Pass | MIT | |
| Dough Execution Retrospectiveterryyin/lizard | 2.6k | — | ~4k | Automated safety check: Pass | Custom licence |
Similar skills
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…
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.
Deck Retro
asheshgoplani/agent-deck
Run a fully local agent-deck retrospective over the user's own transcripts, Recall index and logs.
Dough Execution Retrospective
terryyin/lizard
Reviews planned, completed planless quick, or quick-to-planned execution against original intent, aggregate commits, current whole-product architecture, and tests, including after cleanup.
Criticism Self Criticism
HughYau/qiushi-skill
批评与自我批评：在工作完成、阶段验收、收到批评或同类错误反复出现时，对成果和过程做诚实、具体、基于事实的审视，输出可执行的改进项，并处理外来批评而不辩解。触发信号包括 review、复盘、审查、"帮我看看有没有问题"、"你确定吗"；任务刚开始或只是单步查询时不触发。
More from huytieu/COG-second-brain
All 37 skills in this repoVoice Baseline
huytieu/COG-second-brain
Measure your own writing corpus for the words and sentence shapes you over-use, so an agent writing in your voice stops amplifying your tics into a style.
Daily Journal
huytieu/COG-second-brain
A passive daily work journal that Claude keeps FOR you so you never have to write it yourself.
Editorial Illustrations
huytieu/COG-second-brain
Generate meaning-carrying editorial data-illustrations in the monotykamary / Linear aesthetic (near-black grayscale, Inter display + mono labels, hairline framed figures) with a single coral accent.
Loop Engineering
huytieu/COG-second-brain
Shared loop-engineering reference for COG skills - the agent loop, deterministic verifiers, termination conditions, in-loop context management, and named patterns.
Release Video
huytieu/COG-second-brain
Turn a product release (the list of shipped items plus real screen recordings) into a motion recap video and one explained demo per feature, with sound effects tied to on-screen motion and a…
Onboarding
huytieu/COG-second-brain
Personalize COG for your workflow - creates profile, interests, and watchlist files with guided setup (run this first!)
Related
Categories
Questions about Retro
What does Retro do?
CP-7 retrospective: audit checkpoints, evidence quality, action items, and harvest candidates. Retro is an agent skill from huytieu/COG-second-brain. CP-7 retrospective: audit checkpoints, evidence quality, action items, and harvest candidates.
When should I use Retro?
Retro fits situations like: tasks that involve Retrospectives.
How do I install Retro in Claude Code?
Run `npx skills add huytieu/COG-second-brain --skill retro -a claude-code`. Or copy the skill folder (skills/retro in huytieu/COG-second-brain) into .claude/skills/retro in your project. Claude Code loads it when a task matches its description.
How do I install Retro in Codex?
Run `npx skills add huytieu/COG-second-brain --skill retro -a codex`. Or copy the skill folder (skills/retro in huytieu/COG-second-brain) into .agents/skills/retro in your project. Codex loads it when a task matches its description.
Can I use Retro 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 huytieu/COG-second-brain --skill retro -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/retro, .gemini/skills/retro, .github/skills/retro and .opencode/skills/retro in your project.
What does Retro need to run?
Going by SKILL.md and its folder, Retro needs the command-line tools its instructions call (bash).
Does Retro 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 Retro 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 Retro use?
Retro 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 Retro use?
About 571 tokens (SKILL.md is roughly 2.3k 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 217 tokens, read only when the agent opens those files.
What are the alternatives to Retro?
Skills that share tags, products or a category with Retro: Weekly Engineering Retro (garrytan/gstack, 136k stars), Dough Execute Plan (terryyin/lizard, 2.6k stars), Oral Paper Skill (Adkid-Zephyr/oral-paper-skill, 350 stars) and Deck Retro (asheshgoplani/agent-deck, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Retro?
huytieu (a GitHub user) maintains it in huytieu/COG-second-brain, which has 1,267 GitHub stars. The repository holds 37 skills in this directory. The repository was last updated on October 2, 2026.
Source: huytieu/COG-second-brain on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.