{"id":"133fca3e-faa6-4058-98b0-78acb395fe3d","shortId":"jhxLJC","kind":"skill","title":"create-decision-document","tagline":"Create or update a Notion decision document with a structured options/pros/cons/recommendation template. Use when the user asks to create a decision doc, design doc, evaluation doc, or comparison in Notion.","description":"# Create Decision Document\n\nCreate or update a decision document in Notion using the Notion MCP.\n\n## 1. Gather Context\n\nDetermine from the user:\n- **Title**: what decision is being made\n- **Location**: which Notion page or database to create under (ask if unclear)\n- **Options**: the alternatives being evaluated (may emerge during research)\n\n## 2. Research (if needed)\n\nIf the user asks for research before writing:\n- Use **Sourcegraph** for organization's codebase patterns and precedent\n- Use **web search** for external APIs, standards, and vendor comparisons\n- Use **Notion** for existing internal docs and prior decisions\n- Be terse in research summaries\n\n## 3. Create the Document\n\nUse the Notion MCP to create a page with this structure:\n\n```markdown\n# <Decision Title>\n\n## Problem Statement\n<1-2 sentences describing what needs to be decided and why>\n\n## Options\n\n### Option A: <Name>\n**Pros**\n- <terse bullet>\n- <terse bullet>\n\n**Cons**\n- <terse bullet>\n- <terse bullet>\n\n### Option B: <Name>\n**Pros**\n- <terse bullet>\n\n**Cons**\n- <terse bullet>\n\n## Recommendation\n<Which option and why, 1-2 sentences>\n```\n\nFormatting rules:\n- Be terse throughout. No filler.\n- Do **not** prefix Pros/Cons items with \"Good:\" or \"Bad:\".\n- Bullet points, not prose paragraphs.\n- If there are criteria or requirements, use a comparison table rather than repeating them per option.\n\n## 4. Follow-up\n\nCommon follow-up actions (do only if asked):\n- Link a PR to the decision doc\n- Update the recommendation after discussion\n- Add a \"Decision\" or \"Status\" field marking the choice as final","tags":["create","decision","document","skill","issue","paultyng","agent-skills","ai-tools","claude-code","cursor","dotfiles"],"capabilities":["skill","source-paultyng","skill-create-decision-document","topic-agent-skills","topic-ai-tools","topic-claude-code","topic-cursor","topic-dotfiles"],"categories":["skill-issue"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/paultyng/skill-issue/create-decision-document","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add paultyng/skill-issue","source_repo":"https://github.com/paultyng/skill-issue","install_from":"skills.sh"}},"qualityScore":"0.454","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 8 github stars · SKILL.md body (1,576 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:09:00.332Z","embedding":null,"createdAt":"2026-05-18T13:21:25.113Z","updatedAt":"2026-05-18T19:09:00.332Z","lastSeenAt":"2026-05-18T19:09:00.332Z","tsv":"'-2':148,173 '1':50,147,172 '2':84 '3':129 '4':212 'action':220 'add':237 'altern':77 'api':110 'ask':21,72,91,224 'b':164 'bad':190 'bullet':191 'choic':245 'codebas':101 'common':216 'comparison':32,114,204 'con':162,166 'context':52 'creat':2,5,23,35,38,70,130,138 'create-decision-docu':1 'criteria':199 'databas':68 'decid':155 'decis':3,10,25,36,42,59,123,230,239 'describ':150 'design':27 'determin':53 'discuss':236 'doc':26,28,30,120,231 'document':4,11,37,43,132 'emerg':81 'evalu':29,79 'exist':118 'extern':109 'field':242 'filler':181 'final':247 'follow':214,218 'follow-up':213,217 'format':175 'gather':51 'good':188 'intern':119 'item':186 'link':225 'locat':63 'made':62 'mark':243 'markdown':144 'may':80 'mcp':49,136 'need':87,152 'notion':9,34,45,48,65,116,135 'option':75,158,159,163,169,211 'options/pros/cons/recommendation':15 'organ':99 'page':66,140 'paragraph':195 'pattern':102 'per':210 'point':192 'pr':227 'preced':104 'prefix':184 'prior':122 'problem':145 'pros':161,165 'pros/cons':185 'prose':194 'rather':206 'recommend':167,234 'repeat':208 'requir':201 'research':83,85,93,127 'rule':176 'search':107 'sentenc':149,174 'skill' 'skill-create-decision-document' 'source-paultyng' 'sourcegraph':97 'standard':111 'statement':146 'status':241 'structur':14,143 'summari':128 'tabl':205 'templat':16 'ters':125,178 'throughout':179 'titl':57 'topic-agent-skills' 'topic-ai-tools' 'topic-claude-code' 'topic-cursor' 'topic-dotfiles' 'unclear':74 'updat':7,40,232 'use':17,46,96,105,115,133,202 'user':20,56,90 'vendor':113 'web':106 'write':95","prices":[{"id":"cefd52e8-3fd8-4891-97a6-d9259f37e37b","listingId":"133fca3e-faa6-4058-98b0-78acb395fe3d","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"paultyng","category":"skill-issue","install_from":"skills.sh"},"createdAt":"2026-05-18T13:21:25.113Z"}],"sources":[{"listingId":"133fca3e-faa6-4058-98b0-78acb395fe3d","source":"github","sourceId":"paultyng/skill-issue/create-decision-document","sourceUrl":"https://github.com/paultyng/skill-issue/tree/main/skills/create-decision-document","isPrimary":false,"firstSeenAt":"2026-05-18T13:21:25.113Z","lastSeenAt":"2026-05-18T19:09:00.332Z"}],"details":{"listingId":"133fca3e-faa6-4058-98b0-78acb395fe3d","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"paultyng","slug":"create-decision-document","github":{"repo":"paultyng/skill-issue","stars":8,"topics":["agent-skills","ai-tools","claude-code","cursor","dotfiles"],"license":"mit","html_url":"https://github.com/paultyng/skill-issue","pushed_at":"2026-05-18T18:26:54Z","description":"Personal Claude Code / Cursor agent skills, rules, and config","skill_md_sha":"1c82412c6619446027c6560c32a29f5c95fff2ac","skill_md_path":"skills/create-decision-document/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/paultyng/skill-issue/tree/main/skills/create-decision-document"},"layout":"multi","source":"github","category":"skill-issue","frontmatter":{"name":"create-decision-document","description":"Create or update a Notion decision document with a structured options/pros/cons/recommendation template. Use when the user asks to create a decision doc, design doc, evaluation doc, or comparison in Notion."},"skills_sh_url":"https://skills.sh/paultyng/skill-issue/create-decision-document"},"updatedAt":"2026-05-18T19:09:00.332Z"}}