role-clarify

Generate role-specific clarifying questions from problem.md and role prompts.

3|Updated Feb 20, 2026
One-click install
npx skills add https://github.com/slior/dialectic-agentic --skill role-clarify
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: role-clarify
Source: https://github.com/slior/dialectic-agentic/tree/main/.cursor/skills/role-clarify
Command: npx skills add https://github.com/slior/dialectic-agentic --skill role-clarify

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generates role-specific clarifying questions from a designated role to align on problem intent before a debate.

Core Features & Use Cases

  • Generates role-aware clarifying questions tailored to each agent's role and the problem statement.
  • Reads workspace problem, role prompts, and optional context to avoid duplicate questions and guide initial clarifications.
  • Use Case: Before the design debate begins, trigger role-clarify for each agent to surface information gaps and assumptions.

Quick Start

Run the role-clarify subagent for each agent to generate clarifying questions from their role before starting the debate.

Frequently Asked Questions about role-clarify

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

FAQPage Schema
How do I generate role-specific clarifying questions before a design debate?

Generate role-specific clarifying questions by running the role-clarify subagent for each agent. It reads the workspace problem and role prompts to produce tailored questions that surface information gaps before the debate begins.

What is the best way to align on problem intent and avoid duplicate questions across agents?

To align on problem intent and avoid duplicates, the skill reads optional context and prior Q&As alongside the problem statement. It then generates a deterministic JSON payload ensuring no repeated clarifying questions across different roles.

How does role-aware question generation work for requirements gathering?

Role-aware question generation works by reading designated role prompts and the problem.md file. It tailors clarifying questions to each specific agent's role to guide initial requirements gathering and eliminate assumptions.

Do I need any external dependencies to produce deterministic JSON payloads for design debates?

No external dependencies are required to produce deterministic JSON payloads. The skill operates independently, reading workspace files and outputting the clarifications directly to the designated debate workspace directory.

Can I use this skill to surface information gaps for multiple agents simultaneously?

Yes, you can surface information gaps for multiple agents by triggering the role-clarify subagent individually for each agent. Each run produces a separate pending JSON payload with role-specific questions for user answers.

What limitations exist when tailoring clarifying questions from a designated role?

A limitation is that the skill only generates questions based on the provided problem.md and role prompts. It does not perform unintended side effects or execute debate logic, strictly outputting pending questions for user review.