doc-writer

Installation
SKILL.md

Document a Feature

Help document a new or updated VS Code feature in the project documentation (the docs/ folder). This skill works in two phases: it first researches the feature and proposes a documentation plan, then implements the changes only after you approve. It is acceptable to conclude that no documentation update is needed.

When to Use

Use this skill whenever the request maps to any of these — do not start editing docs directly without first running Phase 1:

  • The user says "document this", "document this functionality/feature", "add docs for…", "write docs for…", or "update the docs for…".
  • The user pastes a GitHub issue or PR link and asks you to document or address it in the docs.
  • Documenting a new or changed VS Code or GitHub Copilot feature.
  • Turning a GitHub issue or PR into concrete docs/ updates.
  • Auditing whether existing docs need updating after a feature change.

This applies even when the change looks small (a clarification, a few added steps, a single section). Run the plan-first workflow rather than jumping straight to edits.

Do not use this skill for release notes, API reference docs, redirects, image swaps, or pure copy-edits — those are handled by other skills (release-note-writer, content-redirect, frontmatter-description) or direct edits.

Guardrails

Installs
4
GitHub Stars
6.6K
First Seen
Jul 10, 2026
doc-writer — microsoft/vscode-docs