regenerating-overviews
Regenerating Overviews
Org overviews are short knowledge pages summarizing what an org has shipped recently. Regeneration is agent-driven: this skill carries the prompt and structure rules; the API exposes a pure-data input builder and a dumb upsert.
No managed-agent task exists for this today. You — the Claude Code instance reading this skill — are the agent. The CLI is a thin client.
When to Use
- Single org refresh: "regenerate the vercel overview"
- Inside
maintaining-orgsbatch runs: each per-org sub-agent runs this skill - After significant source mutations: a new active source landed, an old one was hidden
- After backfilling a window of releases: stale overview no longer reflects current focus
Skip on-demand orgs. If org.discovery === 'on_demand', do not regenerate — the API-side overview workflow already gates on this column, and generating an overview for an org that hasn't been curated wastes tokens. The releases admin overview plan / overview list endpoints already filter to curated orgs server-side via the organizations_active view, so manifest-driven sweeps don't need a separate filter pass.
Workflow
Three steps. Each step is a single CLI invocation; no other tools needed.