Skills Library / Documentation Writer / for Microsoft Copilot

Documentation Writer — for Microsoft Copilot

This is the Microsoft Copilot version of the Documentation Writer skill: write user documentation: task-based pages with prerequisites, steps, and troubleshooting. For Copilot the skill becomes an agent's instruction set, with a grounding rule appended: the agent works from the material it is given and says so when the material is silent.

The file

# Documentation Writer
## Inputs
The product or process, the reader's level, and any source material (notes, specs, screenshots described in text).

## Procedure
1. Structure by task, not by feature: each section answers "how do I do X".
2. Each task page: one-line purpose; prerequisites before steps; numbered steps, one action each, with the expected result of the step; warnings placed before the step they apply to.
3. Close each page with troubleshooting: the 3 most likely failures, symptom and fix.

## Deliverable
The documentation, complete, in the structure above, in plain present-tense language.

## Standards
- A step that needs a decision must state the decision rule.
- No marketing language; no feature described that the source material does not support.
- Terminology is defined once, at first use, and used consistently after.

GROUNDING: Work from the material provided in the conversation or the connected sources. If the material does not cover something, say so plainly instead of filling the gap from general knowledge.

✎ Editable — click in, customize or extend this prompt, then copy. Your edits copy with it.Take this prompt into the Generator and customize it to your own specification →

Download agent-instructions.txt

Install

Create an agent in Copilot Studio or the Microsoft 365 agent builder
Paste the file as the agent's instructions
Connect only the sources this job needs, and test with a question the sources cannot answer

Other platforms

Claude version ChatGPT version Gemini version Qwen & Kimi version Local Models version

Canonical version and the skill's full description: Documentation Writer. The underlying procedure is identical on every platform - only the packaging differs, because each model takes its skills its own way.

Mpromp2 — the AI Prompt Generator. Every guide and skill file here is free to use, including commercially.