How does this skill improve README files?

It enforces a logical section ordering—from overview to troubleshooting—ensuring your project documentation is professional, consistent, and easy for users to navigate.

Can I use this for change management?

Yes, the skill includes specialized templates for OpenSpec proposals and Spec Deltas designed specifically for proposing and tracking system requirement changes.

What is an ADR in this context?

An Architecture Decision Record (ADR) is a document that captures an important architectural decision made along with its context and consequences. This skill provides a template to ensure all necessary details are recorded.

Does it integrate with other agents?

Yes, it is designed to be used by agents like 'spec-writer' and 'technical-writer' to provide the structural foundation before drafting full documentation.

Spec & Documentation Templates

Name: Spec & Documentation Templates
Author: ricardoroche

byricardoroche

0•

Learning & Documentation

Provides standardized markdown templates for architectural decisions, project specifications, and technical documentation.

Spec & Documentation Templates is a specialized Claude Code skill designed to streamline the technical writing process by providing reusable outlines for essential project documents. It offers standardized structures for OpenSpec proposals, Architecture Decision Records (ADRs), implementation task lists, and comprehensive README files. By integrating these patterns directly into the Claude environment, the skill ensures consistency across development teams, improves communication through clear documentation standards, and helps developers bridge the gap between initial planning and final implementation.

Key Features

01Standardized ADR (Architectural Decision Record) outlines

02OpenSpec proposal templates for formal change requests

030 GitHub stars

04Automated README and changelog structural ordering

05Implementation task and checklist generators

06Spec Delta templates for tracking requirement changes

Use Cases

01Drafting formal design documents for team review and approval

02Structuring comprehensive project READMEs and changelogs for software releases

03Documenting architectural decisions to maintain a history of technical choices

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ricardoroche/ricardos-claude-code spec-templates

For use in Claude.ai and ChatGPT

Download Skill