feat(integrations): add Grok Build skills-based integration#3535
Open
natechadwick wants to merge 1 commit into
Open
feat(integrations): add Grok Build skills-based integration#3535natechadwick wants to merge 1 commit into
natechadwick wants to merge 1 commit into
Conversation
Add first-class support for xAI Grok Build via SkillsIntegration, installing speckit skills under .grok/skills and wiring init/invocation/catalog surfaces. Assisted-by: Grok Build (model: grok-4, supervised)
Contributor
There was a problem hiding this comment.
Pull request overview
Adds first-class Grok Build support as a skills-based integration.
Changes:
- Registers Grok and scaffolds skills under
.grok/skills. - Adds invocation guidance, context defaults, catalog metadata, and documentation.
- Adds integration, configuration-consistency, and hook-invocation tests.
Show a summary per file
| File | Description |
|---|---|
src/specify_cli/integrations/grok/__init__.py |
Defines the Grok integration. |
src/specify_cli/integrations/__init__.py |
Registers Grok. |
src/specify_cli/commands/init.py |
Adds Grok next-step guidance. |
src/specify_cli/_invocation_style.py |
Enables hyphenated skill invocations. |
integrations/catalog.json |
Adds catalog metadata. |
extensions/agent-context/agent-context-defaults.json |
Maps Grok to AGENTS.md. |
docs/reference/integrations.md |
Documents Grok support. |
.gitignore |
Ignores local Grok scaffolding. |
.github/ISSUE_TEMPLATE/agent_request.yml |
Updates supported agents. |
.github/ISSUE_TEMPLATE/bug_report.yml |
Adds Grok to the dropdown. |
.github/ISSUE_TEMPLATE/feature_request.yml |
Adds Grok to the dropdown. |
tests/integrations/test_integration_grok.py |
Tests Grok setup and CLI arguments. |
tests/integrations/test_integration_zed.py |
Tests Grok invocation formatting. |
tests/test_agent_config_consistency.py |
Synchronizes expected agent keys. |
Review details
Tip
Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- Files reviewed: 13/14 changed files
- Comments generated: 2
- Review effort level: Medium
Comment on lines
+738
to
+740
| if grok_skill_mode: | ||
| steps_lines.append( | ||
| f"{step_num}. Start Grok Build in this project directory; spec-kit skills were installed to [cyan].grok/skills[/cyan]" |
| | `cursor-agent` | `.cursor/skills`, `.cursor/rules/specify-rules.mdc` | | ||
| | `firebender` | `.firebender/commands`, `.firebender/rules/specify-rules.mdc` | | ||
| | `gemini` | `.gemini/commands`, `GEMINI.md` | | ||
| | `grok` | `.grok/skills` | |
Collaborator
|
Please address Copilot feedback |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds first-class xAI Grok Build support as a built-in Spec Kit integration.
GrokIntegration(SkillsIntegration) installs skills to.grok/skills/speckit-<command>/SKILL.mdintegrations/catalog.json)/speckit-<command>grok→AGENTS.mdAGENT_CONFIG.grok/in repo root for local dogfooding (same pattern as other agent folders)Usage:
specify init my-project --integration grok # or specify init --here --integration grokSkills install under
.grok/skills/and are invoked as/speckit-specify,/speckit-plan, etc.AI disclosure
This PR was developed with Grok Build assistance under human supervision (design review, test selection, and verification by @natechadwick). Code generation, tests, docs wiring, and PR packaging were agent-assisted; changes were reviewed and smoke-tested locally before submission.
Test plan
Automated
.venv/bin/python -m pytest tests/integrations/test_integration_grok.py tests/test_agent_config_consistency.py tests/integrations/test_integration_zed.py -q→ 106 passed, 2 skippedspecify init /tmp/speckit-grok-smoke --integration grok --ignore-agent-tools --script sh→ creates all core skills under.grok/skills//speckit-planinvocation style +build_exec_args(grok -p … --model … --output-format json)Manual test results
Agent: Grok Build | OS/Shell: Linux/bash
specify init … --integration grok.grok/skills, next-steps list skills as/speckit-*speckit-specify/speckit-planSKILL.md present without__CONTEXT_FILE__Test selection reasoning
src/specify_cli/integrations/grok/*src/specify_cli/integrations/__init__.pysrc/specify_cli/_invocation_style.pysrc/specify_cli/commands/init.pyRequired tests
specify init --integration grok— scaffolding + skills layouttest_integration_grok.py+ agent config consistencyFull interactive
/speckit-specify→ plan → tasks workflow in a greenfield project can be run by reviewers with Grok Build installed; CLI scaffolding and skill content generation are covered above.