toolguard-maintenance

Curate toolguard permission rules through guided review, consolidation, and consent-gated application.

Updated May 3, 2017
One-click install
npx skills add https://github.com/arnonmoscona/dot_files --skill toolguard-maintenance-arnonmoscona
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: toolguard-maintenance
Source: https://github.com/arnonmoscona/dot_files/tree/main/wsl/.claude/skills/toolguard-maintenance
Command: npx skills add https://github.com/arnonmoscona/dot_files --skill toolguard-maintenance-arnonmoscona

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Toolguard and Claude Code permission configurations grow over time into redundant, mis-levelled, and confusing rule sets that are hard to audit and risky to clean up by hand. This Skill turns that cleanup into a guided, evidence-backed review where nothing is ever applied without explicit per-item consent. ## Core Features & Use Cases - Analyzer-driven evidence gathering: Runs the deterministic toolguard-maintain and toolguard-audit analyzers to find redundancies, consolidation candidates, broadenings, and cross-layer interactions, then reasons over the JSON findings in structured passes. - Family-grouped proposals with certification: Groups every rule into command families, targets the right config level for each change, blocks cross-level welds, renders paste-ready TOML, and certifies it via staged audits and corpus replay before any write. - Consent-gated application with decision memory: Applies only user-approved changes via --apply --write or guided self-edit, and records decisions in-file (# toolguard: annotations) and in a sidecar ledger so periodic runs stay quiet. - Use Case: Before pushing, ask for a periodic maintenance checkpoint on your project; the Skill surfaces only new or changed permission rules, proposes safe consolidations, and applies just the ones you approve. ## Quick Start Ask the assistant to clean up and consolidate the toolguard permission rules for the current project, reviewing each proposed change before anything is applied.

Frequently Asked Questions about toolguard-maintenance

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I clean up redundant toolguard permission rules?

Invoke the maintenance skill on your project directory; it runs toolguard-maintain to find redundancies and consolidation candidates, groups rules by command family, and presents each proposed change for your explicit approval before applying anything.

Does toolguard maintenance apply changes automatically?

No. Nothing is ever applied automatically, even replay-verified consolidations. Every change requires explicit per-item consent, and bulk-apply exists only as an explicit user opt-in, never a default.

What is the difference between toolguard-maintain and toolguard-audit?

toolguard-audit flags security risk in the config and is read-only, while toolguard-maintain finds clarity, redundancy, and level problems and can enact approved changes. The maintenance skill certifies proposals with the audit before any write.

Can I promote permission rules from project to user level?

Yes. The skill proposes promotions as first-class moves, certifies them with a two-level staged audit using a redirected HOME, and hand-applies them as a two-file edit. Denies are promoted eagerly; allows cautiously due to cross-context broadening.

Why does a periodic maintenance run stay quiet about old questions?

Periodic runs read prior decisions from in-file # toolguard: annotations and the sidecar decision ledger, so already-settled questions are not re-litigated. Only new or changed families and material audit findings are surfaced.

What happens if toolguard-maintain is not found on my machine?

The skill tells you the global install is missing or outdated and suggests running uv tool install toolguard or uv tool upgrade toolguard. It does not improvise alternate invocation forms outside the toolguard source repo.