SMG Dev Guide
AI-powered development guide for the Shepherd Model Gateway — 4 process-enforcing skills that change what your AI coding agent does, not just what it knows.
Works with Google Antigravity, Gemini CLI, Claude Code, Codex, and Cursor.
Install
Google Antigravity
Project-level (Recommended): Antigravity natively supports the skills through its workflow system. Simply open this repository (or copy the .agents/ and skills/ directories into your SMG project root) in the Antigravity IDE and it will automatically discover them.
Global: To make these skills and workflows available across all projects, copy or symlink them into your global Antigravity ~/.gemini/antigravity/ directory:
git clone https://github.com/lightseekorg/smg-dev-guide.git ~/.gemini/antigravity/repos/smg-dev-guide
mkdir -p ~/.gemini/antigravity/workflows ~/.gemini/antigravity/skills
ln -s ~/.gemini/antigravity/repos/smg-dev-guide/.agents/workflows/* ~/.gemini/antigravity/workflows/
ln -s ~/.gemini/antigravity/repos/smg-dev-guide/skills/* ~/.gemini/antigravity/skills/
Gemini CLI
The Gemini CLI natively supports Agent Skills. You can install these skills directly from the repository using the CLI's built-in package manager.
Global Installation (Available in all projects):
gemini skills install https://github.com/lightseekorg/smg-dev-guide.git
Workspace Installation (Only in current project):
gemini skills install https://github.com/lightseekorg/smg-dev-guide.git --scope workspace
Claude Code
claude marketplace add lightseekorg/smg-dev-guide
Codex
Copy or symlink the skills into your user skills directory:
git clone https://github.com/lightseekorg/smg-dev-guide.git ~/.agents/repos/smg-dev-guide
ln -s ~/.agents/repos/smg-dev-guide/.agents/skills/* ~/.agents/skills/
Or clone into the SMG repo and skills are discovered automatically from .agents/skills/.
Cursor
Install as a Cursor plugin via .cursor-plugin/plugin.json.
Usage
4 skills, each enforcing a specific developer action:
| Skill | Action | What It Does |
|---|
map | Orient | Crate map, layering rules, config propagation, request flow, label pipeline |
implement | Build | Detects subsystem, loads recipe, creates tasks, enforces step-by-step execution with verification |
review-pr | Review | Maps changed files to checklist sections, creates review tasks per subsystem, cites file:line |
contribute | Ship | 5-step quality gate (fmt → clippy → test → bindings → commit format) with enforcement |
Google Antigravity — invoke workflows using slash commands in the chat:
/map → discover codebase structure and ownership
/implement-feature → guides you through building a feature
/review-pr → checks your work against anti-patterns
/verify-pr → runs the full 5-step quality gate
Gemini CLI — skills trigger automatically based on your prompt:
"Where does the label pipeline live?" → Activates map skill
"Am I ready to submit?" → Activates contribute skill
Note: You can view installed skills by running gemini skills list.
Claude Code — use the /smg command:
/smg where does the label pipeline live → smg:map
/smg add a --timeout flag → smg:implement
/smg review PR #562 → smg:review-pr
/smg am I ready to submit → smg:contribute
Codex — skills trigger automatically based on your prompt, or invoke explicitly via $smg-implement, $smg-contribute, etc.
How It Works
Unlike passive reference docs, these skills enforce workflows:
- Iron Laws prevent skipping critical steps (e.g. "NO PR WITHOUT PASSING ALL QUALITY GATES")
- Hard Gates block progression without prerequisites (e.g. must identify touched subsystems before reviewing)
- Rationalization Tables counter common excuses for cutting corners
- Skill Chaining ensures
implement → contribute → review-pr flow
- 15 Implementation Recipes provide step-by-step guidance with exact file paths, code patterns, and verification commands for every subsystem
Implementation Recipes
implement auto-detects what you're building and loads the right recipe:
