All products

Edit developer documentation with AI

Tighten a README, comment or commit message so a colleague can understand the change without the meeting that preceded it. The guide uses US English.

Edit developer documentation with AI when the code shows what changed but the accompanying explanation still says “as discussed”. The prose skill is Cloudflare’s guide to clear technical English across READMEs, comments, commits and pull requests. It assumes an engineering reader who may be new to this particular project.

If a retry limit changed, a reader can usually find the new number in the diff. The useful detail is which failure prompted that decision. Give the agent that context and it can put the reason in the message, preserve the relevant identifier and remove the recap of your conversation. The guide uses US spelling in the work it edits.

What it does

  • Replace corporate expressions with familiar technical verbs.
  • Give a commit an informative subject and a body explaining why.
  • Remove comments that merely repeat an obvious operation.
  • Keep exact symbol names when describing the affected code.
  • Make a README passage readable without knowledge of an earlier discussion.

Install and use

  1. Install the skill in your agent and supply a draft, plus the relevant change or background.
  2. Ask, “Rewrite this commit message for a reviewer who missed the meeting. Flag anything the draft fails to explain.”
  3. Compare its wording with the diff and check that the reason is accurate.

FAQ

Source

Made by Cloudflare. Original skill: prose, published on GitHub under the MIT licence.

View on GitHub