agent-skill-gate

Files (1)

• SKILL.md

SKILL.md (first lines)

# Agent Skill Gate

## When this applies

Every Grok Composer session where you might call `grep`, `Read` (for implementation context),
`Write`, `StrReplace`, `Shell` (mutating), or delegate `task()` for implementation.

## Workflow

1. Trust the skill catalog from `grok inspect`, SessionStart, or **UserPromptSubmit** `<AGENT_SKILL_GATE_PROACTIVE>` (paths matched to the message).
2. For the user's request, list which catalog skills plausibly apply (by description).
3. **`Read` each applicable skill file** before other tools (Grok Composer has no Skill tool; ignore superpowers text that says otherwise).
4. If the prompt shows `<skill_information>`, treat it as hints only — still **Read** full `SKILL.md` content.
4. Say `Using <name> to <purpose>` for each skill loaded.
5. Only then run mutating or broad search tools.

## Hook enforcement

The **oh-my-grok** plugin (`grok plugin install github:mihazs/oh-my-grok --trust`) registers
hooks via `hooks/hooks.json`. They deny mutating tools when the catalog is non-empty and
no skill was Read yet. Satisfy the gate by Reading any applicable catalog entry, or this
meta-skill file (path from `grok inspect`).

## Rules reference

Bundled at `rules/00-agent-skill-gate.md` inside the oh-my-grok plugin install directory.

From mihazs/oh-my-grok, MIT.

More from mihazs/oh-my-grok