technical-rfc-request-for-comments-drafting
/technical-rfc-request-for-comments-drafting
Use this skill when draft Request for Comments (RFC) proposals to gather peer feedback on major technical changes.
- Author
- nextboxis ↗
- Repository
- library-skill-agents ↗
- Licence
- MIT
- Last repository change
- 28.10.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 28.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Use this skill when draft Request for Comments (RFC) proposals to gather peer feedback on major technical changes.
Original author description
Use this skill when draft Request for Comments (RFC) proposals to gather peer feedback on major technical changes.
How it works
- When to use
- Core principles
- Step-by-step workflow
- Specifics & examples
- Common mistakes & pitfalls
- Verification checklist
- Related skills
SKILL.md preview
--- name: technical-rfc-request-for-comments-drafting description: Use this skill when draft Request for Comments (RFC) proposals to gather peer feedback on major technical changes. --- # Technical RFC Request For Comments Drafting ## When to use Use this skill when draft Request for Comments (RFC) proposals to gather peer feedback on major technical changes. This applies across software engineering lifecycles, team code reviews, production debugging, prompt design, and architectural documentation. ## Core principles - **Clarity Over Cleverness**: Code, prompts, and technical documentation must prioritize clarity, predictability, and long-term maintainability over obscure shortcuts. - **Evidence-Based Engineering**: Every decision, bug resolution, and architectural choice must be supported by empirical data, minimal reproductions, or benchmark traces. - **Cognitive Load Minimization**: Design interfaces, APIs, and documents to minimize mental parsing overhead for future engineers and autonomous agents. - **Continuous Feedback Loops**: Incorporate automated verification, peer reviews, and post-task retrospectives to drive iterative improvement. ## Step-by-step workflow 1. **Define the objective and constraints**: State the exact technical outcome, acceptance criteria, and operational boundaries. 2. **Gather baseline telemetry and context**: Inspect relevant codebases, stack traces, system architecture diagrams, or log files. 3. **Execute structured analysis or implementation**: Apply domain-specific techniques (e.g., minimal reproduction, refactoring transforms, prompt templates). 4. **Validate against automated test assertions**: Run unit tests, linters, or schema validation parsers to verify behavioral correctness. 5. **Document rationale and trade-offs**: Record the 'why' behind choices, documenting rejected alternatives and operational considerations. 6. **Conduct retrospective review**: Share findings with stakeholders or record lessons learned in the team knowledge base. ## Specifics & examples - **Standard Engineering Artifact**: - Scope: Technical RFC Request For Comments Drafting - Core Deliverable: Actionable, verifiable engineering guidance aligned with Report & technical writing. - Verification Rule: Tested against production workflows and peer-reviewed standards. - **Primary Focus Area**: Report & technical writing principles designed to elevate engineering precision and team psychological safety. ## Common mistakes & pitfalls - Jumping directly into speculative fixes or complex rewrites before isolating the root cause. - Introducing premature abstractions that increase indirection and cognitive complexity. - Failing to document context and architectural trade-offs for subsequent maintainers. ## Verification checklist [ ] The technical deliverable or fix is validated with reproducible test assertions. [ ] Changes preserve backwards compatibility and maintain existing contract invariants. [ ] Documentation or commit logs clearly explain the rationale and trade-offs. ## Related skills - architecture-decision-records-adr-authoring - software-architecture-design-document-add - incident-postmortem-blameless-rca-authoring - software-readme-api-quickstart-documentation
Versions
The database has no other skills named technical-rfc-request-for-comments-drafting.
Database snapshot: 13.11.2026 · package version 1c577c41b61b (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100create-rfc
Create a Request for Comments document when the user asks to propose a significant technical change, write an RFC, start a design review, or get cross-team input on a technical decision - 90create-rfc
Create OpenShell RFC proposals in rfc/ from a design request. Use when the user asks to write, draft, start, create, or update an RFC, Request for Comments, architecture proposal, API proposal, process proposal, or cross-cutting design proposal that should follow the OpenShell… - 100create-rfc
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… - 95rfc
Use when writing RFC (Request for Comments) design documents to propose significant technical changes for team review and feedback. Covers RFC structure, motivation, detailed design, alternatives analysis, risk assessment, the RFC workflow, and when to use RFC vs ADR. USE FOR:… - 100review-rfc
Review an engineering RFC before it is shared or accepted. Checks its claims against code and documentation, its scope against the originating request, repository rules, internal consistency and template structure, then reports author decisions, fixes and side-channel questions.… - 100x-rfc
RFC (Request for Comments) document query tool providing access to Internet protocol standards. Use this skill whenever the user needs to look up, search, read, or learn about RFC documents. Covers: list RFCs (x rfc ls), view by number (x rfc 791), search (x rfc : http), and AI…