writing-persuasive

Generate persuasive technical documents with evidence-driven arguments and migration paths.

1|Updated May 7, 2022
One-click install
npx skills add https://github.com/brandonburrus/dotfiles --skill writing-persuasive
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-persuasive
Source: https://github.com/brandonburrus/dotfiles/tree/main/.config/opencode/skills/writing-persuasive
Command: npx skills add https://github.com/brandonburrus/dotfiles --skill writing-persuasive

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you write persuasive technical documents that convince stakeholders to adopt your recommended solutions by presenting a clear, evidence-driven case.

Core Features & Use Cases

  • Structured Argumentation: Guides you through framing the investigation, establishing pain points, presenting solutions, demonstrating feasibility, addressing risks, and defining migration paths.
  • Professional Tone: Adopts a confident, evidence-driven, and empathetic voice suitable for mixed technical and business audiences.
  • Use Case: Draft a proposal for adopting a new CI/CD tool, clearly outlining the current development bottlenecks, the benefits of the new tool with concrete examples, and a phased rollout plan.

Quick Start

Use the writing-persuasive skill to draft a technical proposal for adopting a new database system.

Frequently Asked Questions about writing-persuasive

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

FAQPage Schema
How do I write a technical proposal that convinces stakeholders to adopt a new tool?

A persuasive technical proposal builds the business case before the technical one, quantifying pain points to establish urgency. It then demonstrates feasibility with code examples and outlines a clear migration path to systematically address stakeholder objections.

What is the best way to structure an RFC to address potential business objections?

The best way to structure an RFC is through structured argumentation that frames the investigation, establishes pain points, presents solutions, demonstrates feasibility, addresses risks, and defines migration paths to systematically resolve objections.

How do I create a migration plan that demonstrates technical feasibility with code?

Create a migration plan by outlining a clear, phased rollout path and demonstrating technical feasibility with concrete code examples. This evidence-driven method quantifies pain and proves the proposed solution works in practice.

Can I use this approach to write a business case for a mixed technical and non-technical audience?

Yes, you can write a business case for a mixed audience using a confident, evidence-driven, and empathetic professional tone. This voice makes technical proposals accessible while maintaining authority for stakeholder communication.

When do I need to quantify pain points in technical writing?

You need to quantify pain points in technical writing before presenting technical solutions. Establishing this evidence-driven business case early ensures stakeholders understand the urgency and scale of the problem before reviewing proposed solutions.