write-feature-docs

SKILL.md

write-feature-docs

Draft a complete documentation page for a new Warp feature. You read the feature's spec, verify technical claims by researching the codebase yourself, present a concise outline for the engineer to confirm, then produce a complete MDX draft and open a draft PR in warpdotdev/docs — tagging the docs team for review.

The engineer's job is to confirm what you couldn't verify from the spec and code — not to do a full accuracy review, not to polish prose, not to know docs conventions.

The workflow

Find and read the spec files

Research the codebase to verify technical claims — minimize what the engineer needs to check

Generate a concise outline and wait for engineer confirmation

Generate the complete MDX draft
4.5. Attempt screenshot capture via computer use (if available)

Open a draft PR in warpdotdev/docs and tag the docs team

Step 1: Find and read the spec