scan-new-specs

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-docs in ambient mode to generate a full draft PR in warpdotdev/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)