skills.rest
paultyng
paultyngCOMMUNITY
Explore all skills by this author →
GitHub

create-decision-document

Generate standardized decision records with structured option analysis in Notion.

9|Updated Mar 22, 2026
Search Tags:#documentation#research#notion#recommendation#option-analysis#decision-document#product-decisions
One-click install
npx skills add https://github.com/paultyng/skill-issue --skill create-decision-document
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-decision-document
Source: https://github.com/paultyng/skill-issue/tree/main/skills/create-decision-document
Command: npx skills add https://github.com/paultyng/skill-issue --skill create-decision-document

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Teams often struggle with inconsistent decision documentation, making it hard to track why choices were made, align stakeholders, and avoid revisiting old debates.

Core Features & Use Cases

  • Structured Decision Templates: Automatically formats decision documents with clear sections for problem statement, evaluated options, pros/cons, and final recommendations.
  • Integrated Research Support: Pulls context from your codebase via Sourcegraph, external web sources, and existing internal Notion docs to inform option analysis.
  • Notion Native: Creates or updates decision documents directly in your team's Notion workspace, no manual copy-pasting required. Use case example: If your team is evaluating which cloud provider to migrate to, this skill generates a standardized decision doc in Notion with all options, tradeoffs, and a data-backed recommendation, so everyone has a single source of truth.

Quick Start

Ask the AI to create a Notion decision document for evaluating whether to adopt a monorepo or polyrepo structure for your engineering team, including all options, pros, cons, and a recommendation.

Frequently Asked Questions about create-decision-document

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

FAQPage Schema
How do I create a structured decision document in Notion for evaluating product options?▼

To create a structured decision document in Notion, this skill automatically generates standardized records containing problem statements, evaluated options, tradeoffs, and formal recommendations for team alignment.

What is the best way to document technical tradeoffs and recommendations for cross-functional teams?▼

Documenting technical tradeoffs for cross-functional teams requires standardized decision records with clear sections for pros, cons, and data-backed recommendations to prevent revisiting old debates.

Can I use existing internal documentation and codebase research to inform my option analysis?▼

Yes, option analysis can integrate research from internal codebases via Sourcegraph, external web sources, and existing internal Notion docs to provide data-backed context for your decision document.

Does this approach to decision documentation work for both technical and operational evaluations?▼

Yes, this decision documentation approach applies to technical, product, and operational evaluation scenarios where teams need to compare alternatives and record formal recommendations in a centralized workspace.

How do I update an existing decision document in Notion without manual copy-pasting?▼

Updating an existing decision document in Notion happens natively by integrating directly with your team's workspace to create or update standardized decision records without manual copy-pasting required.

Related Skills

Explore More Product & Management Skills→
dhar174dhar174
1

notion-meeting-intelligence

Gather Notion pages and Codex insights to generate meeting pre-reads and agendas.

Community
Advanced
ejoongseokejoongseok
8

rfc

Generate decision request RFCs with options, trade-offs, and recommendations.

Community
Advanced
dallaydallay

notion-meeting-intelligence

Aggregate Notion workspace context into meeting agendas and internal pre-reads.

Official
Advanced
Sacred-GSacred-G
2

notion-knowledge-capture

Convert conversations into structured Notion pages with linked databases.

Community
Advanced