ory-permissions-onboarding

Onboard Ory Permissions users from observe mode to enforce mode with tuple bootstrap.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/ory/codex-plugins --skill ory-permissions-onboarding
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ory-permissions-onboarding
Source: https://github.com/ory/codex-plugins/tree/main/plugins/ory-codex/skills/ory-permissions-onboarding
Command: npx skills add https://github.com/ory/codex-plugins --skill ory-permissions-onboarding

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @ory/codex, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill streamlines the initial setup of Ory Permissions, allowing for smooth enforcement of per-tool authorization on user installation without any roadblocks.

Core Features & Use Cases

  • Efficient Onboarding: Facilitates the transition from a permissions-by-observe default state to enforce mode with minimal steps.
  • Tuple Bootstrap: Ensures necessary permission tuples are created, granting the current user use access on every built-in tool of the harness.
  • Enforce Mode Promotion: Offers the ability to enable strict permission enforcement where any denied permission results in a block, crucial for production security.

Quick Start

Execute the skill to start the onboarding process for Ory Permissions for your installed toolset.

Frequently Asked Questions about ory-permissions-onboarding

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

FAQPage Schema
How do I set up Ory Permissions for tool authorization?

Onboarding Ory Permissions requires a properly configured Ory project and OAuth2 client to bootstrap permission tuples and transition from observe mode to enforce mode.

What is the difference between observe mode and enforce mode in Ory Permissions?

Observe mode monitors permission checks without blocking actions, while enforce mode enables strict user security where any denied permission immediately results in a blocked action.

How do I bootstrap permission tuples for new users in Ory?

Bootstrapping permission tuples grants the current user `use` access on every built-in tool, ensuring they have the necessary permissions before enabling strict enforcement.

Do I need an OAuth2 client to enable permission enforcement in Ory?

Yes, enforcing per-tool authorization requires proper project setup and an active OAuth2 client configuration to validate user permissions within the Ory environment.

What happens when a permission is denied in Ory enforce mode?

In enforce mode, denied permissions result in an immediate block, ensuring strict production security by preventing any unauthorized tool usage or access attempts.

Can I use Ory Permissions with an existing Ory project setup?

Yes, Ory Permissions supports existing Ory projects, allowing you to seamlessly transition your current toolset into strict permission enforcement without roadblocks.