skill package

Docs Polish Agent

Rewrites READMEs, install guides, examples, and marketplace copy so skills are clear, credible, and runnable.

DocumentationReviewedvv1.0.0publicAdmin

91% eval4.7 rating933 installs6 targets

Edit in Build

Permissions, source, and what this skill claims to do.

Contract

What this skill may access, and where it can install.

read_fileslow risk

Read SKILL.md, README, examples, changelog, and source docs.

write_filesmedium risk

Write improved documentation, examples, and install snippets.

Compatibility

CodexClaudeAntigravityOpenCodeGrokVS Code

Source

README and SKILL.md for the current version.

README

Docs Polish Agent improves the trust surface of a skill package: README, examples, install docs, troubleshooting, and marketplace copy.

SKILL.md

---
name: docs-polish-agent
description: Improve agent-skill documentation so users understand what the skill does, when to use it, how to install it, and how to verify it works.
---

# Docs Polish Agent

Improve agent-skill documentation so users understand what the skill does, when to use it, how to install it, and how to verify it works.

Use this skill when the user needs a controlled agent workflow with clear inputs, bounded actions, traceable decisions, and a final artifact that another agent or developer can use immediately.

## Workflow
1. Read the skill package, existing docs, examples, install snippets, and any trace or eval evidence.
2. Identify unclear promises, missing prerequisites, weak examples, and unsupported claims.
3. Rewrite docs in a direct developer-tool voice with concrete commands and expected outputs.
4. Preserve technical accuracy and avoid marketing claims that the package does not prove.
5. Add quickstart, compatibility notes, permissions rationale, troubleshooting, and evaluation examples.
6. Return the improved docs plus a short explanation of what changed and why.

## Permissions
- read_files: Read source documentation and skill package files.
- write_files: Write polished README, install guides, examples, and changelog text.

## Compatibility
- Codex
- Claude
- Antigravity
- OpenCode
- Grok
- VS Code

## Output Format
- Improved README
- Install instructions
- Usage examples
- Permissions explanation
- Troubleshooting notes
- Change summary

## Examples
- "Polish this skill README so a developer can install and run it in five minutes."
- "Rewrite the marketplace copy for this skill without hype."
- "Create install docs for Codex, Claude, OpenCode, Grok, Antigravity, and VS Code."

Reception

Community feedback for this skill.

No reviews yet.

Loading studio…

--- name: docs-polish-agent description: Improve agent-skill documentation so users understand what the skill does, when to use it, how to install it, and how to verify it works. --- # Docs Polish Agent Improve agent-skill documentation so users understand what the skill does, when to use it, how to install it, and how to verify it works. Use this skill when the user needs a controlled agent workflow with clear inputs, bounded actions, traceable decisions, and a final artifact that another agent or developer can use immediately. ## Workflow 1. Read the skill package, existing docs, examples, install snippets, and any trace or eval evidence. 2. Identify unclear promises, missing prerequisites, weak examples, and unsupported claims. 3. Rewrite docs in a direct developer-tool voice with concrete commands and expected outputs. 4. Preserve technical accuracy and avoid marketing claims that the package does not prove. 5. Add quickstart, compatibility notes, permissions rationale, troubleshooting, and evaluation examples. 6. Return the improved docs plus a short explanation of what changed and why. ## Permissions - read_files: Read source documentation and skill package files. - write_files: Write polished README, install guides, examples, and changelog text. ## Compatibility - Codex - Claude - Antigravity - OpenCode - Grok - VS Code ## Output Format - Improved README - Install instructions - Usage examples - Permissions explanation - Troubleshooting notes - Change summary ## Examples - "Polish this skill README so a developer can install and run it in five minutes." - "Rewrite the marketplace copy for this skill without hype." - "Create install docs for Codex, Claude, OpenCode, Grok, Antigravity, and VS Code."