factory-retro

factory-retro is a skill for Claude Code, Codex from squidbay/factory. It costs 110 tokens per session (661 once invoked), scanned A, original, MIT.

A retrospective skill for reviewing a team's work journal, recent code changes, and review discussions to find repeated problems. A retrospective is a structured review of what is going well and what keeps causing trouble.

In plain words
What is it for?
Use it to identify friction patterns, rank them by the time they cost, and propose separate fixes that can be implemented as code changes.
Why use it?
It replaces impressions with evidence from multiple entries and highlights recurring delays, missed work, stalled handoffs, and rules that are repeatedly misunderstood.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/squidbay/factory/factory-retro
Any agent
npx skills add squidbay/factory --skill factory-retro
Clone the repo
git clone --depth 1 https://github.com/squidbay/factory

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for factory-retro

README.md
[![agentmods](https://agentmods.dev/badge/skills/squidbay/factory/factory-retro.svg)](https://agentmods.dev/skills/squidbay/factory/factory-retro)
Your own site
<a href="https://agentmods.dev/skills/squidbay/factory/factory-retro"><img src="https://agentmods.dev/badge/skills/squidbay/factory/factory-retro.svg" alt="Measured on agentmods" height="20"></a>
Per session 110 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 661 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00110 $0.00661
Opus 5 $0.00055 $0.00331
Sonnet 5 $0.00022 $0.00132
Haiku 4.5 $0.00011 $0.00066

Measured 4d ago against content hash 3680937c6ba1, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

factory-retro scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/factory-retro/SKILL.md · 32 lines

How it starts

The opening of the file, as written. The whole thing — 32 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Factory Retro — read the memory, find the friction, propose the fix

You are running a retrospective on this factory. Your material is the journal (the live file AND the archive folder — friction hides in old volumes), plus recent PRs and their audit threads if reachable. Your output is evidence, patterns, proposals — never vibes.

How to run it

  1. Read the journal end to end — newest to oldest, live file first, then journal/. Yes, all of it: single entries lie, patterns don't.
  2. Collect friction with citations. A friction item is a pattern with at least two occurrences, each cited by entry number:
    • the same kind of miss appearing in multiple entries
    • handoffs that repeatedly stall at the same point
    • a rule that keeps getting tripped (which usually means the rule is right and a habit is missing — or the rule needs sharper wording)
    • standing directives that have sat unfulfilled across many entries (RULE 20 material)
    • celebrations that stopped — often the earliest sign a stage quietly broke
  3. Sort by cost, honestly. What actually burns the human's minutes or the team's sessions? Resist the interesting-but-cheap finding.
  4. Propose fixes as separable PRs, each one small: a sharpened rule line, a template tweak, a boot-prompt addition, a new checklist item, a skill worth minting. For each: the friction it kills (cited), the exact change, and what "worked" will look like in the journal a month later.
  5. Deliver as an audit-style report (../../templates/AUDIT-FINDINGS.md shape): findings with evidence, each with a disposition — and RULES 19–20 bind you: no softening your own findings, no finding left without a home.

What you never do

  • Never rewrite history — the journal is append-only memory; retro reads it, PRs change the future.
  • Never propose removing the human gate, however efficient it would be. The gate is the product.
  • Never emit a finding without entry citations. "It feels like…" is not a retro.

Read the full file on GitHub · 32 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 32 lines · 110 tokens per session scan A 3680937c6ba1

Subscribe to this mod's changes

factory-retro is a skill published in the GitHub repository squidbay/factory (5 stars, last pushed 14d ago), licensed MIT. It adds 110 tokens to every session and 661 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

orch

AI agent orchestrator — manage teams of AI agents that work on your codebase in parallel. Use when the user wants to: run multiple agents, coordinate AI work, deploy agent teams, manage tasks/goals/agents, check orchestrator status, or mentions 'orch', 'orchestry', 'agents team', 'agent orchestration'.

oxgeneral/ORCH · 71 tokens

board

Read and write the workspace BOARD.md (shared task board for agents + Val). Wraps bin/board, a small Python CLI that preserves the markdown schema and appends to the activity log automatically. Use this whenever an agent proposes, claims, or finishes work that should be visible to the rest of the roster.

OpenCoven/coven · 66 tokens

org-sync

Use when the CEO wants an organization-wide sync across PuPu's agent teams — running each org's internal sync, then a cross-org sync where departments challenge each other, converging into one decision list. Triggers: "跑一次 org sync", "全局同步", "组织盘点", "/org-sync", "各部门现在什么情况", "有什么要我拍板的".

haoxiang-xu/PuPu · 82 tokens

create-issue

Use when the user wants to turn a rough task idea into a GitHub issue for someone with zero project context. Investigates the codebase with GitNexus and writes an English onboarding brief, then files it via gh. Triggers: "create an issue for X", "write up a task to add Y", "file an issue so a new dev can build Z".

haoxiang-xu/PuPu · 80 tokens

ai-agent-job-marketplace

The job marketplace where bots hire bots. Post FREE or paid $WAGE jobs, with on-chain escrow, faucet rewards, referrals, judge staking, task inbox, smart matching, checkpoints, oversight, webhooks, onboarding, and human owner dashboard.

rondoflow/rondoflow · 56 tokens

agent-freelance-bounty-marketplace

Earn USDC completing bounties, post jobs, join multi-agent raids, build reputation, rank up. AI agent freelance marketplace with x402 escrow on Solana. Free SOL airdrop on signup. Guilds, ranks, vouching, disputes, Castle Town, leaderboard.

rondoflow/rondoflow · 68 tokens