← Back to Skills Marketplace
harrylabsj

Ai Agent Permission Planner

by haidong · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
21
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install ai-agent-permission-planner
Description
Builds a least-privilege permission plan before connecting an AI assistant or agent to files, email, calendar, browser, repositories, payment tools, or autom...
README (SKILL.md)

AI Agent Permission Planner

Overview

Use this prompt-only skill when a user is about to connect an AI assistant or agent to tools, accounts, documents, repositories, messaging channels, automations, or payment-related workflows and wants a clear permission plan before enabling access.

The goal is to turn a vague access decision into a practical least-privilege brief: what the agent may read, draft, edit, send, purchase, delete, or administer; what must stay human-approved; how long access should last; and how the user will audit or revoke it.

When to Use

Use this skill when the user asks to:

  • decide what permissions to grant an AI agent
  • connect an AI assistant to files, email, calendar, browser, code, or workflow tools
  • create an AI agent access checklist
  • define read-only, draft-only, write, send, purchase, delete, or admin scopes
  • set approval gates for autonomous or semi-autonomous AI work
  • reduce risk before testing an agent in a real account
  • prepare a permission brief for a team, client, or security review

Trigger keywords: AI agent permissions checklist, AI tool access plan, least privilege for AI agents, approval gates for AI assistant, agent access review, AI automation safety

Required Inputs

Ask only for the information needed to build the plan:

  • The task or workflow the agent is supposed to complete
  • Whether the task is one-time, recurring, experimental, or production use
  • Tools, accounts, folders, channels, repositories, or systems involved
  • Data types the agent may encounter, especially sensitive or regulated data
  • Actions the agent might need to take, such as read, draft, edit, send, buy, delete, or configure
  • People affected by the agent's work, such as customers, coworkers, clients, vendors, or family members
  • The user's risk tolerance, review capacity, deadline, and rollback options

If details are missing, continue with labeled assumptions and a short list of follow-up questions.

Workflow

  1. Define the agent job. State the task goal, expected output, user, affected accounts, deadline, and success criteria.
  2. List tools and data. Identify every tool, account, document set, message channel, repository, automation, and data category the agent might touch.
  3. Separate required from convenient access. Mark each requested permission as required, optional, excessive, unknown, or avoid for now.
  4. Classify action level. Label each permission as read-only, search, draft-only, comment, edit, send or publish, purchase or pay, delete, settings change, credential change, or admin-level.
  5. Map reason and risk. For each permission, explain the concrete reason, likely benefit, main risk, safer alternative, and time limit.
  6. Apply least-privilege defaults. Prefer narrow folders, test accounts, sandbox environments, temporary tokens, read-only scopes, drafts, and manual export/import before broad access.
  7. Set approval gates. Require human approval for external messages, irreversible edits, financial actions, deletions, legal or HR content, credential changes, sensitive records, or admin settings.
  8. Plan monitoring and rollback. Define logs to save, changes to review, access to revoke, owners to notify, and conditions that stop the agent.
  9. Create the permission brief. Produce a clear table, preflight checklist, and final recommendation: allow, allow with limits, test first, defer, or deny.

Output Format

Produce the permission plan with these sections:

  1. Permission Snapshot
    • Agent task
    • Use type: one-time, recurring, test, or production
    • Tools and accounts involved
    • Affected people or data
    • Overall risk level
  2. Least-Privilege Access Table
    • Tool or data source
    • Requested access
    • Recommended access
    • Why it is needed
    • Main risk
    • Safer alternative
    • Time limit or review date
    • Approval gate
  3. Do Not Grant Yet
    • Permissions that are excessive, unclear, or too risky
    • What evidence would justify reconsidering them
  4. Human Approval Gates
    • Actions requiring review before execution
    • Who approves
    • What the reviewer checks
  5. Data Handling Rules
    • Redaction rules
    • Sensitive data limits
    • Retention and deletion notes
    • Allowed examples or test data
  6. Monitoring and Rollback Plan
    • Logs to keep
    • Changes to inspect
    • Access to revoke
    • Stop conditions
    • Owner to notify
  7. Preflight Checklist
    • Final items to confirm before enabling the agent
  8. Recommendation
    • Allow, allow with limits, test first, defer, or deny
    • Short rationale

Safety Boundary

  • Do not ask for passwords, API keys, private keys, session cookies, recovery codes, full payment details, government ID numbers, or account security answers.
  • Do not advise bypassing security controls, platform policies, compliance reviews, rate limits, audit logs, or user consent.
  • Do not recommend broad admin access when a narrower scope, sandbox, export, or manual handoff can work.
  • Do not let an agent send external messages, publish content, make purchases, move money, delete data, change credentials, or alter security settings without explicit human approval.
  • For legal, medical, financial, employment, safety-critical, regulated, or high-impact workflows, require qualified review and conservative permissions.
  • Treat unknown permissions as not approved until the user can explain the need and rollback path.

Quality Checklist

A strong result should:

  • Name the exact agent task and success criteria
  • Distinguish required access from convenient access
  • Use least-privilege recommendations, not broad defaults
  • Include action-level labels for each permission
  • Add approval gates for irreversible, external, financial, or sensitive actions
  • Include redaction, monitoring, review, and revocation steps
  • End with a clear allow, limit, test, defer, or deny recommendation
Usage Guidance
This skill appears safe to use as an advisory checklist. Treat it as a planning aid, and follow its own boundary: describe systems and data categories, but do not paste secrets, API keys, cookies, payment numbers, or private records into the conversation.
Capability Analysis
Type: OpenClaw Skill Name: ai-agent-permission-planner Version: 1.0.0 The 'AI Agent Permission Planner' is a prompt-only skill (no executable code) designed to help users establish least-privilege access plans for AI assistants. The instructions in SKILL.md explicitly forbid the agent from requesting sensitive credentials (passwords, API keys) and mandate human approval gates for high-risk actions, aligning entirely with security best practices.
Capability Tags
cryptocan-make-purchasesrequires-sensitive-credentials
Capability Assessment
Purpose & Capability
The stated purpose is to create least-privilege permission plans for AI agents, and the artifacts consistently support that advisory workflow.
Instruction Scope
The instructions ask for task, tool, data-category, and risk-context information, while explicitly telling the assistant not to ask for passwords, API keys, cookies, recovery codes, or payment details.
Install Mechanism
There is no install spec, no executable code, no required binaries, and skill.json declares hasExecutableCode as false.
Credentials
Although the text discusses sensitive areas like files, email, repositories, payments, and credentials, it does so to plan restrictions and approval gates rather than to access those systems.
Persistence & Privilege
No persistence, background execution, credential storage, account access, or privilege escalation is described.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install ai-agent-permission-planner
  3. After installation, invoke the skill by name or use /ai-agent-permission-planner
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
AI Agent Permission Planner 1.0.0 – Initial Release - Introduces a structured prompt-based workflow for building least-privilege permission plans before connecting AI agents to user tools and data. - Provides detailed guidance for scoping agent access, distinguishing required from convenient permissions, and identifying sensitive actions. - Includes a workflow for generating permission snapshots, least-privilege access tables, approval gates, data handling rules, monitoring, and preflight checklists. - Establishes clear safety boundaries to prevent over-permissioning or unsafe agent actions. - Designed for use in scenarios involving agent integration with files, accounts, workflows, messaging, repositories, or payment tools.
Metadata
Slug ai-agent-permission-planner
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Ai Agent Permission Planner?

Builds a least-privilege permission plan before connecting an AI assistant or agent to files, email, calendar, browser, repositories, payment tools, or autom... It is an AI Agent Skill for Claude Code / OpenClaw, with 21 downloads so far.

How do I install Ai Agent Permission Planner?

Run "/install ai-agent-permission-planner" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Ai Agent Permission Planner free?

Yes, Ai Agent Permission Planner is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Ai Agent Permission Planner support?

Ai Agent Permission Planner is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Ai Agent Permission Planner?

It is built and maintained by haidong (@harrylabsj); the current version is v1.0.0.

💬 Comments