name: skill
description: 'TODO: Brief description of what the Skill does and when to use it'

Answer Collector Skill

Purpose: Incrementally collect and validate product assessment responses in structured JSON format.

When to Use

• Evaluating new product ideas with rigorous criteria
• Conducting go/no-go assessments before committing resources
• Building a decision audit trail for product decisions
• Gathering structured input from teams or stakeholders
• Progressive refinement of product hypotheses

How It Works

1. Reading Questions

Questions are organized in 4 sections (questions.md):
- WHY (4 Q's): Problem, strategy, resources, timing
- WHO (4 Q's): User, access, economics, scale
- WHAT (5 Q's): Outcome, monetization, success metrics, fit, risk
- GO/NO-GO (4 criteria): Checklist for final decision

Each question is numbered 1-17.

2. Writing JSON Incrementally

Start with a template and add answers one at a time:

{
  "metadata": {
    "product_name": "Your Product Name",
    "created_at": "2025-11-03T00:00:00Z",
    "status": "in_progress"
  },
  "answers": {
    "why_section": {
      "q1_problem_evidence": "Answer here..."
    }
  }
}

Build incrementally:
- Add one answer per interaction
- Preserve all previous answers
- Update last_updated timestamp
- Track completion_percentage in metadata

3. Validation Logic

Auto-calculate:
- answered_questions: Count non-empty answers
- completion_percentage: (answered_questions / 17) × 100
- go_no_go_result: "go" if all 4 checklist items true, else "no_go" or "pending"

Validation rules:
- All text answers must be non-empty and substantive
- Checklist items (q14-q17) must be boolean (true/false)
- Metadata fields (product_name) required to start
- All timestamps in ISO 8601 format

Quick Reference

Usage Pattern

1. Initialize: Create JSON with metadata and product_name
2. Collect: Answer one question, validate, save
3. Review: Check completion_percentage and go_no_go_result
4. Decide: When all answers complete, review go_no_go_result

File Structure

~/.claude/skills/answer-collector/
├── SKILL.md           # This file
├── questions.md       # The 17 assessment questions
├── schema.json        # JSON validation schema
└── assessments/       # (optional) Stored assessment JSONs
    └── product-name.json