“对一次 coding session 做 retrospective。”

— description from SKILL.md by vinvcn
MITAuto-check passedProduct & Project Management

Install Retro

skills CLI
$ npx skills add vinvcn/mattpocock-skills-zh-CN --skill retro -a claude-code

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

GitHub CLI
$ gh skill install vinvcn/mattpocock-skills-zh-CN retro --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/vinvcn/mattpocock-skills-zh-CN.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/in-progress/retro .claude/skills/retro && 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
retro
GitHub stars
4.7k
Token cost
~659 tokens
SKILL.md length
253 words
Files
2
Skills in repo
33
Repo updated
First seen
Licence
MIT

At a glance

  • Works in 3 steps: 调用 Skill 工具并指定… → 阅读用户指定 session 的 primary… → 在以下类别中寻找改进候选项。
  • SKILL.md covers Steps and Reference
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

About this skill

Retro is a skill in vinvcn/mattpocock-skills-zh-CN (4.7k stars). Its SKILL.md is about 659 tokens, with 1 other file in the folder. Licence: MIT.

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. 调用 Skill 工具并指定 writing-for-agents,获取写作风格指南。
  2. 阅读用户指定 session 的 primary sources。这可能意味着在本机搜索 session logs。如果用户没有指定 session,默认使用当前 session。
  3. 在以下类别中寻找改进候选项。

What it can do on your machine

Read from SKILL.md and the folder at commit 3f92a83. 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

Retro loads about 659 tokens when it runs. Until then it costs about 10 tokens; SKILL.md has 253 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~10
When it runs · the whole SKILL.md, loaded when a task matches
~659

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 vinvcn/mattpocock-skills-zh-CN at commit 3f92a83, republished under its MIT licence (© vinvcn). 253 words, ~659 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
对一次 coding session 做 retrospective。
disable-model-invocation
true

用户要求做一次 retrospective。你要针对 coding agent 的 environment 提出改进建议,以改善未来的运行结果。

Steps

  1. 调用 Skill 工具并指定 writing-for-agents,获取写作风格指南。

  2. 阅读用户指定 session 的 primary sources。这可能意味着在本机搜索 session logs。如果用户没有指定 session,默认使用当前 session。

  3. 在以下类别中寻找改进候选项。

  • Navigation:agent 找到正确 files 有多容易?files 之间是否存在隐藏依赖?navigation pointer 能否让定位更容易?当 agent 花了很长时间才找到某段信息时使用。
  • Automated checks:是否有 automated checks 可以捕获 agent 犯的错误?例如 linting、typing、tests 或 filesystem linters?先阅读 repo 自己的检查命令(package.json/build-tool 中的 lint/check scripts 以及 CI workflow),这样,如果某个检查已经存在但没有接入流程或悄悄失效,真正的发现就是这个问题,而不是重新发明一套检查。若 repo 完全没有 guardrail(没有 pre-commit hook,也没有运行 lint/typecheck/test command 的 CI job),这本身就是一项发现:未纳入 lint 的 repo 是长期存在的改进缺口,而不是理所当然的默认状态。当 agent 犯了本来可以被 automated check 捕获的错误,或 repo 完全没有 guardrail 时使用。
  • Coding standards:是否应该给 reviewer agent 一条新规则来执行?是否应该删除或澄清现有规则?先对违规分类:mechanical 违规(固定的语法模式、被禁用的 API、import 形式、文件位置规则)必须交给 deterministic check 处理——根据 repo 使用的语言和现有 guardrail,选择成本最低的方式:在 repo 自己的 linter 中添加自定义规则、新增 pre-commit hook,或新增 CI job。默认优先构建检查,而不是编写规则。CODING_STANDARDS.md 只用于真正的 judgement calls(跨文件一致性、"matches the surrounding style",以及任何 guardrail 都无法替代的判断)。当 reviewer agent 没有发现一个错误时使用。
  • Global AGENTS.md:是否有 steering instructions 应该移到 coding standards 或 automated checks?当 repo 或用户 global scope 中的 AGENTS.md 特别庞大时使用。
  • Tool economy:agent 是否进行了可以简化的昂贵 tool calls?是否有特别消耗 tokens 的自定义 tooling(CLI、MCP 等)?当 agent 进行昂贵 tool call 时使用。
  • No-ops:steering files 中是否有不改变 agent 行为的 instructions?当 steering files 庞大且难以维护时使用。
  • Information access:是否有机会让 agent 获得更多信息?例如把 dev server logs tee 出来,或提供对 third-party services 的 read-only access。当关键的信息对 agent 不可用时使用。
  1. 按严重程度顺序向用户呈现这些候选项。

Reference

Implementation vs Review

记住,所有工作都经过两个阶段:implementation 和 review。implementation agent 承受最大的 context pressure,负责探索、编写代码和调试失败。

review agent 承受最小的 context pressure——它收到的是 diff,因此不需要探索。它通常也不需要编写代码或调试。

因此,review agent 应负责施加 coding standards,而不是 implementation agent。

Files

你可以访问 repo 中的几个 files:

  • CLAUDE.md/AGENTS.md:这些 files 会被推入在此 repo 工作的任何 agent 的 context window。应当极其节制地使用,通常只放指向其他 files 的 navigation pointers。
  • CODING_STANDARDS.md:这个 file 在 review 时读取,而不是 implementation 时读取。如果 standards file 超过 1,000 行,应当在其中加入指向 docs folders 的 navigation pointers。
  • Docs:把 docs 当作 reference files,由其他 files 通过 pointers 指向。写新 docs 前先查找已有 docs。
  • Skills:用 skills 承载 docs(因为它们的 description 会进入 agent 的 context window),或用于 user-invoked commands。遵循 writing-for-agents skill 中的建议。

© vinvcn, 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 in skills/in-progress/retro of vinvcn/mattpocock-skills-zh-CN.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 3f92a83

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.

Retro compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Retro this skillvinvcn/mattpocock-skills-zh-CN4.7k—~659Automated safety check: PassMIT
Oral Paper SkillAdkid-Zephyr/oral-paper-skill340—~1.9kAutomated safety check: PassNone
Weekly Engineering Retrogarrytan/gstack136k—~2.4kAutomated safety check: PassMIT
Dough Execute Planterryyin/lizard2.5k—~4.3kAutomated safety check: PassCustom licence
After Action Reportrampstackco/claude-skills9401 repos~2.5kAutomated safety check: PassMIT
Deck Retroasheshgoplani/agent-deck1k—~1.8kAutomated safety check: PassMIT

Similar skills

  • 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.

    340 GitHub stars~1.9k tokensUpdated 21 days ago
    Product & Project ManagementAuto-check passed
  • 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 yesterday
    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 2 days ago
    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.

    940 GitHub starsUsed in 1 repo~2.5k tokens
    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 3 days ago
    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 2 days ago
    Product & Project ManagementAuto-check passed

More from vinvcn/mattpocock-skills-zh-CN

All 33 skills in this repo
  • Git Guardrails Claude Code

    vinvcn/mattpocock-skills-zh-CN

    设置 Claude Code hooks,在危险 git commands(push、reset --hard、clean、branch -D 等)执行前阻止它们。适用于用户想防止破坏性 git 操作、添加 git safety hooks,或在 Claude Code 中阻止 git push/reset 时。

    4.7k GitHub stars~474 tokensUpdated 10 days ago
    Auto-check passed
  • Codebase Design

    vinvcn/mattpocock-skills-zh-CN

    用于设计深模块的共享词汇。适用于用户想设计或改进模块接口、寻找深化机会、决定 seam 放在哪里、让代码更容易测试或更适合 AI 导航,或其他技能需要深模块词汇时。

    4.7k GitHub stars~1.1k tokensUpdated 10 days ago
    Auto-check passed
  • Diagnosing Bugs

    vinvcn/mattpocock-skills-zh-CN

    面向棘手缺陷和性能回退的诊断循环。适用于用户说 “diagnose” / “debug this”,或报告某些东西 broken、throwing、failing、slow 时。

    4.7k GitHub stars~1.4k tokensUpdated 10 days ago
    Auto-check passed
  • Domain Modeling

    vinvcn/mattpocock-skills-zh-CN

    构建并打磨项目的领域模型。适用于讨论 codebase 术语、编写或编辑 CONTEXT.md,或记录或编辑 ADR. An agent skill from vinvcn/mattpocock-skills-zh-CN.

    4.7k GitHub stars~505 tokensUpdated 10 days ago
    Auto-check passed
  • Migrate To Shoehorn

    vinvcn/mattpocock-skills-zh-CN

    将测试文件从 as 类型断言迁移到 @total-typescript/shoehorn。适用于用户提到 shoehorn、想替换测试中的 as,或需要局部测试数据时。

    4.7k GitHub stars~619 tokensUpdated 10 days ago
    Auto-check passed
  • PR

    vinvcn/mattpocock-skills-zh-CN

    用于撰写 PR 正文。适用于用户要求起草、改写或改进 PR 正文,或希望 PR 更便于审阅时. An agent skill from vinvcn/mattpocock-skills-zh-CN.

    4.7k GitHub stars~737 tokensUpdated 10 days ago
    Auto-check passed

Questions about Retro

How do I install Retro in Claude Code?

Run `npx skills add vinvcn/mattpocock-skills-zh-CN --skill retro -a claude-code`. Or copy the skill folder (skills/in-progress/retro in vinvcn/mattpocock-skills-zh-CN) 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 vinvcn/mattpocock-skills-zh-CN --skill retro -a codex`. Or copy the skill folder (skills/in-progress/retro in vinvcn/mattpocock-skills-zh-CN) 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 vinvcn/mattpocock-skills-zh-CN --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?

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

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 659 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Retro?

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

Who maintains Retro?

vinvcn (a GitHub user) maintains it in vinvcn/mattpocock-skills-zh-CN, which has 4,657 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on September 28, 2026.

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