Claude-skill-registry dialogue-structured-elicit

Gather structured information from the user through framework-aware questioning. Use when you need to elicit process context, requirements, constraints, or decisions. Triggers on "gather requirements", "elicit context", "structured questions", "need to understand".

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/dialogue-structured-elicit" ~/.claude/skills/majiayu000-claude-skill-registry-dialogue-structured-elicit && rm -rf "$T"
manifest: skills/data/dialogue-structured-elicit/SKILL.md
source content

Dialogue: Structured Elicit

Gather structured information through framework-aware questioning.

When to Use

Use this skill when you need to:

  • Gather process context before designing capability flows
  • Elicit requirements or constraints from the user
  • Clarify ambiguous information
  • Get decisions on alternatives you've identified

Elicitation Patterns

Process Context Elicitation

When gathering context for process design, elicit information across six areas. Four are mandatory; two are contextual.

Mandatory Questions (must elicit before proceeding)

AreaPurposeExample Question
PhaseDetermine SDLC phase"Which phase does this process belong to?"
PurposeUnderstand process goal"What should this process accomplish?"
InputsIdentify input documents/data"What information flows into this process?"
OutputsIdentify deliverables"What artifacts does this process produce?"

Contextual Questions (elicit when relevant)

AreaPurposeWhen to Ask
ActorsUnderstand who's involvedWhen unclear who participates; multi-team processes
ConstraintsSurface limitationsWhen regulatory, security, or technical constraints likely

Minimum Coverage Requirement

Do not proceed to decomposition until all four mandatory areas have answers.

If the user cannot answer a mandatory question:

  1. Note the gap as an observation
  2. Propose a reasonable default with rationale
  3. Get explicit confirmation before proceeding

Example: "I don't have information about inputs yet. Based on similar Phase 3 processes, I'd expect requirements documents and stakeholder notes. Does that seem right?"

Coverage Checklist

Before proceeding from elicitation, verify:

[ ] Phase identified
[ ] Purpose stated
[ ] Inputs defined (or default confirmed)
[ ] Outputs defined (or default confirmed)
[ ] Elicited context logged as observation

Information Composition Elicitation

To estimate formal/tacit/emergent composition:

QuestionIndicates
"Is there documented procedure for this?"High formal if yes
"Does this require expertise that's hard to document?"High tacit if yes
"Does new understanding emerge during execution?"High emergent if yes
"Could someone follow written instructions to do this?"Low tacit if yes

Pattern Selection Elicitation

When AI involvement is unclear:

QuestionHelps Determine
"Should a human always make this decision?"Human-Only vs other
"Could AI do this entirely without human review?"AI-Only suitability
"Is human judgement essential, or just review?"Partnership vs AI-Led

Using AskUserQuestion

Structure questions using the AskUserQuestion tool:

Use AskUserQuestion with:
- question: Clear, specific question
- header: Short label (max 12 chars)
- options: 2-4 distinct choices with descriptions
- multiSelect: true if multiple answers valid

Example: Phase Elicitation

question: "Which SDLC phase does this process belong to?"
header: "Phase"
options:
  - label: "Initiation (Phase 1)"
    description: "Project setup, feasibility, initial stakeholder engagement"
  - label: "Planning (Phase 2)"
    description: "Resource allocation, timeline, risk assessment"
  - label: "Requirements (Phase 3)"
    description: "Gathering and documenting what the system should do"
  - label: "Design (Phase 4)"
    description: "Architectural decisions, component design"

Example: Collaboration Pattern

question: "How should humans and AI collaborate on this step?"
header: "Pattern"
options:
  - label: "Human-Only"
    description: "Human does all work; AI not involved"
  - label: "Human-Led"
    description: "Human drives; AI assists and supports"
  - label: "Partnership"
    description: "Both essential; continuous collaboration"
  - label: "AI-Led"
    description: "AI drives; human reviews and approves"

Recording Elicitation Results

After eliciting information, use the dialogue-log-observation skill to record:

  • Key requirements noted
  • Constraints identified
  • User preferences stated

This preserves the elicited context for future reference.

Escalation

If the user cannot answer or indicates uncertainty:

  • Note the uncertainty as an observation
  • Propose reasonable defaults with rationale
  • Ask if defaults are acceptable

Phase 1 (Initiation) Specific Elicitation

Phase 1 has 75% tacit information composition. Standard elicitation patterns need adaptation.

Key Differences from Later Phases

AspectLater PhasesPhase 1
Information sourceDocuments, code, systemsStakeholder minds
Capture urgencyCan revisit documentsMust capture now or lose
AI roleCan lead elicitationFacilitates human articulation
ValidationCheck against formal specsProbe for unstated assumptions

Phase 1 Elicitation Questions

Opportunity/Problem Framing

QuestionWhy Important
"What triggered this initiative?"Captures origin story before it's forgotten
"What problem are you solving?"Distinguishes problem from solution
"Why now? What changed?"Surfaces temporal context
"What would happen if we did nothing?"Tests problem significance
"What other ways could this problem be framed?"Explores alternatives

Stakeholder Mapping

QuestionWhy Important
"Who requested this?"Identifies primary stakeholder
"Who must approve?"Identifies decision authority
"Who will be affected but isn't at the table?"Surfaces hidden stakeholders
"Who might resist? Why?"Surfaces political dynamics
"Whose expertise is essential?"Identifies knowledge holders

Rationale Capture (Critical)

These questions preserve tacit knowledge:

QuestionCaptures
"Why do you think that?"Reasoning behind positions
"What alternatives did you consider?"Negative knowledge
"What assumptions are we making?"Embedded constraints
"What would change your mind?"Decision criteria
"What have we tried before?"Historical context

Capture Window Awareness

Phase 1 insights are highly perishable. When a significant insight emerges:

  1. Log it immediately using dialogue-log-observation
  2. Confirm you captured it correctly with the human
  3. Note if there's more context you should probe for

Do not wait until the end of a conversation to capture Phase 1 observations.

Example: Phase 1 AskUserQuestion

question: "What problem is this initiative trying to solve?"
header: "Problem"
options:
  - label: "Clear and documented"
    description: "Problem statement exists; I can point you to it"
  - label: "Clear but undocumented"
    description: "We know the problem but haven't written it down"
  - label: "Still being defined"
    description: "We're not sure yet; exploring options"
  - label: "Multiple competing framings"
    description: "Different stakeholders see it differently"

If "Still being defined" or "Multiple competing framings", switch to Facilitator mode:

  • Help structure the exploration
  • Surface different perspectives
  • Document alternative framings as they emerge
  • Avoid premature convergence

Phase 1 Process Suggestions

When Phase 1 work is substantial, consider offering structured processes:

User NeedSuggest ProcessDefault Mode
"I have an idea/opportunity"PROC-1.1 Opportunity IdentificationQUICK
"Need to align stakeholders"PROC-1.2 Stakeholder AlignmentQUICK
"Problem isn't clear"PROC-1.3 Problem FramingQUICK
"Need to justify investment"PROC-1.4 Business CaseQUICK

Offer these lightly: "Would you like to work through this systematically? I can guide you through a structured process that typically takes about 15 minutes."

If complexity emerges during elicitation, suggest upgrading to FULL mode.


Part of the Dialogue Framework