Agent skill

Survey Design

Design and analyze surveys for product validation and user research

Stars 514
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/a5c-ai/babysitter/tree/main/library/specializations/product-management/skills/survey-design

SKILL.md

Survey Design Skill

Overview

Specialized skill for designing and analyzing surveys for product validation. Enables product teams to gather structured feedback through well-designed surveys and interpret results with statistical rigor.

Capabilities

Survey Design

  • Design PMF surveys (Sean Ellis test)
  • Create NPS survey implementations
  • Build feature validation surveys
  • Generate survey question banks
  • Design onboarding feedback surveys
  • Create churn exit surveys

Question Engineering

  • Write unbiased survey questions
  • Design appropriate response scales
  • Create skip logic and branching
  • Optimize question order
  • Balance survey length vs completion

Analysis

  • Analyze survey response data
  • Calculate statistical confidence in results
  • Segment analysis by user attributes
  • Identify response patterns and themes
  • Generate actionable insights from data

Target Processes

This skill integrates with the following processes:

  • product-market-fit.js - PMF survey design and analysis
  • beta-program.js - Beta participant surveys
  • customer-advisory-board.js - CAB feedback collection
  • jtbd-analysis.js - Jobs-based survey questions

Input Schema

json
{
  "type": "object",
  "properties": {
    "surveyType": {
      "type": "string",
      "enum": ["pmf", "nps", "csat", "feature-validation", "exit", "onboarding", "custom"],
      "description": "Type of survey to design"
    },
    "objective": {
      "type": "string",
      "description": "Primary objective of the survey"
    },
    "targetAudience": {
      "type": "string",
      "description": "Target survey respondents"
    },
    "hypotheses": {
      "type": "array",
      "items": { "type": "string" },
      "description": "Hypotheses to validate through survey"
    },
    "maxQuestions": {
      "type": "number",
      "default": 10,
      "description": "Maximum number of questions"
    },
    "responseData": {
      "type": "array",
      "description": "Survey response data for analysis (if analyzing existing survey)"
    }
  },
  "required": ["surveyType", "objective"]
}

Output Schema

json
{
  "type": "object",
  "properties": {
    "survey": {
      "type": "object",
      "properties": {
        "title": { "type": "string" },
        "introduction": { "type": "string" },
        "questions": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": { "type": "string" },
              "type": { "type": "string" },
              "text": { "type": "string" },
              "options": { "type": "array", "items": { "type": "string" } },
              "required": { "type": "boolean" },
              "logic": { "type": "object" }
            }
          }
        },
        "estimatedTime": { "type": "string" }
      }
    },
    "analysisFramework": {
      "type": "object",
      "properties": {
        "keyMetrics": { "type": "array", "items": { "type": "string" } },
        "segmentationCriteria": { "type": "array", "items": { "type": "string" } },
        "successThresholds": { "type": "object" }
      }
    },
    "analysis": {
      "type": "object",
      "description": "Analysis results if response data was provided",
      "properties": {
        "responseRate": { "type": "number" },
        "keyFindings": { "type": "array", "items": { "type": "string" } },
        "segmentInsights": { "type": "object" },
        "statisticalConfidence": { "type": "object" },
        "recommendations": { "type": "array", "items": { "type": "string" } }
      }
    }
  }
}

Usage Example

javascript
const survey = await executeSkill('survey-design', {
  surveyType: 'pmf',
  objective: 'Measure product-market fit for new analytics feature',
  targetAudience: 'Active users who have used analytics at least 3 times',
  hypotheses: [
    'Users find the analytics feature valuable for their workflow',
    'Users would be disappointed if the feature was removed'
  ],
  maxQuestions: 8
});

Dependencies

  • Survey platform integrations
  • Statistical analysis libraries

Expand your agent's capabilities with these related and highly-rated skills.

a5c-ai/babysitter

gsd-tools

Central utility skill for GSD operations. Provides config parsing, slug generation, timestamps, path operations, and orchestrates calls to other specialized skills. Acts as the unified entry point that the original gsd-tools.cjs provided via its lib/ modules (commands, config, core, init).

514 31
Explore
a5c-ai/babysitter

model-profile-resolution

Resolve model profile (quality/balanced/budget) at orchestration start and map agents to specific models. Enables cost/quality tradeoffs by selecting appropriate AI models for each agent role.

514 31
Explore
a5c-ai/babysitter

verification-suite

Plan structure validation, phase completeness checks, reference integrity verification, and artifact existence confirmation. Provides the structured verification layer ensuring GSD artifacts are well-formed and complete.

514 31
Explore
a5c-ai/babysitter

state-management

STATE.md reading, writing, and field-level updates. Provides cross-session state persistence via .planning/STATE.md with structured fields for current task, completed phases, blockers, decisions, and quick tasks.

514 31
Explore
a5c-ai/babysitter

git-integration

Git commit patterns, formats, and conventions for GSD methodology. Provides atomic commits per task, structured commit messages, planning file commits, branch management, and milestone tag operations.

514 31
Explore
a5c-ai/babysitter

frontmatter-parsing

YAML frontmatter parsing and manipulation for .planning/ documents. Provides read, write, update, query, and validation operations on frontmatter blocks in GSD markdown artifacts.

514 31
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results