refine
Surface-level editing and proofreading for Markdown files.
Install
mkdir -p .claude/skills/refine && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/10064" && unzip -o skill.zip -d .claude/skills/refine && rm skill.zipInstalls to .claude/skills/refine
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Proofread Markdown without changing structure or voice. Use when editing or writing new material. to fix punctuation, typos, misspellings, grammar, and similar errors while preserving headings, bullets, links, frontmatter, formatting, and the author's style.Key capabilities
- →Fix punctuation and grammar
- →Correct typos and misspellings
- →Preserve Markdown structure
- →Maintain author voice and style
- →Apply minimal edits
How it works
It performs surface-level corrections on Markdown files while strictly adhering to existing formatting and structural constraints.
Inputs & outputs
When to use refine
- →Proofreading technical guides
- →Fixing grammar in docs
- →Cleaning up markdown punctuation
About this skill
Refine
Fix punctuation, typos, misspellings, grammar, and similar surface-level issues in Markdown.
Constraints
- Preserve the author's voice.
- Preserve the existing structure.
- Keep edits scoped to what the user asked to change.
- Do not rewrite for style unless the original wording is clearly broken.
- Follow the repository Markdown instructions.
Procedure
- Fix surface-level errors first.
- Make the smallest set of edits needed.
When not to use it
- →Rewriting content for style
- →Changing document structure
Limitations
- →Do not rewrite for style unless clearly broken
How it compares
It focuses on minimal, non-intrusive corrections rather than stylistic rewriting or structural reorganization.
Compared to similar skills
refine side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| refine (this skill) | 0 | 5mo | No flags | Beginner |
| write-docs | 6 | 3mo | No flags | Beginner |
| docs-changelog | 4 | 4mo | No flags | Beginner |
| docs-writer | 4 | 3mo | No flags | Beginner |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by parsiya
View all by parsiya →You might also like
write-docs
tldraw
Writing SDK documentation for tldraw. Use when creating new documentation articles, updating existing docs, or when documentation writing guidance is needed. Applies to docs in apps/docs/content/.
docs-changelog
google-gemini
Provides a step-by-step procedure for generating Gemini CLI changelog files based on github release information.
docs-writer
google-gemini
Always use this skill when the task involves writing, reviewing, or editing files in the `/docs` directory or any `.md` files in the repository.
technical-docs
getsentry
Write and review technical documentation for Sentry SDK docs. Use when creating, editing, or reviewing documentation pages, especially MDX files in docs/platforms/.
vuepress-plume-markdown
pengzhanbo
Help users write markdown files with VuePress Plume theme extensions, charts, and embeds.
repo-website-guide-create
open-circle
Create conceptual documentation and tutorial pages for the Valibot website at website/src/routes/guides/. Use when adding guides about schemas, pipelines, async validation, migration, or other topics. Covers directory structure, MDX templates, frontmatter, and content guidelines.