Skip to content

hashgraph-online/awesome-grok-plugins

Repository files navigation


Awesome

Awesome Grok Plugins

A curated list of plugins, skills, and resources for xAI's Grok Build CLI.

PRs Welcome License Browse Registry

Grok Build is xAI's terminal-first coding agent. Plugins bundle skills, slash commands, subagents, MCP servers, hooks, and LSP servers into installable packages. This list curates the best community-built plugins for the Grok ecosystem.


Contents


Start Here

Installing Grok Build

# macOS / Linux / WSL
curl -fsSL https://x.ai/cli/install.sh | bash

# Windows PowerShell
irm https://x.ai/cli/install.ps1 | iex

Using Plugins

# Add the official xAI marketplace
grok plugin marketplace add xai-org/plugin-marketplace

# Browse available plugins
grok plugin list

# Install a plugin
grok plugin install <plugin-name> --trust

# Add a community marketplace (this repo)
grok plugin marketplace add hashgraph-online/awesome-grok-plugins

Inside Grok Build, type /marketplace to browse and install plugins interactively. You can also use /plugins, /skills, /hooks, or /mcps to manage installed components.

Plugin discovery paths: Grok Build loads plugins from ./.grok/plugins/, ~/.grok/plugins/, marketplace installs under ~/.grok/plugins/marketplaces/, and custom paths via --plugin-dir <PATH>. MCP servers can also be configured in ~/.grok/config.toml under [mcp_servers].

Grok API + MCP: The xAI API natively supports Remote MCP Tools via the tools parameter: {"type": "mcp", "server_url": "...", "server_label": "..."}. See xAI Remote MCP docs.

Plugin Scanner (Recommended)

Validate plugins before submission with the HOL AI Plugin Scanner:

Requirement Threshold
Score ≥ 80 / 130
Severity No critical or high findings
CI Scanner must run in your repo's GitHub Actions

See the full guide: SCANNER_GUIDE.md See contributing requirements: CONTRIBUTING.md

How This List Works

You add a single line to README.md. That's it. A maintainer-verified generator mirrors your plugin from its source repo and regenerates the catalog files (plugins.json, marketplace.json). You never need to copy plugin files into this repo yourself.

Your PR:  README.md (+1 line)
Generator (CI):  plugins/<owner>/<repo>/  ←  fetched from your GitHub repo
                  plugins.json            ←  regenerated from README
                  marketplace.json        ←  regenerated from README

Official Plugins

The official xAI plugin marketplace lives at xai-org/plugin-marketplace. First-party and vetted third-party plugins include:

Official xAI Marketplace Plugins
Plugin Category Description
Vercel deployment Deploy and manage Vercel frontend infrastructure
Sentry monitoring Error monitoring, stack traces, production debugging
Chrome DevTools development Control and inspect a live Chrome browser
Cloudflare development Workers, Durable Objects, Agents SDK, Wrangler CLI
Superpowers development Core skills library: TDD, systematic debugging, workflows
MongoDB database MCP Server + Skills for MongoDB databases
Axiom observability Log/metric queries with APL, SRE investigations
Neon database Serverless Postgres with branching and migrations

Community Plugins

Development & Workflow

  • HOL Guard - Security plugin for protecting Grok Build with HOL Guard: harness protection, approval broker, and plugin scanner integration.

Tools & Integrations


Plugin Development

What a Plugin Is

A plugin is a directory bundling any combination of components:

Component Location Purpose
Skills skills/ SKILL.md capability definitions
Commands commands/ Slash command definitions
Agents agents/ Subagent definitions
Hooks hooks/hooks.json Lifecycle hooks (PreToolUse, PostToolUse)
MCP servers .mcp.json Model Context Protocol server configs
LSP servers .lsp.json Language server configs
Manifest .grok-plugin/plugin.json Optional metadata and path overrides

Plugin Structure

your-plugin-repo/
  .grok-plugin/
    plugin.json              # Optional manifest (metadata, path overrides)
    marketplace.json         # Self-contained marketplace (for standalone install)
  .mcp.json                  # MCP server configs
  .lsp.json                  # LSP server configs (optional)
  assets/
    icon.svg                 # Plugin icon
  skills/
    my-skill/
      SKILL.md               # Skill definition
  commands/
    my-command.md            # Slash command definition
  agents/
    my-agent.md              # Subagent definition
  hooks/
    hooks.json               # Lifecycle hooks
  README.md
  LICENSE

plugin.json Manifest

The manifest at .grok-plugin/plugin.json is optional but recommended for metadata:

{
  "name": "my-plugin",
  "version": "1.0.0",
  "description": "What this plugin does",
  "author": {
    "name": "Your Name",
    "url": "https://github.com/your-org"
  },
  "homepage": "https://github.com/your-org/my-plugin",
  "repository": "https://github.com/your-org/my-plugin",
  "license": "MIT",
  "keywords": ["my-plugin", "specific-terms"],
  "skills": "./skills/",
  "commands": "./commands/",
  "mcpServers": "./.mcp.json",
  "hooks": "./hooks/hooks.json"
}

Grok Build also accepts .claude-plugin/plugin.json for Claude-ecosystem compatibility.

Creating a Plugin

  1. Set up the directory structure above in your GitHub repo
  2. Add a scanner workflow to your repo (see CONTRIBUTING.md)
  3. Test locally with grok plugin link . then grok inspect
  4. Run the scanner and ensure score ≥ 80
  5. Add your entry to this repo's README.md (alphabetical order)
  6. Open a PR with your scanner score and plugin URL

Publishing to the Official xAI Marketplace

For inclusion in the official xai-org/plugin-marketplace:

  1. Fork xai-org/plugin-marketplace
  2. Add an entry to .grok-plugin/marketplace.json with a SHA-pinned remote source
  3. Regenerate the component index: python3 scripts/generate-plugin-index.py
  4. Validate: python3 scripts/validate-catalog.py
  5. Open a PR

Guides & Articles


Related Projects


Contributing

Contributions are welcome! Please read the CONTRIBUTING.md guide before submitting a PR.

Key requirements:

  • Scanner score ≥ 80/130 with no critical/high findings
  • Scanner CI running in your plugin repo
  • Valid plugin structure (.grok-plugin/plugin.json or .claude-plugin/plugin.json)
  • Alphabetical order in README sections

License

Apache License 2.0

About

A curated list of awesome xAI Grok plugins, skills, and resources.

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages