synapse-export:help Command Workflow
Codex Adaptation
- Treat the user request or explicitly supplied text as the command arguments.
- Use the available Codex file, search, terminal, and clarification capabilities that match the workflow.
- Do not depend on Claude-only slash command variables or tool names.
Synapse Export Help
Export annotation data, ground truth datasets, and task data from Synapse projects. Supports multiple output formats (JSON, COCO, YOLO, Pascal VOC) and both script-based and plugin-based execution.
Available Commands
| Command |
Description |
/synapse-export:help |
Show this help message |
/synapse-export:export |
Export data from a Synapse project |
/synapse-export:export-status |
Check status and logs of an export job |
Skills (Auto-Activated)
The following skills automatically activate based on conversation context:
| Skill |
Triggers |
| export-workflow |
"export", "download annotations", "ground truth", "COCO format", "YOLO format", "Pascal VOC", "export assignments", "export tasks", "download labels" |
Agents (Autonomous)
| Agent |
Purpose |
| export-assistant |
Full export orchestrator — analyze annotations, convert formats, execute export |
Prerequisites
| Requirement |
Minimum Version |
Check Command |
| Python |
3.12+ |
python3 --version |
| synapse-sdk |
>= 2026.1.39 |
synapse --version |
| Synapse authentication |
— |
synapse doctor |
Environment Setup
# Try the current shell first (venv may already be activated)
synapse --version
# If not found, look for a venv in cwd and activate it
ls -d *venv* .venv 2>/dev/null
source .venv/bin/activate # or whichever venv dir was found
# If no venv exists, install manually
uv pip install "synapse-sdk[all]>=2026.1.39"
# Authenticate
synapse login
# Verify
synapse doctor
Quick Start
- Export annotations:
/synapse-export:export --project 42 --format coco
- Export ground truth:
/synapse-export:export --target ground_truth --gt-version 15 --format yolo
- Check job status:
/synapse-export:export-status <job-id>
Examples
Export project annotations as COCO
/synapse-export:export --project 42 --target assignment --format coco
Export ground truth as YOLO with train/val split
/synapse-export:export --target ground_truth --gt-version 15 --format yolo --split 0.8/0.2
Export raw JSON with original files
/synapse-export:export --project 42 --format json --save-original-files
Interactive export (no arguments)
/synapse-export:export
Export Targets
| Target |
Source |
Required |
Use Case |
| assignment |
Labeler/reviewer work |
Project ID |
Export labeled annotations |
| ground_truth |
Curated GT datasets |
GT version ID |
Export training/validation data |
| task |
Task definitions + annotations |
Project ID |
Export task metadata |
Output Formats
| Format |
Best For |
Annotation Types |
| JSON (Synapse) |
Full fidelity export, backup |
All types |
| COCO |
Object detection, segmentation |
bbox, polygon, keypoint |
| YOLO |
Real-time detection models |
bbox only |
| Pascal VOC |
Classic detection benchmarks |
bbox only |
| CSV |
Spreadsheet analysis |
Classification, simple attributes |
How It Works
- Select target — Choose what to export (assignments, ground truth, tasks)
- Analyze data — Sample annotations to understand types and classes
- Choose format — Pick output format based on annotation types
- Plan export — Show summary with item count, format, and output structure
- Execute — Write export script and submit via
synapse script submit
- Report — Display results with output file details
Getting Help
- Ask about export formats: "What format should I use for YOLO training?"
- Ask about filtering: "Can I export only reviewed assignments?"
- Ask about splitting: "How do I create train/val/test splits?"
- Ask about large exports: "How do I export 50,000 annotations efficiently?"
- Ask about custom formats: "I need a custom CSV with specific columns"
The relevant skills will automatically load to provide detailed guidance.
1---2name: help-command-43description: Run the `synapse-export:help` workflow from the original Claude slash command. Use when the user asks to show all available Synapse export commands and features4---56<!-- Generated by tools/generate-agent-marketplaces.py; edit the source command or agent-plugin.yaml instead. -->78# synapse-export:help Command Workflow910## Codex Adaptation1112- Treat the user request or explicitly supplied text as the command arguments.13- Use the available Codex file, search, terminal, and clarification capabilities that match the workflow.14- Do not depend on Claude-only slash command variables or tool names.1516# Synapse Export Help1718Export annotation data, ground truth datasets, and task data from Synapse projects. Supports multiple output formats (JSON, COCO, YOLO, Pascal VOC) and both script-based and plugin-based execution.1920## Available Commands2122| Command | Description |23|---------|-------------|24| `/synapse-export:help` | Show this help message |25| `/synapse-export:export` | Export data from a Synapse project |26| `/synapse-export:export-status` | Check status and logs of an export job |2728## Skills (Auto-Activated)2930The following skills automatically activate based on conversation context:3132| Skill | Triggers |33|-------|----------|34| **export-workflow** | "export", "download annotations", "ground truth", "COCO format", "YOLO format", "Pascal VOC", "export assignments", "export tasks", "download labels" |3536## Agents (Autonomous)3738| Agent | Purpose |39|-------|---------|40| **export-assistant** | Full export orchestrator — analyze annotations, convert formats, execute export |4142## Prerequisites4344| Requirement | Minimum Version | Check Command |45|-------------|----------------|---------------|46| Python | 3.12+ | `python3 --version` |47| synapse-sdk | >= 2026.1.39 | `synapse --version` |48| Synapse authentication | — | `synapse doctor` |4950### Environment Setup5152```bash53# Try the current shell first (venv may already be activated)54synapse --version5556# If not found, look for a venv in cwd and activate it57ls -d *venv* .venv 2>/dev/null58source .venv/bin/activate # or whichever venv dir was found5960# If no venv exists, install manually61uv pip install "synapse-sdk[all]>=2026.1.39"6263# Authenticate64synapse login6566# Verify67synapse doctor68```6970## Quick Start71721. **Export annotations**: `/synapse-export:export --project 42 --format coco`732. **Export ground truth**: `/synapse-export:export --target ground_truth --gt-version 15 --format yolo`743. **Check job status**: `/synapse-export:export-status <job-id>`7576## Examples7778### Export project annotations as COCO79```80/synapse-export:export --project 42 --target assignment --format coco81```8283### Export ground truth as YOLO with train/val split84```85/synapse-export:export --target ground_truth --gt-version 15 --format yolo --split 0.8/0.286```8788### Export raw JSON with original files89```90/synapse-export:export --project 42 --format json --save-original-files91```9293### Interactive export (no arguments)94```95/synapse-export:export96```9798## Export Targets99100| Target | Source | Required | Use Case |101|--------|--------|----------|----------|102| **assignment** | Labeler/reviewer work | Project ID | Export labeled annotations |103| **ground_truth** | Curated GT datasets | GT version ID | Export training/validation data |104| **task** | Task definitions + annotations | Project ID | Export task metadata |105106## Output Formats107108| Format | Best For | Annotation Types |109|--------|----------|-----------------|110| **JSON** (Synapse) | Full fidelity export, backup | All types |111| **COCO** | Object detection, segmentation | bbox, polygon, keypoint |112| **YOLO** | Real-time detection models | bbox only |113| **Pascal VOC** | Classic detection benchmarks | bbox only |114| **CSV** | Spreadsheet analysis | Classification, simple attributes |115116## How It Works1171181. **Select target** — Choose what to export (assignments, ground truth, tasks)1192. **Analyze data** — Sample annotations to understand types and classes1203. **Choose format** — Pick output format based on annotation types1214. **Plan export** — Show summary with item count, format, and output structure1225. **Execute** — Write export script and submit via `synapse script submit`1236. **Report** — Display results with output file details124125## Getting Help126127- Ask about export formats: "What format should I use for YOLO training?"128- Ask about filtering: "Can I export only reviewed assignments?"129- Ask about splitting: "How do I create train/val/test splits?"130- Ask about large exports: "How do I export 50,000 annotations efficiently?"131- Ask about custom formats: "I need a custom CSV with specific columns"132133The relevant skills will automatically load to provide detailed guidance.
datamaker-kr