feat(platform): Prose drafting/revising skill

[cloudjumpercat]

Description

This skill is mean to help us draft prose for scaffolded docs, new docs, or help with revisions to existing docs.

I wrote this skill specifically to expect context and some sort of outline from the writer. Without an outline (it wants headings/a sentence for new pages and expects a sentence or two for new sections/revisions), Claude's drafts need too much steering and rework in my opinion. Outlines also require us to know the feature well enough ourselves to know what we want on the page.

This hasn't been tested yet, but I have several candidates that I'll be testing both the new prose creation and revisions on.

From testing:

• New page test: On Claude using the prose skill for OIDC AIGW 2.0, it used the skill for planning but there was no loop for it to use the skill rules for the actual line writing. It missed several rules because of this, so I'm going to add a step and tell it to use the skill for planning and then for the actual writing. Because the line quality was poor. I also didn't tell it what to use for the frontmatter description, so I need to be more explicit about that as well.

TODO:

• Add "reach for", "carrying" to anthropomorphism and make it clearer that these are just examples.
• Add step 3.5 so that Claude checks the drafted page against page-mechanics and fixes any changes before handing the writer the finished draft.
• Add description: frontmatter example.
• Claude can only suggest FAQ. It is up to the writer to request an FAQ. If Claude sees something that would make a good candidate, flag it to the writer, but the writer has the final say.
• Use the skill refiner/reviser to fix the skill.
• Due to RAG (and best practices), do not write the sentences below a heading assuming the reader is using context from the heading. They must both stand on their own. For example, a heading of "Authorization code flow" the sentence cannot be "This is the three-legged OAuth/OpenID Connect flow, including session cookie issuance." "this" in that sentence assumes the context of the heading. Instead, it should restate it like "The authorization code flow is a three-legged OAuth/OpenID Connect flow, including session cookie issuance."
• We need to note somehow that this skill should NOT be used for migration content where you are pretty much copy/pasting whole sections over with only a few changes. It could revise the words in the content, but when you try to do this skill + a content migration, it gets confused and tries to edit the words while also migrating.
• default to aigw skill instead of this one

Preview Links

Checklist

• Tested how-to docs. If not, note why here.
• All pages contain metadata.
• Any new docs link to existing docs.
• All autogenerated instructions render correctly (API, decK, Konnect, Kong Manager).
• Style guide (capitalized gateway entities, placeholder URLs) implemented correctly.
• Every page has a description entry in frontmatter.
• Add new pages to the product documentation index (if applicable).

[netlify]

✅ Deploy Preview for kongdeveloper ready!

Name	Link
🔨 Latest commit	8dfd9df
🔍 Latest deploy log	https://app.netlify.com/projects/kongdeveloper/deploys/6aad9293cbe5860008334cfb
😎 Deploy Preview	https://deploy-preview-7262--kongdeveloper.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
🤖 Make changes	Run an agent on this branch

---

To edit notification comments on pull requests, go to your Netlify project configuration.