Rewrite and polish Markdown documents while preserving original ideas.
npx skills add https://github.com/ZhuoZhuoCrayon/ai-workspace --skill doc-style
Please help me install this Agent Skill. Skill: doc-style Source: https://github.com/ZhuoZhuoCrayon/ai-workspace/tree/main/.agents/skills/doc-style Command: npx skills add https://github.com/ZhuoZhuoCrayon/ai-workspace --skill doc-style
## What problem does it solve? Doc Style enables teams to design, restructure, polish, and validate Markdown documents before delivery, reducing ambiguity and ensuring consistent quality.
## Core Features & Use Cases
### Quick Start Provide a ready-made Markdown draft and refine its structure using this skill.
High-intent search queries and answers about installing and using this skill.
Markdown structure and polish involves rewriting drafts to improve clarity, conciseness, and readability. It identifies your document goal, organizes content into clear sections, aligns terminology, and validates against review requirements while preserving original ideas.
The best way to restructure long-form Markdown docs is to apply a structured approach that compresses content and organizes sections. This ensures the output is well-scoped, clear, and meets project style requirements for files like README or troubleshooting guides.
Adapting Markdown content for GitHub comments and PR reviews involves tailoring the polished documentation for different stakeholders. The process ensures the rewritten output meets specific review requirements and fits the intended deliverable context.
Polishing Markdown documentation preserves original ideas completely. The rewriting process improves clarity, formatting, and terminology consistency while ensuring the core technical substance and meaning of the draft remain intact.
Aligning terminology across Markdown troubleshooting guides requires applying project style rules during the polishing phase. The process rewrites content to ensure consistent term usage and validates the output against specific review requirements.
Automated Markdown rewriting should be avoided when your draft lacks a clear document goal or defined deliverable. The process requires a ready-made draft to identify scope and apply structured polishing, rather than generating content from scratch.
deMGoncalvesDecompose large specifications into atomic implementation tasks with dependencies and acceptance criteria.
ExpeditoJIntegrate local knowledge bases and perform semantic search for AI agents.
akillnessValidate architecture plans against project domain language in CONTEXT.md and ADRs.
flowelDetect and correct AI writing patterns in text.
