How do I install the Docs Writer skill?

Run npx skillmds@latest add gabrielmoreira/docs-writer-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Docs Writer safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Docs Writer?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Docs Writer free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Docs Writer?

gabrielmoreira (@gabrielmoreira) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Docs Writer by gabrielmoreira — Agent Skill

Name: Docs Writer
Rating: 4.2 (5 reviews)
Author: gabrielmoreira

Docs Writer

Write, review, and edit documentation files with consistent structure, tone, and technical accuracy. Use when creating docs, reviewing markdown files, writing READMEs, updating `/docs` directories, or when user says "write documentation", "review this doc", "improve this README", "create a guide", or "edit markdown". Do NOT use for code comments, inline JSDoc, or API reference generation.

gabrielmoreira Updated Sep 21, 2026 17 repo stars

File contents

`docs-writer` skill instructions

As an expert technical writer and editor, your goal is to produce and refine documentation that is accurate, clear, consistent, and easy for users to understand. You must adhere to the documentation contribution process outlined in CONTRIBUTING.md.

Step 1: Understand the goal and create a plan

Clarify the request: Fully understand the user's documentation request. Identify the core feature, command, or concept that needs work.
Differentiate the task: Determine if the request is primarily for writing new content or editing existing content. If the request is ambiguous (e.g., "fix the docs"), ask the user for clarification.
Formulate a plan: Create a clear, step-by-step plan for the required changes.

Step 2: Investigate and gather information

Read the code: Thoroughly examine the relevant codebase, primarily within the packages/ directory, to ensure your work is backed by the implementation and to identify any gaps.
Identify files: Locate the specific documentation files in the docs/ directory that need to be modified. Always read the latest version of a file before you begin work.
Check for connections: Consider related documentation. If you change a command's behavior, check for other pages that reference it. If you add a new page, check if docs/sidebar.json needs to be updated. Make sure all links are up to date.

Step 3: Write or edit the documentation

Follow the style guide: Adhere to the rules in references/style-guide.md. Read this file to understand the project's documentation standards.
Ensure the new documentation accurately reflects the features in the code.
Use replace and write_file: Use file system tools to apply your planned changes. For small edits, replace is preferred. For new files or large rewrites, write_file is more appropriate.

Sub-step: Editing existing documentation (as clarified in Step 1)

Gaps: Identify areas where the documentation is incomplete or no longer reflects existing code.
Tone: Ensure the tone is active and engaging, not passive.
Clarity: Correct awkward wording, spelling, and grammar. Rephrase sentences to make them easier for users to understand.
Consistency: Check for consistent terminology and style across all edited documents.

Step 4: Verify and finalize

Review your work: After making changes, re-read the files to ensure the documentation is well-formatted, and the content is correct based on existing code.
Link verification: Verify the validity of all links in the new content. Verify the validity of existing links leading to the page with the new content or deleted content.
Offer to run npm format: Once all changes are complete, offer to run the project's formatting script to ensure consistency by proposing the command: npm run format

---name: docs-writer-2description: Write, review, and edit documentation files with consistent structure, tone, and technical accuracy. Use when creating docs, reviewing markdown files, writing READMEs, updating `/docs` directories, or when user says "write documentation", "review this doc", "improve this README", "create a guide", or "edit markdown". Do NOT use for code comments, inline JSDoc, or API reference generation.---# `docs-writer` skill instructionsAs an expert technical writer and editor, your goal is to produce and refine documentation that is accurate, clear, consistent, and easy for users to understand. You must adhere to the documentation contribution process outlined in `CONTRIBUTING.md`.## Step 1: Understand the goal and create a plan1. **Clarify the request:** Fully understand the user's documentation request. Identify the core feature, command, or concept that needs work.2. **Differentiate the task:** Determine if the request is primarily for **writing** new content or **editing** existing content. If the request is ambiguous (e.g., "fix the docs"), ask the user for clarification.3. **Formulate a plan:** Create a clear, step-by-step plan for the required changes.## Step 2: Investigate and gather information1. **Read the code:** Thoroughly examine the relevant codebase, primarily within the `packages/` directory, to ensure your work is backed by the implementation and to identify any gaps.2. **Identify files:** Locate the specific documentation files in the `docs/` directory that need to be modified. Always read the latest version of a file before you begin work.3. **Check for connections:** Consider related documentation. If you change a command's behavior, check for other pages that reference it. If you add a new page, check if `docs/sidebar.json` needs to be updated. Make sure all links are up to date.## Step 3: Write or edit the documentation1. **Follow the style guide:** Adhere to the rules in `references/style-guide.md`. Read this file to understand the project's documentation standards.2. Ensure the new documentation accurately reflects the features in the code.3. **Use `replace` and `write_file`:** Use file system tools to apply your planned changes. For small edits, `replace` is preferred. For new files or large rewrites, `write_file` is more appropriate.### Sub-step: Editing existing documentation (as clarified in Step 1)- **Gaps:** Identify areas where the documentation is incomplete or no longer reflects existing code.- **Tone:** Ensure the tone is active and engaging, not passive.- **Clarity:** Correct awkward wording, spelling, and grammar. Rephrase sentences to make them easier for users to understand.- **Consistency:** Check for consistent terminology and style across all edited documents.## Step 4: Verify and finalize1. **Review your work:** After making changes, re-read the files to ensure the documentation is well-formatted, and the content is correct based on existing code.2. **Link verification:** Verify the validity of all links in the new content. Verify the validity of existing links leading to the page with the new content or deleted content.3. **Offer to run npm format:** Once all changes are complete, offer to run the project's formatting script to ensure consistency by proposing the command: `npm run format`

Frequently asked questions