interactive-checklist

name	interactive-checklist
description	Create interactive, guided checklists for multi-step workflows, validation processes, onboarding sequences, and complex procedures with step-by-step tracking and decision trees. Use when documenting complex workflows, creating validation procedures, or building step-by-step guides requiring user interaction and decision tracking.
acceptance	[{"checklist_created":"Interactive checklist document generated"},{"steps_defined":"All workflow steps documented with clear instructions"},{"validation_criteria":"Each step includes validation/completion criteria"},{"decision_points":"Conditional branches and decision trees implemented"},{"tracking_mechanism":"Progress tracking system included"}]
inputs	{"workflow_name":{"type":"string","required":true,"description":"Name of workflow or process"},"workflow_type":{"type":"string","required":false,"description":"linear | branching | cyclic | validation (default: linear)","default":"linear"},"steps_input":{"type":"string","required":false,"description":"Comma-separated list of steps or path to step definition file"},"output_format":{"type":"string","required":false,"description":"markdown | interactive-md | json (default: markdown)","default":"markdown"},"include_tracking":{"type":"boolean","required":false,"description":"Include progress tracking checkboxes (default: true)","default":true}}
outputs	{"checklist_created":{"type":"boolean","description":"Whether checklist was successfully created"},"checklist_location":{"type":"string","description":"Path to created checklist file"},"step_count":{"type":"number","description":"Number of steps in checklist"},"decision_points":{"type":"number","description":"Number of decision/branch points in workflow"}}
telemetry	{"emit":"skill.interactive-checklist.completed","track":["workflow_name","workflow_type","step_count","decision_points","output_format","duration_ms","checklist_location"]}

Interactive Checklist Skill

Purpose

Create guided, interactive checklists for complex workflows, validation processes, onboarding sequences, and multi-step procedures. Checklists provide step-by-step instructions, validation criteria, decision trees, and progress tracking.

Core Principles:

• Step-by-step clarity (each step is clear and actionable)
• Progressive disclosure (details revealed as needed)
• Validation gates (ensure quality at each step)
• Decision support (guide users through choices)
• Progress visibility (track completion status)

---

Prerequisites

• Workflow/process defined (either high-level description or detailed steps)
• Understanding of workflow branching (if any)
• Validation criteria identified
• workspace/ directory exists for checklist storage

---

Workflow

Step 1: Workflow Analysis

Action: Understand workflow structure, identify steps, decision points, and validation requirements.

Key Activities:

1. Identify Workflow Type

   Linear Workflow:

   Step 1 → Step 2 → Step 3 → Step 4 → Complete
   
   Example: Software deployment
   1. Run tests
   2. Build application
   3. Deploy to staging
   4. Verify staging
   5. Deploy to production
   

   Branching Workflow:

   Step 1 → Step 2 → Decision
                      ├─ Path A → Step 3A → Step 4
                      └─ Path B → Step 3B → Step 4
   
   Example: Code review process
   1. Review code
   2. Decision: Approve or Request Changes?
      A. If approved → Merge PR → Complete
      B. If changes needed → Developer fixes → Re-review
   

   Cyclic Workflow:

   Step 1 → Step 2 → Validation
                      ├─ Pass → Step 3 → Complete
                      └─ Fail → Return to Step 1
   
   Example: Quality assurance
   1. Implement feature
   2. Run tests
   3. If tests pass → Deploy
   4. If tests fail → Fix bugs → Return to step 2
   

   Validation Checklist:

   Independent items (order doesn't matter):
   - [ ] Item 1 validated
   - [ ] Item 2 validated
   - [ ] Item 3 validated
   
   Example: Pre-launch checklist
   - [ ] Security audit complete
   - [ ] Performance tests passed
   - [ ] Documentation updated
   - [ ] Backup verified
   

2. Break Down into Steps

   For each step, define:
   - Step number/ID
   - Step name (brief, actionable)
   - Description (what to do)
   - Validation criteria (how to know it's done)
   - Prerequisites (what must be done first)
   - Estimated time (how long it takes)
   - Resources needed (tools, access, knowledge)
   - Common issues (what might go wrong)