skills.rest
ricardoroche
ricardorocheCOMMUNITY
Explore all skills by this author →
GitHub

spec-templates

Generate Markdown templates for proposals, design docs, ADRs, READMEs, and changelogs.

2|Updated Nov 13, 2025
Search Tags:#changelog#templates#documentation#structure#ADR#README#OpenSpec#design doc
One-click install
npx skills add https://github.com/ricardoroche/ricardos-claude-code --skill spec-templates
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-templates
Source: https://github.com/ricardoroche/ricardos-claude-code/tree/main/.claude/skills/spec-templates
Command: npx skills add https://github.com/ricardoroche/ricardos-claude-code --skill spec-templates

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides ready-to-use Markdown templates for various technical documents, eliminating the overhead of starting from scratch and ensuring consistent structure across projects. It helps teams quickly draft proposals, design documents, ADRs, READMEs, and changelogs, saving time and improving documentation quality.

Core Features & Use Cases

  • OpenSpec Proposal Outline: Provides a structured template for new feature proposals, including Executive Summary, Goals, Approach, and Risks.
  • Tasks Checklist Outline: Offers a template for implementation tasks, ensuring clear overview and subtask checklists.
  • Spec Delta Outline: Guides on structuring specification changes with ADDED|MODIFIED|REMOVED Requirements and Scenario blocks.
  • ADR & README Outlines: Includes templates for Architectural Decision Records and standard README sections for project documentation.
  • Use Case: A new project is starting, and the team needs to quickly set up a README, an ADR for a key architectural decision, and a proposal for the first major feature. This skill provides all the necessary templates, allowing the team to focus on content rather than structure.

Quick Start

Generate a Markdown template for a new Architectural Decision Record (ADR).

Frequently Asked Questions about spec-templates

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure a README with consistent sections and metadata?▼

README templates provide standardized Markdown outlines with predefined sections, YAML front matter for metadata, and formatting scaffolds. Use the README template to establish consistent structure across projects, ensuring key sections like overview, installation, and usage are included from the start.

What's the best way to document an architectural decision?▼

Architectural Decision Records (ADRs) templates guide you through status, context, decision, and consequences using a proven format. ADR templates ensure decisions are recorded consistently with all necessary context, making them searchable and maintainable across your codebase.

How do I create a changelog that tracks specification changes?▼

Changelog templates structure updates using ADDED, MODIFIED, and REMOVED sections with dates, authors, and version markers in Markdown. This standardized format makes it easy to communicate changes to stakeholders and maintain a clear history of your product evolution.

Can I use these templates for design documents and feature proposals?▼

Yes. OpenSpec proposal and design document templates include sections for Executive Summary, Goals, Approach, and Risks. These templates accelerate proposal drafting by providing a consistent structure that communicates intent and rationale clearly to reviewers.

What metadata do these Markdown templates support?▼

Templates include YAML front matter blocks for dates, authors, IDs, and status fields compatible with standard Markdown processors. This metadata enables filtering, version control, and automated workflows across your documentation ecosystem.

Do these templates work for implementation task checklists?▼

Yes. Task checklist templates provide outlines with parent tasks and subtask checklists in Markdown format. Use them to structure implementation work clearly, ensuring all dependencies and completion criteria are visible to the team.

Related Skills

Explore More Product & Management Skills→
alexsandrocruzalexsandrocruz

requirements-engineering

Convert stakeholder needs into structured, testable specifications with templates.

Community
Basic
microsoftmicrosoft
2.9k

wiki-vitepress

Package wiki Markdown into a VitePress static site with dark theme and Mermaid diagrams.

Official
Advanced
daymadedaymade
1.3k

pdf-creator

Convert Markdown to A4 PDFs with Chinese typography via WeasyPrint.

Community
Advanced
ricardorochericardoroche
2

spec-templates

Generate Markdown templates for proposals, design docs, ADRs, READMEs, and changelogs.

Community
Basic