How does this skill improve technical documentation?

It enforces a professional tone by prioritizing active voice, removing filler words, and structuring data into scannable formats like tables and bulleted lists.

Can it help with document navigation?

Absolutely. It adds workspace-relative cross-references and ensures every document starts with a clear purpose or summary for better discoverability.

What document types does the docs-style skill support?

It supports a wide range of reader-facing files including READMEs, technical guides, tutorials, changelogs, Architecture Decision Records (ADRs), and design documents.

Does this skill work with any programming language?

Yes, the skill is designed to be project-agnostic, making it suitable for documentation in Python, JavaScript, Go, or any other software project.

Is the documentation output compatible with version control?

Yes, it follows standard Markdown formatting patterns, including consistent line wrapping and fenced code blocks, which are ideal for Git-based workflows.

Documentation Style Guide

Name: Documentation Style Guide
Author: ricardoroche

byricardoroche

0•

학습 및 문서화

Enforces professional voice, technical clarity, and standardized navigation patterns across all project documentation and guides.

The Documentation Style Guide skill automatically enhances the quality of reader-facing content by enforcing a concise, active voice and structured navigation. It is designed to assist developers and technical writers in creating high-quality READMEs, changelogs, Architecture Decision Records (ADRs), and tutorials. By removing filler language and organizing information into scannable chunks with tables and cross-references, this skill ensures that documentation remains project-agnostic, professional, and easy for any contributor to navigate.

주요 기능

01Enforcement of active voice and direct, concise sentence structures.

02Removal of marketing fluff and unnecessary filler language.

03Automated formatting for scannable tables, bullets, and fenced code blocks.

04Standardized navigation patterns including summaries and relative cross-linking.

05Consistency checks for terminology and workspace-relative file paths.

060 GitHub stars

사용 사례

01Drafting clear and concise Architecture Decision Records (ADRs) for system design.

02Refining technical tutorials and changelogs to ensure clarity and scannability.

03Standardizing repository READMEs and onboarding guides for new contributors.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ricardoroche/ricardos-claude-code docs-style

For use in Claude.ai and ChatGPT

Download Skill