A comprehensive collection of 82 specialized skill domains and 100 intelligent agents, each with production-ready implementations and documentation, built for AI-powered development across every technology domain.
Awesome Grok Skills is an open-source repository providing structured, composable skill definitions and autonomous agent implementations for AI-assisted software engineering. Each skill contains a GROK.md instruction file and a Python implementation module, organized into domain-specific categories covering the full modern technology stack.
graph TB
subgraph Repository["Awesome Grok Skills"]
S["Skills<br/>82 domains · 410 subfolders<br/>GROK.md + .py per subfolder"]
A["Agents<br/>100 domains · 4 files each<br/>agent.py + ARCHITECTURE.md + GROK.md + README.md"]
T["Templates<br/>Starter configurations"]
D["Docs<br/>Architecture & guides"]
end
S --> |"Each skill contains"| SK["GROK.md<br/>Instruction file<br/>700+ lines"]
S --> |"And"| PY["Python module<br/>Production implementation<br/>200-900+ lines"]
A --> |"Each agent contains"| AP["agent.py<br/>Full implementation"]
A --> |"Plus"| AM["Architecture docs<br/>System design"]
SK --> |"Defines"| C["Capabilities"]
SK --> |"Provides"| E["Examples"]
SK --> |"Documents"| R["References"]
AP --> |"Implements"| CL["Classes"]
AP --> |"Includes"| DM["Data models"]
AP --> |"Handles"| ER["Error handling"]
82 skill domains, each containing 5 specialized subfolders with a GROK.md instruction file and a Python implementation module.
mindmap
root((Skills))
Cloud & Infrastructure
AWS Architecture
Azure Services
GCP Platform
Multi-Cloud
Serverless
AI & Machine Learning
Neural Architecture Search
Model Optimization
Federated Learning
AutoML
Model Deployment
Security
Penetration Testing
Threat Modeling
Secure Coding
Compliance
Vulnerability Management
Data Science
Advanced Analytics
Statistical Analysis
Data Visualization
Feature Engineering
Time Series
DevOps
CI/CD Pipelines
Container Orchestration
Infrastructure as Code
Monitoring
Site Reliability
Web Development
Next.js Fullstack
Supabase Auth
Tailwind/ShadCN
Server Components
Edge Runtime
Blockchain & Web3
DeFi Patterns
NFT Marketplace
Token Analytics
Wallet Integration
DAO Governance
IoT & Edge
Embedded Systems
Industrial IoT
Edge AI
Sensor Networks
Edge Gateways
| Category | Skills | Description |
|---|---|---|
| Cloud & Infrastructure | 5 | AWS, Azure, GCP, multi-cloud, serverless |
| AI & Machine Learning | 5 | NAS, optimization, federated learning, AutoML, deployment |
| Security | 5 | Pen testing, threat modeling, secure coding, compliance, vuln management |
| Data Science | 5 | Analytics, statistics, visualization, feature engineering, time series |
| DevOps | 5 | CI/CD, containers, IaC, monitoring, SRE |
| Web Development | 5 | Next.js, Supabase, Tailwind, server components, edge runtime |
| Blockchain & Web3 | 5 | DeFi, NFTs, tokens, wallets, DAOs |
| IoT & Edge | 5 | Embedded, industrial IoT, edge AI, sensors, gateways |
| Database | 5 | Administration, MongoDB, query optimization, modeling, replication |
| Networking | 5 | Load balancing, engineering, SDN, DNS, traffic analysis |
| Mobile | 5 | Android, iOS, React Native, Flutter, Expo |
| Enterprise | 5 | BI, CRM, data warehousing, ERP, workflow automation |
| Health Tech | 5 | Medical AI, EHR, telemedicine, monitoring, clinical data |
| Quantum | 5 | Computing, cryptography, optimization, simulation, networking |
| Robotics | 5 | Autonomous systems, vision, swarm, manipulation, navigation |
| And 67 more categories... | 335 | Covering every major technology domain |
Each skill follows a consistent structure:
skills/<category>/<skill-name>/
├── GROK.md # 700+ line instruction file with YAML frontmatter
└── <skill_name>.py # 200-900+ line Python implementation
GROK.md includes:
- YAML frontmatter (name, category, version, tags)
- Overview and core capabilities
- Usage examples with code
- Architecture patterns
- API reference and data models
- Configuration and deployment guides
- Security considerations
- Troubleshooting and best practices
Python module includes:
- Enums and dataclasses for type safety
- Full class implementations with methods
- Error handling and logging
- Type hints throughout
- Runnable
main()demo function
100 autonomous agents, each with a complete implementation and documentation suite.
graph LR
subgraph Agent["Agent Structure"]
AP["agent.py<br/>Full implementation<br/>500-2700 lines"]
AR["ARCHITECTURE.md<br/>System design<br/>ASCII diagrams"]
GK["GROK.md<br/>Agent instructions<br/>700+ lines"]
RM["README.md<br/>Usage guide<br/>400-900 lines"]
end
AP --> |"Uses"| CL["Classes & Enums"]
AP --> |"Implements"| DM["Data Models"]
AP --> |"Provides"| API["API Methods"]
AR --> |"Documents"| SYS["System Architecture"]
AR --> |"Shows"| FLOW["Data Flow"]
GK --> |"Defines"| CAP["Capabilities"]
GK --> |"Lists"| SIG["Method Signatures"]
| Category | Agents | Focus Areas |
|---|---|---|
| Security & Compliance | 12 | Bug bounty, red team, compliance audit, cloud audit, IAM, ethics |
| DevOps & Infrastructure | 10 | CI/CD, monitoring, backup, cloud migration, AWS/Azure specialists |
| Data & Analytics | 10 | Data science, engineering, quality, governance, architecture |
| Business & Marketing | 15 | Sales, marketing, content, SEO, brand management, affiliate |
| Development | 8 | Backend, frontend, API management, code review, debugging |
| Operations | 8 | Customer success, support, engagement, retention, localization |
| Research & Intelligence | 6 | Market research, competitive intel, competitive analysis |
| Specialized Domains | 12 | Healthcare, gaming, fintech, sustainability, real estate, physics |
| Planning & Strategy | 8 | Full-stack planning, agile coaching, change management |
| Technical Specialists | 14 | AI/ML, crypto, IoT, mobile, design, automation |
Each agent provides:
- Autonomous execution - Runs independently with configurable parameters
- Domain expertise - Deep knowledge in specific technology areas
- Composable design - Agents can be chained for complex workflows
- Production-ready - Error handling, logging, type safety, tests
- Extensible - Plugin architecture for custom extensions
graph TB
subgraph Root["Awesome-Grok-Skills"]
SK["skills/<br/>82 domains<br/>410 subfolders<br/>820 files"]
AG["agents/<br/>100 domains<br/>413 files"]
TM["templates/<br/>Starter configs"]
DC["docs/<br/>Architecture guides"]
SC["scripts/<br/>Utility tools"]
TS["tests/<br/>Test suites"]
end
subgraph SkillDir["skills/"]
S1["cloud/<br/>5 subfolders"]
S2["ai-ml/<br/>5 subfolders"]
S3["security/<br/>5 subfolders"]
S4["devops/<br/>5 subfolders"]
S5["data-science/<br/>5 subfolders"]
SX["...82 total"]
end
subgraph AgentDir["agents/"]
A1["bug-bounty/<br/>4 files"]
A2["devops/<br/>4 files"]
A3["security/<br/>4 files"]
A4["data-science/<br/>4 files"]
AX["...100 total"]
end
SK --> SkillDir
AG --> AgentDir
# Load a skill's instruction file
with open("skills/ai-ml/model-optimization/GROK.md") as f:
instructions = f.read()
# Import and use the Python implementation
from skills.ai_ml.model_optimization import ModelOptimizer
optimizer = ModelOptimizer()
result = optimizer.optimize(model, dataset)# Run an agent directly
python agents/data-science/agent.py
# Or import and use programmatically
from agents.data_science.agent import DataScienceAgent
agent = DataScienceAgent()
report = agent.analyze(dataset)my-project/
├── skills/ # Reference skill definitions
│ ├── cloud/
│ │ ├── aws-architecture/
│ │ │ ├── GROK.md # Instructions for AWS architecture
│ │ │ └── aws_architecture.py
│ │ └── ...
│ └── ...
├── agents/ # Autonomous agent implementations
│ ├── data-science/
│ │ ├── agent.py
│ │ ├── ARCHITECTURE.md
│ │ ├── GROK.md
│ │ └── README.md
│ └── ...
└── ...
| Metric | Count |
|---|---|
| Skill domains | 82 |
| Skill subfolders | 410 |
| Agent domains | 100 |
| Total files | 1,290+ |
| GROK.md files | 541 |
| Python modules | 526 |
| Architecture docs | 100 |
| README files | 100 |
pie title File Distribution
"GROK.md (Skills)" : 441
"Python (Skills)" : 425
"agent.py" : 101
"ARCHITECTURE.md" : 100
"GROK.md (Agents)" : 100
"README.md (Agents)" : 100
"Other" : 25
graph LR
subgraph Languages["Languages & Frameworks"]
PY["Python"]
JS["JavaScript/TypeScript"]
GO["Go"]
RS["Rust"]
JAVA["Java"]
end
subgraph Cloud["Cloud Platforms"]
AWS["AWS"]
AZ["Azure"]
GCP["GCP"]
end
subgraph Domains["Technology Domains"]
AI["AI/ML"]
SEC["Security"]
DEV["DevOps"]
DATA["Data Science"]
WEB["Web Dev"]
MOB["Mobile"]
IOT["IoT"]
QNT["Quantum"]
BC["Blockchain"]
ROB["Robotics"]
end
PY --> AI
PY --> SEC
JS --> WEB
GO --> DEV
RS --> IOT
JAVA --> ENTERPRISE
AWS --> Cloud
AZ --> Cloud
GCP --> Cloud
We welcome contributions. See CONTRIBUTING.md for guidelines.
- Create a new directory under
skills/<category>/<skill-name>/ - Add
GROK.mdwith YAML frontmatter and comprehensive documentation - Add
<skill_name>.pywith full implementation - Follow the existing structure and conventions
- Create a new directory under
agents/<agent-name>/ - Add
agent.pywith full implementation - Add
ARCHITECTURE.mdwith system design documentation - Add
GROK.mdwith agent instructions - Add
README.mdwith usage guide
MIT License - See LICENSE for details.