scan-new-specs
Installation
SKILL.md
scan-new-specs
Scan warpdotdev/warp and warp-server for recently merged product or tech specs that lack a corresponding docs draft. For each gap:
- If the spec is complete — automatically run
write-feature-docsin ambient mode to generate a full draft PR inwarpdotdev/docs, then ping the engineer to review it - If the spec is thin — ping the engineer directly to either flesh out the spec or kick off the docs workflow manually
In both cases, post a summary to #growth-docs.
Configuration
Before running, confirm these values (or accept the defaults):
| Setting | Default | Description |
|---|---|---|
LOOKBACK_DAYS |
3 |
How many days back to scan for merged spec PRs |
SLACK_CHANNEL |
#growth-docs |
Slack channel for engineer pings and summaries |
SLACK_BOT_TOKEN |
From buzz environment |
Slack bot token for posting via API (already available in the buzz Oz environment) |