Awesome-Grok-Workflows is a comprehensive ecosystem of composable YAML workflows, battle-tested rules, intelligent prompts, specialized agents, and orchestration patterns — built exclusively for Grok to harness the full potential of the Awesome-Grok-Skills ecosystem.
graph TB
subgraph "Awesome-Grok-Workflows Ecosystem"
subgraph "Core Components"
W[Workflows<br/>52 files]
R[Rules<br/>64 files]
P[Prompts<br/>200 files]
A[Agents<br/>60 files]
end
subgraph "Support Systems"
S[Scripts<br/>15 files]
T[Templates<br/>18 files]
D[Docs<br/>9 files]
end
subgraph "Integration Layer"
SK[Skills Repo]
GK[Grok Engine]
GH[GitHub Actions]
end
end
W -->|orchestrates| A
R -->|governs| W
P -->|powers| A
T -->|generates| W
S -->|validates| W
S -->|validates| R
S -->|validates| P
A -->|uses| SK
W -->|executes on| GK
S -->|triggers| GH
style W fill:#4CAF50,color:#fff
style R fill:#2196F3,color:#fff
style P fill:#FF9800,color:#fff
style A fill:#9C27B0,color:#fff
style S fill:#607D8B,color:#fff
style T fill:#795548,color:#fff
| Component | Subfolders | |-----------|-------|-------|------------| | Prompts | 10 subfolders | | Rules | 10 subfolders | | Workflows | 10 subfolders | | Agents| 10 subfolders | | Templates | 1 folder | | Scripts | 1 folder | | Docs | 1 folder | | Tests | 2 folders | | Models 1 folder |
timeline
title Grok Model Evolution
section 2023
Grok-1 : Nov 2023 : 33B params : Apache-2.0
section 2024
Grok-1.5 : May 2024 : 128K context
Grok-2 : Aug 2024 : Vision + Tools
Grok-2 Mini : Aug 2024 : Lightweight
section 2025
Grok-3 : Feb 2025 : 10x compute
Grok-3 Mini : Feb 2025 : Balanced
Grok-3 Fast : Mar 2025 : Speed
Grok-4 : Jul 2025 : Flagship
Grok-4 Heavy : Jul 2025 : Enhanced
Grok Code Fast 1 : Aug 2025 : Free coding
Grok-4 Fast : Sep 2025 : Enterprise
Grok-4.1 : Nov 2025 : Improved
Grok-4.1 Fast : Nov 2025 : Agent Tools
section 2026
Grok 4.20 Beta : Feb 2026 : Newest flagship
Grok 4.3 Beta : Apr 2026 : Improved arch
Grok 4.5 : Jul 2026 : 1.5T V9 foundation
mindmap
root((Grok Models))
Original
Grok-1
Grok-1.5
Grok-2
Grok-2 Mini
Advanced
Grok-3
Grok-3 Mini
Grok-3 Fast
Grok-4
Grok-4 Heavy
Grok-4 Fast
Latest
Grok-4.1
Grok-4.1 Fast
Grok-4.20 Beta
Grok-4.3 Beta
Grok-4.5
Specialized
Grok Vision
Grok Code Fast 1
Grok Build
Reference
API Reference
Model Comparison
Use Cases
Best Practices
Integration Guide
| Model | Release | Description | |-------|---------|-------|-------------| | grok-1.md | Nov 2023 First Grok, 33B params | | grok-1-5.md | May 2024 | 128K context | | grok-2.md | Aug 2024 | Vision, tools | | grok-2-mini.md | Aug 2024 | Lightweight | | grok-3.md | Feb 2025 | 10x compute | | grok-3-mini.md | Feb 2025 | Balanced | | grok-3-fast.md | Mar 2025 | Speed optimized | | grok-4.md | Jul 2025 | Flagship | | grok-4-heavy.md | Jul 2025 | Enhanced | | grok-4-fast.md | Sep 2025 | Enterprise | | grok-code-fast-1.md | Aug 2025 | Free coding | | grok-4-1.md | Nov 2025 | Improved | | grok-4-1-fast.md | Nov 2025 | Agent Tools | | grok-4-20-beta.md | Feb 2026 | Newest beta | | grok-4-3-beta.md | Apr 2026 | Improved arch | | grok-4-5.md | Jul 2026 | 1.5T V9 | | grok-vision.md | — | Vision capabilities | | grok-build.md | Jul 2026 | CLI coding agent |
See models/README.md for complete model documentation.
graph TD
ROOT[awesome-grok-workflows/] --> WF[workflows/<br/>52 files]
ROOT --> RU[rules/<br/>64 files]
ROOT --> PR[prompts/<br/>200 files]
ROOT --> AG[agents/<br/>60 files]
ROOT --> TE[templates/<br/>18 files]
ROOT --> SC[scripts/<br/>15 files]
ROOT --> DO[docs/<br/>9 files]
WF --> WF1[automation/ 5]
WF --> WF2[data-processing/ 5]
WF --> WF3[infrastructure/ 5]
WF --> WF4[monitoring/ 5]
WF --> WF5[patterns/ 5]
WF --> WF6[planning/ 5]
WF --> WF7[security/ 5]
WF --> WF8[templates/ 6]
WF --> WF9[testing/ 5]
WF --> WF10[domain-specific/ 6]
RU --> RU1[core-rules/ 10]
RU --> RU2[architecture-rules/ 6]
RU --> RU3[agent-rules/ 4]
RU --> RU4[domain-rules/ 8]
RU --> RU5[security-rules/ 5]
RU --> RU6[performance-rules/ 5]
RU --> RU7[style-rules/ 7]
RU --> RU8[testing-rules/ 7]
RU --> RU9[documentation-rules/ 6]
RU --> RU10[ethics-rules/ 6]
PR --> PR1[analysis/ 20]
PR --> PR2[classification/ 20]
PR --> PR3[evaluation/ 20]
PR --> PR4[extraction/ 20]
PR --> PR5[few-shot/ 20]
PR --> PR6[generation/ 20]
PR --> PR7[summarization/ 20]
PR --> PR8[system/ 20]
PR --> PR9[templates/ 20]
PR --> PR10[transformation/ 20]
AG --> AG1[code-agents/ 11]
AG --> AG2[content-agents/ 4]
AG --> AG3[domain-agents/ 7]
AG --> AG4[orchestrator-agents/ 1]
AG --> AG5[research-agents/ 2]
AG --> AG6[data-agents/ 7]
AG --> AG7[security-agents/ 7]
AG --> AG8[devops-agents/ 7]
AG --> AG9[business-agents/ 7]
AG --> AG10[creative-agents/ 7]
style ROOT fill:#1a1a2e,color:#fff
style WF fill:#4CAF50,color:#fff
style RU fill:#2196F3,color:#fff
style PR fill:#FF9800,color:#fff
style AG fill:#9C27B0,color:#fff
style TE fill:#795548,color:#fff
style SC fill:#607D8B,color:#fff
style DO fill:#00BCD4,color:#fff
sequenceDiagram
participant U as User
participant O as Orchestrator
participant A1 as Agent 1
participant A2 as Agent 2
participant A3 as Agent 3
participant V as Validator
U->>O: Trigger Workflow
O->>O: Parse & Validate
O->>A1: Delegate Task 1
A1-->>O: Result 1
par Parallel Execution
O->>A2: Task 2a
O->>A3: Task 2b
end
A2-->>O: Result 2a
A3-->>O: Result 2b
O->>V: Validate Outputs
V-->>O: Validation Pass
O-->>U: Workflow Complete
graph LR
subgraph "Code Agents"
CA1[API Architect]
CA2[Code Review]
CA3[Database Arch]
CA4[DevOps]
CA5[Fullstack]
CA6[ML Engineer]
CA7[Mobile Dev]
CA8[Security]
CA9[TDD]
CA10[Linux Sys]
CA11[Efficient Code]
end
subgraph "Domain Agents"
DA1[Blockchain]
DA2[DeFi]
DA3[Physics]
DA4[Quantum]
DA5[BCI]
DA6[Sustainability]
DA7[Validation]
end
subgraph "Business Agents"
BA1[Product]
BA2[Market]
BA3[Finance]
BA4[Operations]
BA5[Customer Success]
BA6[Growth]
BA7[BI]
end
subgraph "Creative Agents"
CR1[UI/UX]
CR2[Brand]
CR3[Content]
CR4[Animation]
CR5[Game]
CR6[AR/VR]
CR7[Creative Dir]
end
subgraph "Support Agents"
SA1[Data Pipeline]
SA2[Data Analyst]
SA3[Data Engineer]
SA4[MLOps]
SA5[Governance]
SA6[Realtime]
SA7[Visualization]
end
subgraph "Security Agents"
SE1[Pen Tester]
SE2[Incident]
SE3[Threat Intel]
SE4[Compliance]
SE5[Code Review]
SE6[Cloud Sec]
SE7[IAM]
end
subgraph "DevOps Agents"
DO1[Infrastructure]
DO2[Containers]
DO3[CI/CD]
DO4[SRE]
DO5[Cost]
DO6[DR]
DO7[Observability]
end
style CA1 fill:#4CAF50,color:#fff
style DA1 fill:#FF9800,color:#fff
style BA1 fill:#2196F3,color:#fff
style CR1 fill:#E91E63,color:#fff
style SA1 fill:#9C27B0,color:#fff
style SE1 fill:#F44336,color:#fff
style DO1 fill:#607D8B,color:#fff
mindmap
root((Workflows))
Automation
Scheduled Tasks
Code Review
Report Gen
Notifications
Backup/Recovery
Data Processing
Pipeline
Migration
ETL
Quality
Streaming
Infrastructure
DNS
Terraform
CDN
Cloud Opt
Kubernetes
Monitoring
Infrastructure
Metrics
Health Checks
Logs
Synthetic
Patterns
Reflection
Delegation
Tree of Thought
ReAct
Code Review
Planning
Research
Full Stack
Data Science
Security Audit
Mobile
Security
Audit
Secrets
Compliance
Vulnerability
Incident
Testing
Automated
Unit
Integration
E2E
Performance
graph TB
subgraph "Core Rules"
CR1[Code Quality]
CR2[Security]
CR3[Performance]
CR4[Testing]
CR5[Documentation]
CR6[Accessibility]
CR7[API Design]
CR8[Database]
CR9[Safety Guardrails]
CR10[Grok Personality]
end
subgraph "Domain Rules"
DR1[AI/ML]
DR2[Web3/DeFi]
DR3[DevOps]
DR4[Mobile]
DR5[Content]
DR6[Quantum]
DR7[Data Engineering]
DR8[Game Dev]
end
subgraph "Specialized Rules"
SR1[Architecture]
SR2[Ethics]
SR3[Style Guides]
SR4[Testing]
SR5[Documentation]
end
CR1 --> DR1
CR2 --> SR1
CR3 --> DR7
CR4 --> SR4
CR5 --> SR5
style CR1 fill:#2196F3,color:#fff
style DR1 fill:#FF9800,color:#fff
style SR1 fill:#4CAF50,color:#fff
graph TB
subgraph "Prompt Categories"
PC1[Analysis<br/>20 files]
PC2[Classification<br/>20 files]
PC3[Evaluation<br/>20 files]
PC4[Extraction<br/>20 files]
PC5[Few-Shot<br/>20 files]
PC6[Generation<br/>20 files]
PC7[Summarization<br/>20 files]
PC8[System<br/>20 files]
PC9[Templates<br/>20 files]
PC10[Transformation<br/>20 files]
end
subgraph "Analysis Types"
AT1[Code Analysis]
AT2[Bug Analysis]
AT3[Security]
AT4[Performance]
AT5[Architecture]
AT6[Complexity]
AT7[Dependencies]
AT8[API Design]
AT9[Database]
AT10[Accessibility]
end
subgraph "Generation Types"
GT1[Code Gen]
GT2[API Client]
GT3[Config]
GT4[Documentation]
GT5[Query]
GT6[Test]
GT7[UI Component]
GT8[DB Schema]
GT9[Report]
GT10[Email]
end
PC1 --> AT1
PC6 --> GT1
style PC1 fill:#FF9800,color:#fff
style AT1 fill:#4CAF50,color:#fff
style GT1 fill:#2196F3,color:#fff
graph LR
subgraph "Input"
I1[User Request]
I2[GitHub Event]
I3[Schedule]
I4[Manual Trigger]
end
subgraph "Processing"
P1[Orchestrator]
P2[Agent Selection]
P3[Task Execution]
P4[Validation]
end
subgraph "Output"
O1[Code Changes]
O2[Reports]
O3[Deployments]
O4[Notifications]
end
I1 --> P1
I2 --> P1
I3 --> P1
I4 --> P1
P1 --> P2
P2 --> P3
P3 --> P4
P4 --> O1
P4 --> O2
P4 --> O3
P4 --> O4
style I1 fill:#4CAF50,color:#fff
style P1 fill:#2196F3,color:#fff
style O1 fill:#FF9800,color:#fff
- YAML-based graphs for chaining agents and skills
- ReAct loops, reflection, delegation, and multi-agent handoffs
- Trigger-based execution (push, PR, schedule, manual)
- Conditional execution with guardrails and checkpoints
- 52 production workflows across 10 categories
- 64 rule files across 10 categories
- Core rules for code quality, security, performance, testing
- Domain rules for AI/ML, Web3, DevOps, mobile, content
- Ethics rules for responsible AI, bias mitigation, privacy
- Style guides for SQL, JavaScript, Python, Git, Markdown
- 200 prompt files across 10 categories
- System prompts for every agent type
- Few-shot examples for consistent outputs
- Jinja2-templated chains for complex workflows
- Analysis, classification, evaluation, extraction prompts
- Generation, summarization, transformation prompts
- 60 agent definitions across 10 categories
- Code agents: API architect, code review, DevOps, ML, mobile, security
- Domain agents: Blockchain, DeFi, physics, quantum, BCI
- Business agents: Product, market, finance, operations, growth
- Creative agents: UI/UX, brand, content, animation, game, AR/VR
- Data agents: Pipeline, analyst, engineer, MLOps, governance
- Security agents: Pen testing, incident response, compliance
- DevOps agents: Infrastructure, containers, CI/CD, SRE
- 15 utility scripts for validation, generation, and analysis
- 18 templates for workflows, agents, security, and infrastructure
- Schema validation with JSON Schema
- CI/CD integration with GitHub Actions
- Mermaid diagram generation for visualization
# Clone the repository
git clone https://github.com/LifeJiggy/Awesome-Grok-Workflows.git
cd Awesome-Grok-Workflows
# Run setup (cross-platform)
python scripts/setup.py # Python
.\scripts\setup.ps1 # PowerShell
./scripts/setup.sh # Bash# Validate everything
./scripts/validate-all.sh
# Validate specific components
./scripts/validate-prompts.sh # Prompts
./scripts/validate-rules.sh # Rules
./scripts/validate-workflow.sh # Workflows# Generate a new workflow
python scripts/generate-workflow.py "My Workflow" --template ci-cd
# List available templates
python scripts/generate-workflow.py --list
# Preview generated workflow
python scripts/generate-workflow.py "My Workflow" --preview# List all prompts
python scripts/load-prompts.py --list
# Search prompts
python scripts/load-prompts.py --search "code generation"
# Render a prompt with variables
python scripts/load-prompts.py --render code-analysis --var "language=python"# Generate agent definitions
python scripts/generate-agents.py --type security --output agents/
# List agent types
python scripts/generate-agents.py --list# Generate project statistics
python scripts/project-stats.py
# Export as JSON
python scripts/project-stats.py --json
# Export as Markdown
python scripts/project-stats.py --markdown| Workflow | Category | Description |
|---|---|---|
| Full-Stack Planner | Planning | Complete dev plans with architecture |
| CI/CD Pipeline | Automation | Automated code review and testing |
| Data Pipeline | Data | ETL with quality validation |
| Security Audit | Security | Comprehensive security scanning |
| Infrastructure Monitoring | Monitoring | Full observability stack |
| Kubernetes Setup | Infrastructure | Production K8s deployment |
| Performance Testing | Testing | Load, stress, and soak tests |
| Incident Response | Security | Automated incident handling |
| Template | Description | Use Case |
|---|---|---|
| Base Template | Starting point for new workflows | All workflows |
| CI/CD Pipeline | Multi-platform CI/CD | Deployment |
| API Design | OpenAPI 3.1 specifications | API development |
| Agent Definition | Agent configuration | Agent creation |
| Security Audit | Security audit reports | Compliance |
| Test Plan | Comprehensive test plans | QA |
| Terraform | Infrastructure as Code | DevOps |
| Docker | Container configuration | Deployment |
| Kubernetes | K8s resource definitions | Orchestration |
| Data Pipeline | ETL pipeline definitions | Data engineering |
| Guide | Lines | Description |
|---|---|---|
| usage.md | 500+ | Complete usage guide with examples |
| agents.md | 1,440 | Agent ecosystem guide (60 agents) |
| workflow.md | 1,638 | Workflow ecosystem guide (52 workflows) |
| rules.md | 1,792 | Rules ecosystem guide (64 rules) |
| prompt.md | 2,050 | Prompt ecosystem guide (200 prompts) |
| goal.md | 786 | Project goals and vision |
| purpose.md | 1,086 | Project mission and values |
| workflow-agentic.md | 1,549 | Agentic workflow patterns |
| workflow-loop.md | 1,741 | Workflow loop patterns |
| workflow-patterns.md | 866 | Workflow patterns |
| workflow-orchestration.md | 847 | Orchestration guide |
| workflow-testing.md | 898 | Testing workflows |
| workflow-deployment.md | 939 | Deployment guide |
| workflow-security.md | 986 | Security guide |
| workflow-performance.md | 1,114 | Performance guide |
| Document | Description |
|---|---|
| Architecture | System architecture overview |
| Best Practices | Workflow design patterns |
| Contributing | Contribution guidelines |
| API Reference | Script API documentation |
| Workflow Guide | Workflow creation guide |
| Agent Guide | Agent creation guide |
| Rules Guide | Rules authoring guide |
| Prompt Guide | Prompt engineering guide |
| Troubleshooting | Debugging and recovery |
| Examples | Real-world use cases |
We welcome contributions! Please see CONTRIBUTING.md for guidelines.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-workflow) - Add your workflow/rule/prompt/agent
- Run validation scripts (
./scripts/validate-all.sh) - Submit a PR with clear description
- Workflows: New automation pipelines
- Rules: Domain-specific guidelines
- Prompts: Specialized prompt templates
- Agents: New agent definitions
- Templates: Reusable configuration templates
- Scripts: Tooling improvements
- Documentation: Guides and examples
This project is licensed under the MIT License — see LICENSE for details.
This project would not exist without the incredible work of the xAI team and the Grok engineering team. We deeply appreciate:
- The Grok Model — For its unique blend of intelligence, humor, and capability
- The Engineering Team — For building a system that enables this ecosystem
- The Visionaries — Who imagined an AI that's not just capable, but personable
Grok represents a new paradigm in AI assistance — one that combines technical excellence with authentic personality. This repository aims to amplify that vision by providing production-ready infrastructure for building Grok-powered applications.
- Awesome-Grok-Skills — The foundation of our agent ecosystem
- Contributors and maintainers of the tools we integrate with
- The broader AI/ML community for patterns and best practices
Built with for the Grok community. Let's build the future of AI orchestration together.
This repository is not affiliated with, endorsed by, or officially connected to xAI or the Grok team. It's an independent community project dedicated to maximizing Grok's potential in production environments.