thumbgate-doctor

Solid

Health-check whether ThumbGate is actually wired into this agent — PreToolUse/SessionStart hooks installed, MCP server reachable, lesson store present, statusline, and overall agent-readiness — then report exactly what to fix. Runs the existing `npx thumbgate doctor` audit and the check_operational_integrity MCP tool. Use when the user says "is ThumbGate wired up", "thumbgate doctor", "check my guardrails are installed", "why aren't my gates firing", "is the MCP server connected", or "agent readiness". Do NOT use to view rules (use the thumbgate-rules skill), to view what was blocked (use the thumbgate-blocked skill), or to capture a new rule (use the thumbgate-guard skill) — this skill only diagnoses setup and wiring.

AI & Automation 24 stars 7 forks Updated today MIT

Install

View on GitHub

Quality Score: 78/100

Stars 20%
47
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# ThumbGate Doctor Audit whether ThumbGate is actually wired into this agent — PreToolUse / SessionStart hooks installed, MCP server reachable, lesson store present, statusline, overall agent-readiness — then tell the user exactly what to fix. This skill wraps existing ThumbGate capability and adds **no new logic** — it runs the existing doctor + integrity checks. ## Workflow 1. **Run the wiring/health audit:** ```bash npx thumbgate doctor ``` (Add `--json` for a machine-readable report.) It exits non-zero when the project is not `ready`. 2. **Verify the runtime path** with the `check_operational_integrity` MCP tool — this confirms the server-side enforcement path is live, not just the local config. 3. **Summarize:** ✅ what's wired (hooks, MCP, store, statusline) and ❌ what's missing, each with its exact fix command (usually `npx thumbgate init`). 4. **Lead with the fix.** If everything is green, say so plainly with the readiness status; if not, lead with the single highest-impact fix. The full readiness checklist (each check, what a failure means, and its fix) is in [references/wiring-checklist.md](references/wiring-checklist.md). ## Example Input: "why aren't my gates firing? is ThumbGate even wired up?" Action: run `npx thumbgate doctor`, then `check_operational_integrity`, then: > ❌ PreToolUse hook not installed — run `npx thumbgate init`. ✅ MCP server reachable. > ✅ Lesson store present. Fix the hook and your promoted rules will start blocki...

Details

Author
IgorGanapolsky
Repository
IgorGanapolsky/ThumbGate
Created
4 months ago
Last Updated
today
Language
JavaScript
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

thumbgate

ThumbGate provides pre-action gates for AI coding agents. It captures thumbs-up/down feedback on agent actions, auto-promotes repeated failures into prevention rules, and blocks known-bad tool calls via PreToolUse hooks. Trigger when the user wants to add safety guardrails to an AI agent workflow, capture structured feedback on agent output, generate prevention rules from failure patterns, gate high-risk actions before execution, or export DPO training pairs from production feedback. Works with any MCP-compatible agent including Cursor, Codex, Gemini CLI, Amp, and OpenCode.

24 Updated today
IgorGanapolsky
AI & Automation Solid

thumbgate-rules

List the active ThumbGate prevention rules, reliability rules, and the promoted lessons behind them, so the user can see which guardrails are currently protecting this project and WHY each one exists. Reads the live rule and lesson stores via the prevention_rules, get_reliability_rules, and search_lessons MCP tools (CLI fallback `npx thumbgate rules`). Use when the user says "what is ThumbGate protecting me from", "show my rules", "show my gates", "what has the agent learned", "list active guardrails", or "what's blocked here". Do NOT use to CREATE a new rule (use the thumbgate-guard skill), to see runtime enforcement counts of what actually fired (use the thumbgate-blocked skill), or to diagnose whether ThumbGate is wired up at all (use the thumbgate-doctor skill).

24 Updated today
IgorGanapolsky
AI & Automation Solid

thumbgate-blocked

Show ThumbGate's enforcement record — how many risky actions were actually blocked versus warned, which gates fire most, the tokens/damage saved, and the full feedback to check to rejection pipeline. Reads live enforcement counters via the gate_stats and enforcement_matrix MCP tools (CLI fallback `npx thumbgate gate-stats`). Use when the user says "what has ThumbGate blocked", "show gate stats", "is enforcement working", "how many tokens did we save", "show the enforcement matrix", or "what got stopped". Do NOT use to list rule DEFINITIONS that exist (use the thumbgate-rules skill), to create a new rule (use the thumbgate-guard skill), or to check whether ThumbGate is installed and wired (use the thumbgate-doctor skill).

24 Updated today
IgorGanapolsky