survey-architect SKILL.md skillA

survey-architect from ommakes/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add ommakes/skills/survey-architect@v1.2.3

Pins v1.2.3 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
ommakes/skills
Path
ux-research/survey-architect/SKILL.md
Versions recorded
6
Latest version
v1.2.3, committed Sep 24, 2026
First version recorded
Sep 12, 2026
Size
10,010 bytes
Repository stars
21
License
MIT

Turns a research question into a validated, deploy-ready survey: a short intake, the right instrument for what's being measured (SEQ, SUS, UMUX-Lite, SUPR-Q, NPS, CSAT, CES, PSSUQ, or a custom item set), and a platform-native file for Qualtrics, Typeform, or an in-app survey. Trigger when someone says "I need to survey users about X," "what should I ask users after they do Y," "build me an NPS survey," "help me measure usability of Z," or pastes a vague research need and wants it turned into…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Survey Architect

Turns "I need to know something about users" into a specific, validated,
deployable survey — not a generic questionnaire.

This skill does not open with a survey. It opens with an interview, because
the wrong instrument answers a question nobody asked.

-----

## Step 0: Intake — never skip this

Before picking an instrument, ask (as a short back-and-forth, not a form
dump):

1. **What product or surface is this for?** Check `../config/product-context.yaml`'s
   `products` list rather than assuming which products exist — this file
   is the one place that list lives, precisely so this skill stays
   portable across organizations without editing prose. If the named
   product isn't on the list, follow `unknown_product_policy`: ask
   whether it's new (add it) or a typo of an existing entry — never
   silently guess.
2. **What decision will this survey inform?** Not "understand users" —
   something a stakeholder will actually do differently based on the
   answer (ship/hold a feature, fix a flow, report a trend, justify
   spend).
3. **Where in the user's experience does this sit?** A single task, a
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ommakes/skills/survey-architect@sha256:c23afedb4ddddafe

The line at the top of this page pins the label v1.2.3, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ogl63btzmfzkxhzr.svg)](https://markdownregistry.com/a/art_ogl63btzmfzkxhzr)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 6 versions of this file, between Sep 12, 2026 and Sep 24, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
v1.2.3 latest2026-09-24 3ad0aaa 10,010 BA view · diff
v1.2.22026-09-12 9365807 10,385 BA view · diff
v1.1.12026-09-12 65794da 8,970 BA view · diff
v1.2.12026-09-12 382259c 10,385 BA view · diff
v1.2.02026-09-12 bf7dc52 10,385 BA view · diff
v1.1.02026-09-12 d2959ba 8,977 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (10010 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

ommakes/skills · 21 stars · license MIT · pushed 2026-10-28 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ogl63btzmfzkxhzr
GET https://markdownregistry.com/api/v1/resolve?ref=ommakes/skills/survey-architect
GET https://markdownregistry.com/api/v1/blob/c23afedb4ddddafecd12010e14a1ce3b644de8f4070df8511537928a8ed2d87e

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from ommakes/skills

CLAUDE.md CLAUDE.md file
ommakes/skills · CLAUDE.md
git:20261027.44b2975 · audit A · 21 stars
case-study SKILL.md skill
ommakes/skills · case-study/SKILL.md · Write a portfolio case study teaser (recommended 100-150 words) through guided multiple choice questions, or review an…
v1.0.0 · audit A · 21 stars
changelog-writer SKILL.md skill
ommakes/skills · changelog-writer/SKILL.md · Write external-facing changelog and release note entries in a pithy, tastefully sassy, occasionally clever voice that…
v1.0.0 · audit A · 21 stars
conversion-patterns SKILL.md skill
ommakes/skills · conversion-patterns/SKILL.md · Condition-gated paywall, checkout, retention, referral, and monetization-awareness patterns sourced from published A/B…
v1.0.0 · audit A · 21 stars
design-ask SKILL.md skill
ommakes/skills · design-ask/SKILL.md · Unpacks poorly written Jira or Azure DevOps tickets into design-relevant framing. Use this skill whenever a designer…
v1.0.0 · audit A · 21 stars
design-rationale SKILL.md skill
ommakes/skills · design-rationale/SKILL.md · Help designers articulate the cognitive science, behavioral psychology, and platform standards behind their design…
v1.2.0 · audit A · 21 stars
designer-ic-assessment SKILL.md skill
ommakes/skills · designer-ic-assessment/SKILL.md · Facilitates a structured behavioral assessment interview for IC designer levels, incorporating AI fluency across…
v1.1.0 · audit A · 21 stars
gtm-positioning SKILL.md skill
ommakes/skills · gtm-positioning/SKILL.md · Framework-based skill for B2B product positioning, GTM strategy selection, and website messaging. Use when someone asks…
v1.0.0 · audit A · 21 stars
longform SKILL.md skill
ommakes/skills · longform/SKILL.md · Write or review long-form thought-leadership content: Medium/blog posts, LinkedIn essays, newsletter pieces, and the…
v1.2.0 · audit A · 21 stars
metrics-tagging SKILL.md skill
ommakes/skills · metrics-tagging/SKILL.md · Analyze UI mockups, screenshots, or prototype frames to identify all trackable interactions and generate a complete…
v1.1.0 · audit A · 21 stars
onboarding-flow SKILL.md skill
ommakes/skills · onboarding-flow/SKILL.md · Design new onboarding flows or evaluate/critique existing ones — signup sequences, setup checklists, first-run wizards…
v1.2.0 · audit A · 21 stars
righter SKILL.md skill
ommakes/skills · righter/SKILL.md · Apply UX content writing principles to review existing UI copy or write new UI copy from scratch. Use this skill…
v1.10.0 · audit A · 21 stars

Every file in ommakes/skills

Browse by kind, by grade A, or by owner.