Does this skill help with API reference documentation?

Yes, it provides specific standards for documenting endpoints, including parameter types, return values, and actionable error messages with specific solutions.

How are code samples handled?

The skill enforces a strict checklist requiring that all code samples include imports, initialization, error handling, and output to ensure they are 'copy-paste ready' and runnable.

What is the core principle of this documentation skill?

The core principle is that documentation exists to serve the reader's needs rather than simply demonstrating the developer's knowledge, focusing on task-centered content.

Can it help me write better changelogs?

Yes, it provides guidelines for human-written changelogs using semantic versioning and ISO dates, moving away from raw, hard-to-read commit logs.

Technical Documentation Standards

Name: Technical Documentation Standards
Author: jagreehal

byjagreehal

0•

Learning & Documentation

Standardizes technical writing with a reader-centric framework focused on clarity, accuracy, and runnable code examples.

This skill equips Claude with a robust framework for creating high-quality technical documentation that prioritizes the reader's needs over the author's knowledge. It enforces eight critical quality dimensions—including clarity, usability, and completeness—while providing specific patterns for READMEs, API references, tutorials, and changelogs. By mandating tested, copy-paste ready code samples and active-voice writing principles, it ensures that project documentation is functional, accessible, and highly maintainable for any development team.

Key Features

01User-centered quality framework with 8 core dimensions

02Structured requirements for READMEs, API refs, and tutorials

03Strict code sample validation for complete, runnable examples

04Comprehensive review checklist for documentation auditing

050 GitHub stars

06Technical writing principles for sentence and paragraph clarity

Use Cases

01Generating professional READMEs and API references for new software projects

02Auditing and refactoring existing documentation to improve clarity and usability

03Creating step-by-step tutorials with verified code samples and prerequisites

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jagreehal/jagreehal-claude-skills documentation-standards

For use in Claude.ai and ChatGPT

Download Skill