entitlement-synchronization

Synchronize tenant entitlements from billing state to feature access.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/marquesfelip/agents-and-skills --skill entitlement-synchronization
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: entitlement-synchronization
Source: https://github.com/marquesfelip/agents-and-skills/tree/main/skills/entitlement-synchronization
Command: npx skills add https://github.com/marquesfelip/agents-and-skills --skill entitlement-synchronization

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The entitlement synchronization process ensures that the billing state accurately controls which features tenants can access, preventing drift and enabling safe access gating across the product.

Core Features & Use Cases

  • Define an entitlement matrix tying plans to feature keys and limits.
  • Sync entitlements automatically on billing events (activation, trial, renewal, cancellation) and invalidate caches to keep checks fast and correct.
  • Provide a unified entitlement API for fast gate checks across services, with support for overrides and expiry.
  • Handle grace periods, trials, and state transitions in a robust model with auditable history.

Quick Start

Integrate the entitlement syncer into the billing workflow and trigger SyncForTenant after a successful subscription transition.

Frequently Asked Questions about entitlement-synchronization

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

FAQPage Schema
How do I synchronize billing state with feature access for SaaS subscriptions?

Synchronizing billing state with feature access maps tenant entitlements from subscription events to feature gates. It ensures consistent access control across plan activations, trials, grace periods, and cancellations using an async sync workflow.

What is the best way to handle entitlement cache invalidation after a billing event?

Entitlement cache invalidation happens automatically after async synchronization processes billing events like renewals or cancellations. This keeps subsequent feature flag checks fast and correct by clearing stale tenant entitlement data immediately.

Can I apply admin overrides with expiry to tenant entitlements?

Admin overrides with expiry are supported to grant temporary feature access outside standard subscription limits. These overrides integrate directly into the tenant entitlements model, ensuring auditable history and automatic access expiration.

Does this entitlement sync approach support trials and grace periods?

The entitlement sync approach fully supports trials and grace periods within its state transition model. It safely gates features during these phases by mapping temporary billing states to specific plan features and limits.

How do I define an entitlement matrix tying subscription plans to feature keys?

Defining an entitlement matrix uses a relational schema connecting plan_features to tenant_entitlements. This structure ties subscription plans to specific feature keys and usage limits, enabling precise plan-based gating across services.