Workflows Overview
Workflows are step-by-step AI playbooks for specific real-world tasks. They guide you through complex AI interactions with practice scenarios, prompt templates, and expected outcomes — helping you build AI fluency for your role.
What is a Workflow?
A workflow is a WORKFLOW.md file that defines:
- YAML frontmatter — metadata like title, difficulty, role, safety level, time saved, and step definitions
- Markdown body — detailed overview and any additional context for the workflow
Unlike skills (which teach AI how to do things) and personas (which define AI personality), workflows provide structured practice — guided sequences that help you learn AI techniques through hands-on experience.
Workflow Structure
Each workflow contains multiple steps, where each step includes:
- Instruction — what you need to do in this step
- AI Prompt Template — pre-filled prompt you can customize
- Expected Output — what a good AI response looks like
- Tips — guidance for getting better results
Difficulty Levels
Workflows are categorized by difficulty, which determines fluency points earned:
- Beginner — Single-step tasks, 10 fluency points
- Intermediate — Multi-step workflows, 25 fluency points
- Advanced — Complex multi-step challenges, 50 fluency points
Safety Levels
Workflows have safety classifications to help you choose appropriately:
- safe-anywhere — Uses synthetic/practice data only, safe for any environment
- requires-own-ai — Should be run with your own AI provider (e.g., personal API key)
- uses-real-context — Designed for real data, requires Live Mode (unlocks at 250 fluency points)
Role-Based Workflows
Workflows are tagged with role categories to help you find relevant practice for your job:
- software-developer — Code review, debugging, documentation
- product-manager — PRDs, user stories, roadmaps
- designer — Design critiques, accessibility audits
- data-analytics — Data analysis, visualizations, reports
- marketer — Copy writing, campaign planning, A/B testing
- sales — Outreach, objection handling, proposals
- customer-success — Support responses, documentation
- hr-recruiting — Job descriptions, interview questions
- finance — Financial analysis, forecasting
- operations — Process documentation, SOPs
- content-writing — Blog posts, social content
- executive — Strategy documents, board presentations
Practice Mode vs Live Mode
Workflows can be completed in two modes:
- Practice Mode — Uses synthetic data generated for the scenario. Perfect for learning without risk.
- Live Mode — Paste your real context and work with actual data. Unlocks at 250 fluency points.
The Workflows Marketplace
Browse and discover workflows at /marketplace?tab=workflows. You can:
- Search by title, description, or tags
- Filter by role category
- Filter by difficulty level
- Sort by newest, most completed, or highest rated
- Preview workflow steps before starting
Creating Workflows
Workflows can be created by users with Creator access (Creator Pro plan or 1000+ fluency points). User-created workflows go through an AI quality gate:
- Score ≥80 auto-approves for the marketplace
- Lower scores receive specific improvement guidance
- No admin moderation queue — instant feedback loop
Next Steps
- WORKFLOW.md Format Reference — learn the complete specification for workflow files
- Browse Workflows — discover available workflows
- Skills Documentation — learn about reusable AI instructions