feat(integrations): add Grok Build skills-based integration#3535
Merged
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
Collaborator
|
Please address Copilot feedback |
Assert init next-steps guidance for Grok (.grok/skills, /speckit-*) and clarify that multi-install safety is path/manifest isolation, not agent-context defaults such as shared AGENTS.md.
Contributor
Author
|
Addressed Copilot feedback in
I don’t have permission to mark the threads Resolved on this repo; a maintainer can resolve them after review if the replies look good. Thanks @mnriem. |
Collaborator
|
Please address Copilot feedback. If not applicable, please explain why |
Document Grok multi-install isolation as .grok/skills and .grok/rules. Override build_exec_args to pass --always-approve so non-interactive dispatch is not blocked at tool permission gates.
Collaborator
|
Please address Copilot feedback. Hopefully just one more review after this so we can merge it. Keep up the good job! |
Multi-install isolation documents Spec Kit-managed paths; Grok only writes .grok/skills, so drop the read-only .grok/rules entry.
Move grok to ALWAYS_SLASH_AGENTS so hooks never emit /speckit.plan when ai_skills is missing/false. Update slash-format tests, persist ai_skills on init, and bump catalog updated_at for the Grok entry.
Collaborator
|
Thank you! |
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.