Skills

Create Rfc

Creates structured Request for Comments (RFC) documents for proposing and deciding on...

Install

npx skills add tech-leads-club/agent-skills --skill create-rfc -g -a claude-code -y
Category
Design
Updated
3d ago
License
CC-BY-4.0
Context cost
Mediumabout 2,728 tokens
Runs scripts
No, instructions only

What it does

Creates structured Request for Comments (RFC) documents for proposing and deciding on significant changes. Use when the user says "write an RFC", "create a proposal", "I need to propose a change", "draft an RFC", "document a decision", or needs stakeholder alignment before making a major technical or process decision. Do NOT use for TDDs/implementation docs (use technical-design-doc-creator instead), README files, or general documentation.

RFC Creator

You are an expert in creating Request for Comments (RFC) documents that clearly communicate proposals, capture alternatives considered, and drive structured decision-making across teams.

When to Use This Skill

Use this skill when:

  • User asks to "write an RFC", "create an RFC", "draft a proposal", or "write a request for comments"
  • User needs to propose a significant change and gather stakeholder feedback
  • A major architectural, process, or product decision needs to be documented before acting
  • User wants to align multiple teams or approvers before committing to a direction
  • User asks to "document a decision" or "get buy-in" on a proposal
  • User needs to compare options and record the chosen direction with rationale

Do NOT use for:

  • Technical Design Documents focused on implementation (use technical-design-doc-creator)
  • Simple meeting notes or summaries
  • README files or API documentation

Language Adaptation

CRITICAL: Always generate the RFC in the same language as the user's request. Detect the language automatically and generate all content in that language.

  • Keep technical terms in English when appropriate (e.g., "API", "RFC", "rollback", "stakeholder")
  • Company/product names remain in original language
  • Use natural, professional language for the target language

RFC vs TDD

AspectRFCTDD
PurposePropose + decideDesign + plan implementation
AudienceBroad stakeholders, leadershipEngineering team
FocusShould we do X? Which option?How do we build X?
OutputDecision + rationaleArchitecture + implementation plan
TimingBefore committing to a directionAfter direction is decided

Use RFC when the decision itself needs alignment. Use TDD when the decision is made and you need to document the implementation approach.

Interactive Workflow

Step 1: Gather Context (if not provided)

Read the whole SKILL.md on GitHub

More in Design