thumbgate-protect

Solid

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.

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 Protect Inspect the protected-action posture for this project and, when the user explicitly approves, grant a scoped, expiring exception so a protected-file edit or publish can proceed under audit. This skill wraps existing ThumbGate capability and adds **no new logic** — it reads governance state and records a time-boxed approval. ## Workflow 1. **Read the posture** with the `get_branch_governance` MCP tool: protected branches, release rules, and the protected-file globs in effect. 2. **Report it plainly:** what is protected, and what the agent is currently blocked from touching without approval. 3. **Only if the user explicitly asks to proceed,** grant a scoped approval with the `approve_protected_action` MCP tool — keep `pathGlobs` to the smallest set the action needs and `ttlMs` as short as the task requires (default ~1 hour). 4. **Confirm** the approval id, covered globs, and expiry. Approvals are temporary and audited; re-run for the next task. The full `approve_protected_action` field contract (`pathGlobs`, `reason`, `evidence`, `ttlMs`) and the audit model are in [references/governance-and-approvals.md](references/governance-and-approvals.md). ## Example Input: "main is protected but I need to hotfix the changelog — approve it for this one edit" Action: 1. `get_branch_governance` → confirm `main` is protected and `CHANGELOG.md` is in a protected glob. 2. `approve_protected_action` → `pathGlobs: ["CHANGELOG.md"]`, `reason: "hotfix cha...

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-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-guard

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).

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