igorganapolsky/thumbgate
skills/thumbgate/SKILL.md
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.
$ install --global
skillsauthnpx skillsauth add igorganapolsky/mcp-memory-gateway thumbgateInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 22, 2026, 7:21 AM124.0s1 file scanned
SKILL.md
- name:
- thumbgate
- description:
- >
ThumbGate
Pre-action gates that stop AI coding agents from repeating known mistakes.
Quick Start
npx thumbgate init
This installs the MCP server and wires it into your agent's tool configuration. No API keys required for the free tier.
Or install globally:
npm install -g thumbgate
thumbgate init
MCP Configuration
Add to your agent's MCP config (e.g., claude_desktop_config.json or .cursor/mcp.json):
{
"mcpServers": {
"thumbgate": {
"command": "npx",
"args": ["-y", "thumbgate"]
}
}
}
How It Works
Feedback Capture
When an agent action succeeds or fails, capture structured feedback:
- Thumbs up: Records what worked, tags it, and stores it as a reusable pattern.
- Thumbs down: Records the failure context, what went wrong, and what to change. Repeated failures auto-promote into prevention rules.
Prevention Rules
After a failure pattern repeats (default: 2 occurrences), ThumbGate auto-generates a prevention rule. These rules are injected into agent context before every tool call, blocking the known-bad pattern before it executes.
Pre-Action Gates
Gates intercept tool calls via the MCP PreToolUse hook. Each gate checks the proposed action against:
- Prevention rules generated from past failures
- Thompson Sampling confidence scores (adaptive sensitivity)
- LanceDB vector similarity to known-bad patterns
If a match is found, the gate blocks execution and surfaces the prior failure context.
Context Packs
Bounded retrieval of relevant feedback history for the current task. The agent gets exactly the lessons that matter, not the entire history.
MCP Tools Provided
| Tool | Description |
|------|-------------|
| capture_feedback | Record thumbs-up/down with structured context |
| search_lessons | Query the lesson DB by keyword or semantic similarity |
| get_prevention_rules | Retrieve active prevention rules for the current context |
| session_primer | Get session handoff context (last task, next step, blockers) |
| export_dpo | Export feedback pairs in DPO training format |
Tiers
| | Free | Pro | Team | |---|---|---|---| | Feedback capture | 3/day | Unlimited | Unlimited | | Lesson search | 5/day | Unlimited | Unlimited | | Active gates | 5 | Unlimited | Unlimited | | Dashboard | - | Yes | Yes | | DPO export | - | Yes | Yes | | Seats | 1 | 1 | Per-seat | | Price | $0 | $19/mo | $49/seat/mo |
Start a 7-day free trial of Pro: https://thumbgate-production.up.railway.app/go/pro?utm_source=skill
Compatibility
ThumbGate works with any MCP-compatible agent:
- Cursor
- Codex
- Gemini CLI
- Amp
- OpenCode
- Any agent supporting the Model Context Protocol
Links
- NPM: thumbgate
- Repository: IgorGanapolsky/ThumbGate
- Dashboard: https://thumbgate-production.up.railway.app/dashboard
Related Skills
igorganapolsky/thumbgate-rules
tools
VerifiedTrustedCommunity
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).
23SKILL.mdUpdated Jun 12, 2026
igorganapolsky/thumbgate-protect
tools
VerifiedTrustedCommunity
Inspect this repo's branch and release governance (protected branches, release rules, protected-file globs) and, only when the user explicitly approves, grant a scoped, time-limited exception so a protected-file edit or publish can proceed under audit. Reads posture via the get_branch_governance MCP tool and records a narrow, expiring approval via the approve_protected_action MCP tool. Use when the user says "is main protected", "show branch governance", "what am I blocked from editing", "approve this protected change", or "let me edit a protected file just this once". Do NOT use to disable protection wholesale, to grant broad or standing exceptions, or to diagnose hook wiring (use the thumbgate-doctor skill) — this skill is for narrow, temporary, audited approvals only.
23SKILL.mdUpdated Jun 12, 2026
igorganapolsky/thumbgate-guard
tools
VerifiedTrustedCommunity
Turn the agent's most recent mistake into an enforced ThumbGate prevention rule (a PreToolUse block gate) so the same bad tool call is intercepted before it runs again, in this and every future session across Claude Code, Cursor, Codex, Gemini, Amp, and Cline. Captures the failure with the capture_feedback MCP tool, then force-promotes it via `npx thumbgate force-gate` so it is enforced, not just logged. Use when the user says "guard against this", "block this from happening again", "never do that again", "make that a rule", "stop the agent from repeating that", or right after a bad action or thumbs-down that should become a hard rule. Do NOT use to merely log a thumbs-up/down without enforcement (use the thumbgate-feedback skill), to recall prior context before starting work (use the Agent Memory skill), or to list rules that already exist (use the thumbgate-rules skill).
23SKILL.mdUpdated Jun 12, 2026
igorganapolsky/thumbgate-doctor
tools
VerifiedTrustedCommunity
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.
23SKILL.mdUpdated Jun 12, 2026