Skip to content

About

A comprehensive collection of skills and agents designed specifically for **Grok** - the AI with a personality that combines physics expertise, real-time data access, meme culture awareness, and coding efficiency. Each skill is optimized for Grok's unique strengths and communication style.

Resources

Code of conduct

Contributing

Stars

47 stars

Watchers

3 watching

Forks

Repository files navigation

Awesome Grok Skills

Awesome License: MIT Stars Skills Agents Files

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.


Overview

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"]
Loading

Skills

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
Loading

Skill Categories

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

Skill Structure

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

Agents

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"]
Loading

Agent Categories

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

Agent Capabilities

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

Repository Structure

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
Loading

Quick Start

Using Skills

# 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)

Using Agents

# 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)

Project Structure

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
│   └── ...
└── ...

Repository Statistics

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
Loading

Technology Coverage

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
Loading

Contributing

We welcome contributions. See CONTRIBUTING.md for guidelines.

Adding a Skill

  1. Create a new directory under skills/<category>/<skill-name>/
  2. Add GROK.md with YAML frontmatter and comprehensive documentation
  3. Add <skill_name>.py with full implementation
  4. Follow the existing structure and conventions

Adding an Agent

  1. Create a new directory under agents/<agent-name>/
  2. Add agent.py with full implementation
  3. Add ARCHITECTURE.md with system design documentation
  4. Add GROK.md with agent instructions
  5. Add README.md with usage guide

License

MIT License - See LICENSE for details.


Built with precision. Powered by open source.

Awesome

About

A comprehensive collection of skills and agents designed specifically for **Grok** - the AI with a personality that combines physics expertise, real-time data access, meme culture awareness, and coding efficiency. Each skill is optimized for Grok's unique strengths and communication style.

Resources

Code of conduct

Contributing

Stars

47 stars

Watchers

3 watching

Forks

Releases

Packages

Contributors

Languages