tool-permissions

Configure permission modes and rule-based confirmations for AI agent tool access.

Updated May 17, 2026
One-click install
npx skills add https://github.com/tiankong0101-byte/skills-registry --skill tool-permissions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tool-permissions
Source: https://github.com/tiankong0101-byte/skills-registry/tree/main/skills/tool-permissions
Command: npx skills add https://github.com/tiankong0101-byte/skills-registry --skill tool-permissions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams manage when an AI agent may use sensitive tools, reducing accidental writes, risky commands, and unsafe network access.

Core Features & Use Cases

  • Permission Modes: Switch between default prompting, read-only planning, trusted edit workflows, or fully sandboxed execution.
  • Rule-Based Access Control: Define allow, ask, deny, or accept-edit behaviors for specific tools, commands, and file paths.
  • Security Guardrails: Protect sensitive paths like environment files and keys while still allowing routine reads and safe operations.
  • Use Case: A developer can let the agent read code freely, auto-accept edits in source files, and require confirmation before deleting files or running shell commands.

Quick Start

Ask the AI to set up a permission policy for your workspace that allows safe reads, asks before shell commands, and protects secrets like .env files and key files.

Frequently Asked Questions about tool-permissions

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

FAQPage Schema
How do I control AI agent permissions for shell commands and file writes?

AI agent permissions are controlled by defining permission modes and rule-based confirmations for tool access. You can set allow, ask, deny, or accept-edit behaviors for specific shell commands, file paths, and edits to enforce workspace governance.

What's the best way to prevent an AI agent from modifying sensitive environment files?

The best way to protect sensitive environment files is by configuring security guardrails with deny rules for specific paths. This prevents accidental writes to files like .env and keys while still allowing the agent to perform routine reads and safe operations.

Can I set up read-only planning modes for an AI coding assistant?

Yes, you can switch between default prompting, read-only planning, trusted edit workflows, or fully sandboxed execution. These permission modes let you safely restrict the agent to reading code without executing risky commands or writing files.

How do I configure workflow governance to ask before running shell execution?

Workflow governance is configured by applying rule-based access control that matches tool categories and command conditions. You set the behavior to ask before shell execution, ensuring the agent requires explicit confirmation for potentially unsafe commands.

When should I use accept-edit rules instead of allow rules for source file modifications?

Accept-edit rules should be used when you want to auto-accept edits in source files without manual confirmation, while allow rules broadly permit tool access. Use accept-edit for trusted edit workflows and allow for routine safe reads.

Does command safety support ordered fallback behavior for tool access control?

Yes, command safety enforces ordered fallback behavior to determine allow, ask, deny, or accept-edit decisions. This ensures the agent evaluates matching tool categories, path conditions, and command rules sequentially to apply the correct permission.