From Process Street Workflow Toolkit
Build a new Process Street workflow from a description, document, or structured plan. Use when the user wants to create a workflow/template/process in Process Street.
How this skill is triggered — by the user, by Claude, or both
Slash command
/workflow-toolkit:ps-buildThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Turn a description (or pasted process / document) into a live Process Street workflow via the public API.
Turn a description (or pasted process / document) into a live Process Street workflow via the public API.
CLI: python3 "${CLAUDE_PLUGIN_ROOT}/scripts/process_street.py" <command> (when installed as a plugin) or python3 scripts/process_street.py from the repo. Needs PROCESS_STREET_API_KEY set. Capability + field-type detail: reference/api-reference.md. Design guidance: reference/best-practices.md.
Get: the workflow name and outcome, the steps in order (who does what), decision points (branches), approvals/sign-offs, data to capture (and at which step), SLAs, stop gates, and anything conditional. If the user pasted a document or transcript, extract this from it. Ask one clarifying question only if something essential is missing.
Apply best practices (reference/best-practices.md): outcome-based name, 6–15 verb-named steps, the right field type per datum (Select for fixed choices, Date, Number, Members, Email — not all free text), conditional logic to hide irrelevant steps, stops/approvals only where they earn the friction, dynamic due dates, an owner per task.
Build-plan shape (see api-reference.md for all 17 field types, due-date/assignment rules, content widgets):
{
"name": "Customer Onboarding",
"folderId": "<folderId>",
"shareLevel": "Run",
"tasks": [
{"name": "Intake", "taskType": "Standard", "dueOffset": "P1D", "widgets": [
{"fieldType": "Text", "label": "Company Name"},
{"fieldType": "Select", "label": "Plan Tier", "options": ["Starter", "Pro", "Enterprise"]},
{"fieldType": "Number", "label": "Seats", "constraints": {"minValue": 1, "decimalPlaces": 0}}
]},
{"name": "Manager Approval", "taskType": "Approval", "stop": true,
"assignmentRules": [{"email": "[email protected]"}],
"dueDateRule": {"sourceType": "PreviousTaskCompletedDate", "offsetDirection": "After", "dueOffset": "P1D", "businessDaysHandlingMode": "BusinessDaysOnly"}}
],
"logicRules": [
{"action": "Show",
"condition": {"or": [{"and": [{"widgetId": "$widget:Intake:Plan Tier", "operator": "Is", "value": "Enterprise"}]}]},
"targets": {"taskIds": ["$task:Enterprise Setup"]}}
]
}
Use $task:Step Name and $widget:Step Name:Field Label symbolic refs. Logic operators: Is, IsNot, HasAnyValue, HasNoValue, IsGreaterThan, IsLessThan.
You need a folderId. List folders: process_street.py folders. Create one: process_street.py folder-create --name "...".
Show the user a plain-English summary (steps, types, fields, logic, what's manual). Get a yes. Then:
echo '<plan-json>' | python3 "${CLAUDE_PLUGIN_ROOT}/scripts/process_street.py" build-workflow [--draft-only]
Use --draft-only if the plan has AI or Code tasks (they can't publish until configured). Then configure them and publish:
task-config <wf> <rev> <taskId> --type Ai --prompt "..."task-config <wf> <rev> <taskId> --type Code --code 'outputData["x"]=inputData["y"]' --input-mapping '{"y":"<fieldId>"}' --output-mapping '{"x":"<fieldId>"}'task-config <wf> <rev> <approvalTaskId> --type Approval --subject-task-ids <taskId>publish-revision <wf> <rev>Make it look professional and on-brand with add-media <wf> <rev> <taskId> (create a draft first if already published):
--logo-domain <client-domain> (company logo), --text '## Welcome…' on step 1--stock "keyword,keyword" topic image, --video <youtube-url>, --embed <url> (a relevant live resource)
Make assets relevant to the use case. Brand colors/cover/fonts are UI-only — mention that if asked.process_street.py template-export <workflowId> — confirm steps, fields, logic. Give the user the workflow URL: https://app.process.st/workflows/<workflowId>.
Required-field flag, brand theming (colors/cover/fonts), org/SSO settings, deep native-integration config. File fields are created as MultiFile.
Guides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.
npx claudepluginhub process-street/workflow-toolkit --plugin workflow-toolkit