decide

Orchestrate peer review and synthesize decisions into markdown documents.

Updated May 6, 2026
One-click install
npx skills add https://github.com/tkstang/skills --skill decide-tkstang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: decide
Source: https://github.com/tkstang/skills/tree/main/plugins/consensus/skills/decide
Command: npx skills add https://github.com/tkstang/skills --skill decide-tkstang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires node, consensus, and includes scripts (resource) and references (resource) components.

What problem does it solve?

The Skill simplifies the decision-making process by providing a structured way to evaluate multiple options, facilitate peer review, and produce a markdown decision document that includes dissent and resolutions.

Core Features & Use Cases

  • Option Review: Facilitates the review of documented options among peers.
  • Markdown Output: Generates a markdown decision document that includes recommendations, reasoning, alternatives, and dissent.
  • Use Case: When a user has a set of options and wants to document the decision-making process, this skill can be used to generate a comprehensive decision document that captures the consensus and dissent among the involved parties.

Quick Start

Use the decide skill to review and document a decision between two options using the 'options.md' file and generate a decision document with 'node ./scripts/consensus-decide.mjs --options path/to/options.md'.

Frequently Asked Questions about decide

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

FAQPage Schema
How do I generate a markdown decision document with peer review and dissent tracking?

To generate a markdown decision document, you can use a consensus-driven workflow that orchestrates documented option reviews across peers, resolves dissent, and synthesizes the final reasoning into a structured markdown file.

What is the best way to document consensus and dissent when evaluating multiple options?

The best way to document consensus and dissent is to automate peer review of documented options, capturing the agreements, alternative reasoning, and minority viewpoints directly within a comprehensive markdown decision document.

Do I need Node.js and the consensus CLI to automate decision-making documentation?

Yes, automating the decision-making process with this specific workflow requires Node.js 22+ and the consensus CLI installed, as they handle the underlying peer orchestration and markdown synthesis tasks.

Can I use markdown files as input for peer review and decision synthesis?

Yes, you can provide an 'options.md' file as input. The system reads the documented options from the markdown file, runs the peer review process, and outputs the final synthesized decision document.

What are the limitations of using automated peer review for decision-making?

Limitations include the dependency on external CLI tools and the requirement for structured markdown input. If peers cannot review the options asynchronously or the consensus CLI fails, the dissent resolution and markdown synthesis will not complete.