dragon-guard

Enforce permission checks for Pi agent tool calls with mode-based policies.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/dotBeeps/hoard --skill dragon-guard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dragon-guard
Source: https://github.com/dotBeeps/hoard/tree/main/morsels/skills/dragon-guard
Command: npx skills add https://github.com/dotBeeps/hoard --skill dragon-guard

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents agents from executing unsafe or unintended mutating tool calls by enforcing interactive permission checks and mode-based policies so exploratory analysis does not cause accidental changes.

Core Features & Use Cases

  • Three-tier modes: Dog (permission-gated), Puppy (read-only planning), Dragon (full implementation) to match user intent and risk tolerance.
  • Session-scoped allow/deny lists: Temporarily permit repetitive actions without persisting risky overrides across sessions.
  • Safe-tool whitelisting and bash classification: Always allow read-only inspection tools and heuristically classify bash commands to avoid accidental mutations.
  • Interactive dialogs and auto-detect: Prompt for permission on ambiguous or mutating actions, optionally auto-switch to Puppy Mode for complex prompts, and summarize risky calls using LLM summaries.

Quick Start

Start in Dog Mode and respond to permission dialogs to allow or block mutating tool calls while you inspect code and plan changes.

Frequently Asked Questions about dragon-guard

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

FAQPage Schema
How do I prevent AI agents from executing unsafe mutating tool calls during code exploration?

To prevent AI agents from executing unsafe mutating tool calls, you can enforce interactive permission checks and mode-based policies. This ensures exploratory analysis does not cause accidental changes to files, system settings, git, or package operations.

What is the best way to manage agent permissions for file and system operations?

The best way to manage agent permissions is by using three-tier modes: Dog for permission-gated actions, Puppy for read-only planning, and Dragon for full implementation. This matches your risk tolerance and intent during development workflows.

Can I temporarily allow repetitive agent actions without persisting risky overrides across sessions?

Yes, you can temporarily allow repetitive agent actions without persisting risky overrides by using session-scoped allow and deny lists. This restricts permissions to the current session, preventing permanent risky configurations.

How does bash command classification work for agent safety?

Bash command classification for agent safety works by heuristically evaluating commands to identify potential mutations. It pairs with safe-tool whitelisting to always allow read-only inspection tools while prompting for permission on ambiguous or mutating actions.

Does interactive permission control support complex prompts during active development?

Yes, interactive permission control supports complex prompts during active development by optionally auto-switching to Puppy Mode. It also summarizes risky calls using LLM summaries to help you review potentially unsafe mutations.

When should I not use full implementation mode for AI agent tool calls?

You should not use full implementation mode, such as Dragon Mode, when performing exploratory analysis or planning. Instead, use read-only Puppy Mode to prevent accidental mutations and ensure unsafe or unintended tool calls are blocked.