refine

Refine markdown drafts through structured deliberation between two AI peers.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill addresses the challenge of refining markdown drafts through a structured peer-deliberation process, ensuring a converged, high-quality artifact.

Core Features & Use Cases

  • Peer Deliberation: Facilitates structured deliberation between two AI peers to refine markdown drafts.
  • Structured Verdicts: Generates detailed verdicts with reasoning and suggested changes.
  • Final Artifact: Outputs a refined document with a readable audit trail.
  • Use Case: When working on a markdown document and seeking a second opinion or improvement suggestions, use this Skill to get insights from AI peers.

Quick Start

Use the refine skill to refine the draft 'meeting_notes.md' with the goal "streamline the meeting agenda and add bullet points where needed".

Frequently Asked Questions about refine

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

FAQPage Schema
How do I use AI peer review to refine a markdown draft?

You can refine a markdown draft through structured peer deliberation by providing the file and a refinement goal. The Skill coordinates two AI peers to generate detailed verdicts, suggested changes, and a final refined artifact with an audit trail.

What is the difference between alternating and parallel-synthesized iteration modes for document refinement?

Document refinement supports alternating, parallel-revision, and parallel-synthesized iteration modes. These modes dictate how the two AI peers interact during peer deliberation, ranging from turn-based exchanges to concurrent revisions synthesized into a final artifact.

Do I need Node.js and consensus CLI to run markdown peer deliberation?

Yes, you need Node.js 22+ and the consensus CLI to run markdown peer deliberation. These dependencies execute the structured deliberation scripts and generate the final refined document artifact.

Can I get structured feedback and an audit trail for collaborative markdown documents?

Yes, the peer deliberation process generates detailed verdicts with reasoning and suggested changes, outputting a refined markdown document alongside a readable audit trail for collaborative document refinement and structured feedback workflows.

What's the best way to streamline a meeting agenda in markdown using AI peers?

The best way to streamline a markdown meeting agenda is to pass the file to this Skill with a specific goal. Two AI peers will deliberate on the content, applying structured feedback to output a refined agenda with bullet points and an audit trail.