{
  "markdown": "# do-retro\n\nA Claude Code skill that generates or updates `docs/PROJECT_HISTORY.md` for a project — a chronicle of its development history built from git commits, design decisions made during sessions, and every user prompt pulled from Claude Code transcripts. Also produces a \"Retroactive Learning/Improvements\" section: hindsight lessons drawn from rework, repeated fixes, and regretted decisions visible in the history.\n\nGenerated files open with a note that they were produced using the do-retro skill from the [keithmackay/mackayi](https://github.com/keithmackay/mackayi) marketplace.\n\n## Installation\n\n### From the mackayi marketplace (recommended)\n\n```\n/plugin marketplace add keithmackay/mackayi\n/plugin install do-retro@mackayi\n```\n\n### Claude Code\n\n```bash\ncp -r /path/to/do-retro/ ~/.claude/skills/do-retro/\n```\n\nOr symlink:\n```bash\nln -s /path/to/do-retro/ ~/.claude/skills/do-retro\n```\n\nThen invoke by asking Claude to \"do a retro\" or \"generate the project history\" — no explicit `/` command is needed; see Usage below.\n\n### Codex\n\nPlace the plugin directory where Codex can find it, then add an entry to your marketplace:\n\n**`~/.agents/plugins/marketplace.json`** (create if absent):\n```json\n{\n  \"name\": \"personal\",\n  \"interface\": { \"displayName\": \"Personal Plugins\" },\n  \"plugins\": [\n    {\n      \"name\": \"do-retro\",\n      \"source\": { \"source\": \"local\", \"path\": \"/path/to/do-retro/\" },\n      \"policy\": { \"installation\": \"AVAILABLE\", \"authentication\": \"ON_INSTALL\" },\n      \"category\": \"Productivity\"\n    }\n  ]\n}\n```\n\n### Antigravity\n\n**Global install** (all workspaces):\n```bash\ncp -r /path/to/do-retro/ ~/.gemini/antigravity/skills/do-retro/\n```\n\n**Workspace install** (current project only):\n```bash\ncp -r /path/to/do-retro/ .agents/skills/do-retro/\n```\n\nThe root `SKILL.md` has no Claude Code-specific metadata, so it is used as-is — no separate Antigravity variant is needed.\n\nSkills are auto-discovered. You can also mention the skill by name to force activation.\n\n### Gemini CLI\n\nGemini CLI installs extensions directly from GitHub:\n\n```bash\ngemini extensions install https://github.com/keithmackay/do-retro\n```\n\nTo update:\n```bash\ngemini extensions update do-retro\n```\n\nThe skill is auto-discovered from `GEMINI.md` after installation.\n\n## Compatibility\n\n| Feature | Claude Code | Codex | Antigravity | Gemini CLI |\n|---------|:-----------:|:-----:|:-----------:|:----------:|\n| Core skill | ✅ | ✅ | ✅ | ✅ |\n| Sub-documents (`references/`) | ✅ | ✅ | ✅ | ✅ |\n| Script (`scripts/extract-prompts.js`) | ✅ | ✅ | ✅ | ✅ |\n\nNo Claude Code-specific frontmatter (`metadata`, `retrieval`, `tags`) or subagent dispatch is used by this skill, so there are no platform gaps to document — it ports cleanly to all four platforms. The `extract-prompts.js` script reads Claude Code transcripts specifically (`~/.claude/projects/<encoded-project-path>/*.jsonl`); on non-Claude-Code platforms it will find no transcripts to parse, which the skill already treats as informational rather than a blocking error.\n\nLegend: ✅ Supported · ❌ Not supported\n\n## References\n\n- **Claude Code Skills:** https://code.claude.com/docs/en/skills\n- **Claude Code Complete Guide (PDF):** https://resources.anthropic.com/hubfs/The-Complete-Guide-to-Building-Skill-for-Claude.pdf\n- **Codex Plugins:** https://developers.openai.com/codex/plugins/build\n- **Antigravity Skills:** https://antigravity.google/docs/skills\n- **Gemini CLI Extensions:** https://github.com/google-gemini/gemini-cli/blob/main/docs/extension.md\n- **Agent Skills open standard:** https://agentskills.io/home\n\n## Usage\n\nIn a Claude Code session inside any git project, ask Claude to \"do a retro\" or \"generate the project history\" — it will invoke this skill automatically.\n\nYou can also ask for just a subset of the history, which is written to its own file instead of the full `docs/PROJECT_HISTORY.md`:\n\n| Flag | Output file |\n|------|-------------|\n| `--prompts` | `docs/PROJECT_HISTORY_PROMPTS.md` |\n| `--timeline` | `docs/PROJECT_HISTORY_TIMELINE.md` |\n| `--decisions` | `docs/PROJECT_HISTORY_DECISIONS.md` |\n| `--learnings` | `docs/PROJECT_HISTORY_LEARNINGS.md` |\n\nAdd `--dry-run` (alone or combined with any subset flag) to preview what would be written — which file(s) would be created or appended to, and a summary of the sections/counts that would be added — without writing anything.\n\n## How it works\n\nThe skill walks git history, project metadata, and README content, then runs `scripts/extract-prompts.js` to pull every user prompt from that project's Claude Code transcripts (`~/.claude/projects/<encoded-project-path>/*.jsonl`). It writes or appends to `docs/PROJECT_HISTORY.md`, never overwriting prior sections.\n\n## Changelog\n\nSee [CHANGELOG.md](CHANGELOG.md) for release history.\n\n## License\n\n[MIT](LICENSE)\n",
  "bytes": 4777,
  "sha": "70192432fe3b77dcfc28079b65cf7126eb7ce43060ea72f575088c768090e5ed",
  "repo_slug": "keithmackay/do-retro",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_keithmackay_do_retro_94860a1e/readme"
}