Language: English · Polski

grok-best-practice

from vibe coding to agentic engineering on Grok Build

A living course and ecosystem map for xAI’s terminal coding agent. Skills, plugins, hooks, AGENTS.md, grok inspect, Plan Mode, headless, ACP.

Independent community playbook. Not affiliated with xAI. Grok Build ≠ Grok Bot ≠ grok.com chat.

If you are new

A skill is a short instruction the agent opens when the job matches. You install packs (npx skills add …). You do not copy hundreds of folders into git.

• All human docs: docs/
• Plain map (English): docs/when-to-use.md · recipes · help
• Po polsku: docs/kiedy-czego-uzyc.md · przepisy · gdy nie gra
• Full pack list (Grok + other agents): catalog/library.md

First message in the TUI: Use inspect-and-ship. Do not edit yet. Then one specialist: design · marketing · higgsfield · notion.

How to use

curl -fsSL https://x.ai/cli/install.sh | bash   # macOS / Linux
# irm https://x.ai/cli/install.ps1 | iex        # Windows PowerShell

cd your-project
grok inspect
grok plugin install superpowers@xai-official --trust
# daily packs: design, marketing, Higgsfield, Notion — see catalog/loadout.md
grok

In the TUI: Use inspect-and-ship. Do not edit yet.

Read this repo as a course. Install packs, not 292 files. Spawn one specialist: design · marketing · higgsfield · notion.

Daily loadout

Copy-paste daily set: catalog/loadout.md · examples/loadout.md. Bigger map: catalog/library.md.

Job	Pack	Install
UI polish	impeccable	npx skills add pbakaus/impeccable
UI intelligence	ui-ux-pro-max	npx skills add nextlevelbuilder/ui-ux-pro-max-skill
Marketing	marketingskills	npx skills add coreyhaines31/marketingskills
Image / video / ads	higgsfield-ai/skills	npx skills add higgsfield-ai/skills
Notion library	Skills API	npx skills add notion

Notion MCP (https://mcp.notion.com/mcp) plus npx skills add notion is the intended loop: write the skill in Notion, run it in Grok.

Agents in this repo: design · marketing · higgsfield · notion.

Do not install the full Meng To or TypeUI 67-skill trees unless you named one style.

Contents

• If you are new
• Daily loadout
• Human docs
• When to use what
• Recipes
• Help
• Skill library
• Concepts
• skills/ (canonical SKILL.md)
• Routing eval
• Grok Build vs Claude Code vs Cursor
• Workflows
• Community
• Caveats
• Tips
• Contributing

Concepts

Feature	Location	Notes
Instructions	AGENTS.md	Harness-agnostic. CLAUDE.md is an alias.
Skills	skills/<name>/SKILL.md	Thin links in .grok/skills, .claude/skills, .agents/skills. skills/
Plugins	/marketplace, grok plugin install …	best-practice/grok-plugins.md
Hooks	.grok/hooks/, /hooks-trust	Fail-open. best-practice/grok-hooks.md
Ignore	.grokignore	Plus gitignore-skipped instruction files.
Inspect	grok inspect / --json	best-practice/grok-inspect.md
Plan Mode	/plan, Shift+Tab	File-edit gate. Bash is not blocked. plan
Subagents	.grok/agents/	design marketing higgsfield notion. agents
Headless	grok -p	best-practice/grok-headless.md
ACP	grok agent stdio	IDE / web UIs attach here.
Imagine	/imagine, /imagine-video	Pictures. Production video/ads → Higgsfield.
Memory	/memory, /flush	GA as of CLI 1.0.34.
Demo skills	inspect-and-ship, loadout	First session, then packs.

Grok Build vs Claude Code vs Cursor

Checked 2026-09-17 against docs.x.ai/build and public repos. Not a dunk table.

	Grok Build	Claude Code	Cursor
Form	Rust TUI, open harness	Closed CLI	IDE + agents
Model	grok-4.6 + BYO	Anthropic-first	Mixed; Grok Bot is a different product
Skills	SKILL.md; allowed-tools does not restrict tools	SKILL.md; allowed-tools enforced	Rules / plugins
Plan	Edit-gate on the plan file; bash/subagents leak	Plan + permissions	Agent in the editor
Inspect	grok inspect	No dump	Settings UI
IDE	ACP first-class	Own protocol	Native
Unique	Inspect, ACP, imagine, X search, BYO	Marketplace size, eval culture	Editor UX, Grok Bot VMs
This repo	Yes	Pointers	Pointers; Bot ≠ Build

Do not say “drop-in Claude.” Grok will read .claude/skills. It will not copy Claude’s security model.

Workflows

Peer playbooks, live star badges. Grok-shaped install when it exists.

See the full table: catalog/workflows.md.

Playbook	★	On Grok
Superpowers		grok plugin install superpowers@xai-official --trust
Matt Pocock Skills		npx skills add mattpocock/skills then grok inspect
Addy Osmani agent-skills		npx skills add addyosmani/agent-skills
Spec Kit		uv tool install specify-cli
anthropics/skills		Compat loader
xai-org/grok-build		Official CLI
higgsfield-ai/skills		npx skills add higgsfield-ai/skills
marketingskills		npx skills add coreyhaines31/marketingskills
impeccable		npx skills add pbakaus/impeccable
remotion-dev/skills		npx skills add remotion-dev/skills

Community

Only entries that talk to official grok. Full list: catalog/community.md.

• xai-org/grok-build — harness.
• DominikTobureto/awesome-grok-build — starter kit (last push 2026-08-23; credit it, CLI has moved).
• xintaofei/codeg — GUI over ACP.
• farion1231/cc-switch — multi-CLI switcher.
• kenryu42/cc-safety-net — PreToolUse guard.
• superagent-ai/grok-cli — unofficial API agent. Different binary.

Grok Bot lives in ZeroPointRepo/awesome-grok-bot. Different product.

Caveats

1. allowed-tools in SKILL.md is not a security boundary.
2. Plan Mode does not block bash.
3. Hooks fail-open (crash → tool still runs).
4. Skill model / effort fields are ignored.
5. Official harness does not take public PRs. Use /feedback.
6. LifeJiggy-style YAML/GROK.md dumps do not load. Grok workflows are .rhai.

Tips

Sourced. Not “pro tips”.

1. grok inspect before you debug a missing skill. (inspect)
2. Trust project hooks with /hooks-trust, not by hoping SKILL.md will sandbox you. (hooks)
3. Install Superpowers from the xAI marketplace, then inspect again. (plugins)
4. Headless CI: grok -p + --no-auto-update. Do not put keys on the argv. (headless)
5. One playbook per week. Daily packs: loadout. ECC’s 292 skills are a catalog, not a loadout.
6. Exact on-screen text belongs in HTML/code, not /imagine. Native imagine is for pictures.
7. Polish readers: README.pl.md — same sections, not a shorter copy. Product names stay English.
8. Routing eval (10 prompts): examples/eval-routing.md.
9. When to use what: docs/when-to-use.md. Library: catalog/library.md.

Contributing

CONTRIBUTING.md. New rows must be Grok Build, sourced, no invented stars.

License

List and docs: CC BY 4.0. Unofficial.

If this saved you a setup day, star the repo. That is the only ranking signal we ask for.