Create AI Studio Assistant Architect JSON import files from screenshots or descriptions. Use when users provide a screenshot of a form/UI to replicate, describe an assistant they want built, or need to generate multi-prompt workflow JSON for PSD AI Studio.
Create AI Studio Assistant Architect JSON import files from screenshots or descriptions. Use when users provide a screenshot of a form/UI to replicate, describe an assistant they want built, or need to generate multi-prompt workflow JSON for PSD AI Studio.
triggers
["create assistant","build assistant","assistant architect","ai studio assistant","assistant json","new assistant","design assistant","make this into an assistant","turn this into an assistant"]
allowed-tools
Read, Write, AskUserQuestion
version
1.3.1
Assistant Architect
Create valid JSON import files for PSD AI Studio's Assistant Architect system.
Spec Reference: See references/json-spec.md for complete field definitions and validation rules.
Input Modes
From Screenshot
When the user provides a screenshot, extract:
Element
Maps To
Text input boxes
short_text (single line) or long_text (multi-line)
Dropdowns/select menus
select with choices from visible options
Checkboxes/multi-select
multi_select
File upload areas
file_upload
Field labels
label property
Placeholder text
options.placeholder
Visible instructions
system_context or prompt content
Step numbers/tabs
Multiple prompts in sequence
Also infer:
Assistant name from title/header
Description from any visible purpose text
Prompt content from visible instructions or "what this does" text
Handling Collapsed Dropdowns
CRITICAL: When you see a dropdown in a screenshot but can't see its options (e.g., shows "Select subject" or has a dropdown arrow but options aren't expanded), you MUST resolve the options before generating JSON.
Resolution order:
Check if it matches a Common Field Library (see below)
"Grade", "Grade Level" → Use Grade Levels library
"Subject", "Content Area" → Use Subjects library
"State" → Use US States library
"Language" → Use Language library
"Tone", "Style" → Use Writing Tone library
"Format", "Output Format" → Use Output Format library
If no library match, ASK the user:
I see a dropdown for "[Field Name]" but can't see the options.
Options:
a) Provide a screenshot with the dropdown expanded
b) List the values that should appear (comma-separated)
c) Describe the type of options (e.g., "departments in our district")
Never leave a select field without choices - this will cause import errors
Visual indicators of dropdowns:
Dropdown arrow (▼ or chevron) on right side
"Select..." placeholder text
Bordered box that looks clickable but isn't a text input
Different styling from text inputs (often lighter/grayed placeholder)
From Description (Dictation/Rambling)
Parse unstructured input for:
Look For
Maps To
"user provides/enters/types..."
Input field
"asks for/needs a..."
Input field
"choose from/select/pick..."
select field
"upload/attach file..."
file_upload field
"then/next/after that..."
Additional prompt (chained)
"analyze/summarize/write/create..."
Prompt purpose
"should be/must be/format as..."
System context or prompt instructions
Smart Defaults
When not specified, use:
Decision
Default
Model
gpt-4o (complex tasks), gpt-4o-mini (simple Q&A)
Field type for text
long_text with 6 rows
Execution
Sequential (single prompt unless steps mentioned)
Timeouts
null (system default)
Required fields
true for primary input, false for options
Workflow
1. Gather Requirements
If screenshot provided: Extract all visible elements per the table above.
If description provided: Parse for inputs, outputs, and flow.
If unclear or incomplete: Ask targeted questions:
What should the assistant do?
What inputs does it need?
Single or multi-step?
1.5 Resolve All Dropdown Options (REQUIRED)
Before generating JSON, ensure every dropdown has defined options.
For each dropdown/select field identified:
If...
Then...
Options are visible in screenshot
Extract them exactly
Field matches a Common Field Library
Use the library options
Field is domain-specific (e.g., "Department", "Building", "Program")
ASK the user for the list
Unclear what options should be
ASK the user
Example question format:
I found these dropdowns that need options defined:
1. **Department** - What departments should be listed?
2. **Building** - What buildings/schools should be included?
3. **Program Type** - What program types exist?
You can provide comma-separated values, or share a screenshot with dropdowns expanded.
Do NOT proceed to JSON generation with unresolved dropdowns.
Save to user's preferred location (default: ~/Downloads/[assistant-name].json).
Quick Patterns
Simple Q&A Assistant
{"version":"1.0","export_source":"Geoffrey Assistant Architect","assistants":[{"name":"Quick Helper","description":"Answers questions clearly","prompts":[{"name":"answer","content":"Answer this question:\n\n${question}","system_context":"You are a helpful expert.","model_name":"gpt-4o-mini","position":0}],"input_fields":[{"name":"question","label"
Prompts at the same position with different parallel_group values run simultaneously. Parallel prompts can only reference outputs from earlier positions, never from other prompts at the same position.
{"prompts":[{"name":"framing","content":"Frame the key issues in this document:\n\n${document}","model_name":"gpt-4o","position":0,"parallel_group":null},{"name":"strengths","content":"Based on this framing:\n\n${prompt_0_output}\n\nIdentify strengths and opportunities.","model_name":"gpt-4o","position":1,"parallel_group":1000},{"name":"risks","content":
Key rules:
parallel_group = null → solo prompt (runs alone at its position)
parallel_group = unique number → runs in parallel with other prompts at same position
Parallel prompts reference ${prompt_N_output} from earlier positions ONLY
The synthesis prompt (position 2) can reference all earlier prompt outputs
Alternative syntax: Instead of ${prompt_N_output}, you can use ${slugified-prompt-name} (e.g., ${framing} for a prompt named "framing"). Both ${...} and {{...}} delimiters work.
Transform with Options
{"prompts":[{"name":"transform","content":"Rewrite in ${style} style:\n\n${content}","model_name":"gpt-4o","position":0}],"input_fields":[{"name":"content","label":"Content","field_type":"long_text","position":0},{"name":"style","label":"Writing Style","field_type":"select",
Validation Checklist
Before writing the file, verify:
version is "1.0"
Each assistant has name (min 3 chars), prompts, input_fields
Each prompt has name, content, model_name, position
Each input field has name, label, field_type, position
position values are sequential starting from 0
All ${variables} match input field names, prompt_N_output, or slugified prompt names
CRITICAL: Every select and multi_select field has options.choices array with at least 2 items
No dropdown was left with placeholder options like "Option 1", "Option 2"
Domain-specific dropdowns (departments, buildings, programs) have real values from user
Common Models
Use Case
Model
Complex analysis
gpt-4o
Simple tasks
gpt-4o-mini
Long context
claude-3-5-sonnet
Fast responses
gemini-1.5-flash
Common Field Libraries
CRITICAL: When a field represents a finite set of choices (grade levels, subjects, states, etc.), ALWAYS use select or multi_select with proper options—NEVER use short_text or long_text.
Detecting Select Fields
If the screenshot or description contains ANY of these patterns, use a select field:
{"name":"subject","label":"Subject","field_type":"select","options":{"required":true,"choices":[{"value":"English Language Arts","label":"English Language Arts"},{"value":"Mathematics","label":"Mathematics"},{"value":"Science","label":"Science"},{"value":"Social Studies"
SCOPE: Use these libraries ONLY when building AI Studio assistants for educational/instructional purposes (lesson plans, assessments, student feedback, curriculum tools, etc.).
Pedagogical alignment: For educational assistants, reference PSD's Instructional Essentials skill (/psd-instructional-vision) to ensure alignment with district beliefs about rigor, inclusion, data-driven decisions, and innovation.
{"name":"math_domain","label":"Math Domain","field_type":"select","options":{"choices":[{"value":"Counting and Cardinality","label":"Counting and Cardinality (K)"},{"value":"Operations and Algebraic Thinking","label":"Operations and Algebraic Thinking"},{"value":"Number and Operations in Base Ten","label":"Number and Operations in Base Ten"},{"value":"Number and Operations - Fractions","label":
Science Standards Domains (NGSS)
{"name":"science_domain","label":"Science Domain","field_type":"select","options":{"choices":[{"value":"Physical Science","label":"Physical Science"},{"value":"Life Science","label":"Life Science"},{"value":"Earth and Space Science","label":"Earth and Space Science"},{"value":"Engineering Design","label":"Engineering Design"
{"name":"student_population","label":"Student Population","field_type":"multi_select","options":{"choices":[{"value":"General Education","label":"General Education"},{"value":"English Learners (EL/MLL)","label":"English Learners (EL/MLL)"},{"value":"Students with IEPs","label":"Students with IEPs"},{"value":"Students with 504 Plans","label":"Students with 504 Plans"
Instructional Model (aligned with PSD Tier 1 practices)
{"name":"instructional_model","label":"Instructional Model","field_type":"select","options":{"choices":[{"value":"Whole Group","label":"Whole Group Direct Instruction"},{"value":"Small Group","label":"Small Group (Flexible Grouping)"},{"value":"Stations/Centers","label":"Stations/Learning Centers"},{"value":"Workshop Model","label":"Workshop Model (Mini-lesson → Work Time → Share)"
Assessment Type (aligned with Data-Driven Decisions essential)
For general assistants: Use the Common Field Libraries (grade, subject, state, tone, format, etc.).
For educational/instructional assistants: Use the K-12 District-Specific Field Libraries above AND invoke the PSD Instructional Vision skill (/psd-instructional-vision) for pedagogical alignment.
Educational Assistant Decision Framework
When a dropdown's options aren't visible in a screenshot for an educational tool:
Field Type
Assumption Strategy
Grade/Subject/State
Use Common Field Libraries
Standards
Use domain-level dropdowns (ELA, Math, Science domains) + text for specific codes
Roles/Positions
Use Educator Role library
Time/Duration
Use Lesson Duration or Grading Period library
Assessment
Use Assessment Type library
Instructional approach
Use Instructional Model library
Student groups
Use Student Population library
Cognitive rigor
Use Bloom's or DOK library
District-specific (buildings, departments)
Ask user - these vary by district
PSD Instructional Essentials Alignment
When building educational AI Studio assistants, ensure options align with PSD's four essentials:
Rigor & Inclusion → Include scaffolding options, differentiation choices, support for all learners
Data-Driven Decisions → Include assessment type options, formative check options
Continuous Growth → Include reflection prompts, self-assessment, goal-setting options
Innovation → Include technology integration, real-world connection, student voice options
Output
Write the JSON file to the user's specified path or ~/Downloads/[kebab-case-name].json.
Confirm:
File path written
Assistant name and purpose
Number of prompts and input fields
Next step: Import via AI Studio → Assistants → Import
:
"Your Question"
,
"field_type"
:
"long_text"
,
"position"
:
0
,
"options"
:
{
"required"
:
true
,
"rows"
:
6
}
}
]
}
]
}
"Based on this framing:\n\n${prompt_0_output}\n\nIdentify risks and weaknesses."
,
"model_name"
:
"gpt-4o"
,
"position"
:
1
,
"parallel_group"
:
1001
}
,
{
"name"
:
"synthesis"
,
"content"
:
"Synthesize these perspectives:\n\nStrengths: ${prompt_1_output}\n\nRisks: ${prompt_2_output}"
