Surveycto Skill

scto — SurveyCTO Design Skill for Claude Code

A Claude Code skill that turns natural-language survey design requests into production-ready SurveyCTO `.xlsx` files and inline sheet tables. Built for development economists, field researchers, and survey programmers.

---

What it does

Invoke this skill to:

• Build a full survey form from a module list or description
• Add a section or module to an existing form (household roster, agricultural plot roster, food consumption, health module, etc.)
• Debug a form — diagnose broken skip logic, repeat errors, constraint failures, or pulldata issues
• Generate the .xlsx file via a self-contained Python/openpyxl script, ready to upload to SurveyCTO

The skill produces:

1. Inline pipe-separated sheet tables (survey / choices / settings)
2. A Python/openpyxl script that writes the .xlsx file
3. The saved .xlsx file

---

Who it's for

• Development economics researchers running household, agricultural, health, or panel surveys
• Field coordinators programming CAPI instruments in SurveyCTO or ODK
• Survey programmers building forms with complex rosters, cascading selects, preloaded data, or audio audit
• Anyone designing questionnaires for RCTs, impact evaluations, or LSMS-style surveys

---

Installation

# Clone into your Claude Code skills directory
git clone https://github.com/saeehatwalne/claude-scto-skill ~/.claude/skills/scto

Or manually copy the files:

~/.claude/skills/scto/
├── SKILL.md                          # Skill definition (loaded by Claude Code)
├── README.md                         # This file
├── assets/
│   └── scto_template.xlsx            # Blank XLSForm template with standard headers
└── references/
    ├── field-types.md                # All field types: syntax, appearance, constraints
    ├── xlsform-columns.md            # All survey/choices/settings columns
    ├── expressions-and-logic.md      # All operators, functions, skip logic patterns
    ├── r