polizy-troubleshooting

Debug polizy authorization failures by analyzing check() behavior and relations.

7|1|Updated Apr 23, 2025
One-click install
npx skills add https://github.com/bratsos/polizy --skill polizy-troubleshooting
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: polizy-troubleshooting
Source: https://github.com/bratsos/polizy/tree/main/skills/polizy-troubleshooting
Command: npx skills add https://github.com/bratsos/polizy --skill polizy-troubleshooting

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Debug and resolve polizy authorization issues that arise when permission checks fail, throw errors, or behave unexpectedly, by guiding diagnosis and fixes.

Core Features & Use Cases

  • Guided diagnosis of failing checks, including action-to-relations mapping, group expansion, and hierarchy propagation.
  • Issue catalog and remedies for common problems like missing relations, wrong propagation rules, and orphaned tuples.
  • Defensive guidance for safe debugging with step-by-step troubleshooting flows and preventive patterns.

Quick Start

Run a focused check of the permission path for a failing user to identify whether the failure is direct, in groups, or via hierarchy, and apply the recommended fixes.

Frequently Asked Questions about polizy-troubleshooting

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

FAQPage Schema
How do I debug polizy authorization issues when permission checks fail unexpectedly?

Debug polizy authorization issues by running a focused check of the permission path for the failing user to identify whether the failure is direct, in groups, or via hierarchy, then apply the recommended fixes to relations and tuples.

Why does polizy hierarchy propagation block access incorrectly despite existing relations?

Hierarchy propagation in polizy blocks access incorrectly when wrong propagation rules or orphaned tuples exist in the schema. Validate the action-to-relations mapping and fix missing relations to resolve the misconfiguration.

What is the best way to troubleshoot polizy group expansion errors during a check?

The best way to troubleshoot polizy group expansion errors is to follow a guided diagnosis flow that analyzes the check behavior and validates schemas, ensuring tuples and group relations are correctly configured and expanded.

How do I fix orphaned tuples causing misconfigurations in polizy authorization schemas?

Fix orphaned tuples in polizy authorization schemas by applying defensive guidance and preventive patterns from the issue catalog, which remedies missing relations and wrong propagation rules to restore correct permission checks.

What are common anti-patterns when diagnosing polizy action-to-relations mapping failures?

Common anti-patterns when diagnosing polizy action-to-relations mapping failures include ignoring group expansion logic, overlooking hierarchy propagation rules, and failing to validate schemas before troubleshooting tuple misconfigurations.