conversational-shaping

Guide interviewer-driven shaping sessions into structured artifacts with teach-back validation.

Updated Mar 8, 2026
One-click install
npx skills add https://github.com/ReadyStateChange/agents --skill conversational-shaping
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: conversational-shaping
Source: https://github.com/ReadyStateChange/agents/tree/main/skills/conversational-shaping
Command: npx skills add https://github.com/ReadyStateChange/agents --skill conversational-shaping

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables interviewer-driven shaping sessions that capture human input into a structured, editable artifact, updating content incrementally and recording revisions until teach-back validation passes.

Core Features & Use Cases

  • One-question-at-a-time interview flow that keeps the human in the driver's seat and prevents authoring substantive content.
  • Automatic in-place revision logging, with explicit overwrite of previous cells or sections when human answers change.
  • Teach-back gate that requires the human to articulate understanding before completion, ensuring accuracy and alignment with goals.
  • Artifact choreography for boundaries, requirements, and shapes, ready for export to downstream planning and documentation.

Quick Start

Begin an interviewer-only shaping session by asking the first focused question and recording the human answer in the shaping artifact.

Frequently Asked Questions about conversational-shaping

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

FAQPage Schema
How do I capture interview requirements into a structured artifact?

To capture interview requirements into a structured artifact, use a guided one-question-at-a-time session that records human answers and logs revisions until teach-back validation passes.

What is teach-back validation in requirements gathering?

Teach-back validation in requirements gathering is a gating mechanism where the human must articulate their understanding of captured answers to ensure accuracy before completing the artifact.

How do I conduct a one-question-at-a-time shaping session?

To conduct a one-question-at-a-time shaping session, begin by asking a focused question, recording the human answer in-place, and updating the artifact incrementally as answers change.

Can I use conversational shaping to document project risk boundaries?

Yes, you can use conversational shaping to document project risk boundaries, requirements, and shape decisions by capturing human input into an editable artifact through guided questions.

Does the interviewer generate content during the shaping session?

No, the interviewer does not generate content during the shaping session; the flow enforces one-question-at-a-time interaction to prevent authoring substantive content and keeps the human driving.

What happens when an answer changes during a guided interview?

When an answer changes during a guided interview, the system automatically overwrites previous cells or sections in the artifact and logs the revision in-place to maintain an accurate record.