write-from-scratch

name

write-from-scratch

description

Writes a brand-new documentation article (.mdx) from scratch based on provided source material — a Jira ticket or brief, a Confluence page/URL, or a plain free-text description — following the project's content types, style guide, and MDX/frontmatter rules. Use this skill when the user wants to create a page that does not yet exist, with phrases like "write a new doc", "create a doc for this feature", "draft documentation from this Jira ticket", "turn this Confluence page into an article", "document this new API endpoint from scratch", or "write up a guide for X". It picks the article type, chooses the right structure, finds the file path and a reference article, drafts the content, marks unverified facts as TODO, verifies agent-added claims, and produces compliant frontmatter. Do not use it to edit, update, audit, or fix an existing article.

@../../../.agents/skills/write-from-scratch/SKILL.md