Can I choose different levels of detail for my proposal?

Yes, you can specify 'minimal', 'standard', or 'detailed' as an argument to choose the template that best fits the complexity of your change.

Where does the skill save the generated documents?

All documents are automatically saved to the docs/rfc/ directory with a standardized naming convention like RFC-0001-title.md.

How does it prevent hallucinated information in RFCs?

Before writing, the skill uses an 'Explore' agent to verify the current state of the codebase, ensuring all referenced files and dependencies actually exist.

Does it support team collaboration?

Yes, it integrates with Git to pull author information and includes a status lifecycle (Draft, Review, Accepted) for peer review workflows.

How does the skill determine the RFC number?

The skill scans the docs/rfc/ directory, identifies the highest existing RFC-XXXX number, and increments it by one to ensure a continuous sequence.

RFC Documentation Generator

Name: RFC Documentation Generator
Author: mgiovani

bymgiovani

•

Learning & Documentation

Automates the creation of numbered Request For Comments (RFC) documents to propose and discuss technical changes within a codebase.

The docs-rfc skill streamlines the process of proposing architectural changes and new features by generating standardized, numbered RFC documents directly within your project's repository. It leverages AI to explore your existing codebase first, ensuring that proposals are grounded in actual system state and verified patterns rather than hallucinations. With support for minimal, standard, and detailed templates, it provides a structured framework for the entire proposal lifecycle—from initial draft and peer review to final implementation and documentation.

Key Features

01Deep codebase exploration to ensure proposals reference real APIs and files

02Standardized lifecycle tracking from Draft to Implemented status

03Automated RFC numbering and kebab-case file naming

04Three distinct template variants for different proposal scopes

05Automatic author identification using Git configuration

062 GitHub stars

Use Cases

01Documenting new API designs or breaking changes for team review

02Proposing major architectural shifts such as migrating to microservices

03Establishing a formal decision-making record for significant feature additions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mgiovani/cc-arsenal docs-rfc

For use in Claude.ai and ChatGPT

Download Skill