roles-naming

Standardize role naming across microservices and IdPs using SCREAMING_SNAKE_CASE.

Updated Apr 16, 2026
One-click install
npx skills add https://github.com/tassosgomes/poc-iam-service --skill roles-naming
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: roles-naming
Source: https://github.com/tassosgomes/poc-iam-service/tree/main/.github/skills/common/roles-naming
Command: npx skills add https://github.com/tassosgomes/poc-iam-service --skill roles-naming

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Use este skill quando o usuario precisar padronizar nomenclatura de roles (perfis de acesso) em ecossistemas de microserviços entre serviços e provedores de identidade, evitando divergências de nomenclatura e facilitando migrações.

Core Features & Use Cases

  • Define o formato SCREAMING_SNAKE_CASE como padrão obrigatório para nomes de roles.
  • Define a hierarquia entre roles globais e roles de domínio para maior clareza e escalabilidade.
  • Indica diretrizes de integração IdP ↔ microserviços, incluindo a claim de roles e consumo a nível de serviço.

Quick Start

Configure um conjunto de roles seguindo SCREAMING_SNAKE_CASE e aplique as regras de nomenclatura no IdP e nos serviços.

Frequently Asked Questions about roles-naming

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

FAQPage Schema
How do I standardize role naming across microservices and identity providers?

To standardize role naming across microservices, enforce SCREAMING_SNAKE_CASE globally and remove IdP prefixes. This prevents case mismatches and maintains consistent role dictionaries during migrations.

What is the correct role naming format for consistent RBAC in microservices?

The correct role naming format for consistent RBAC in microservices is SCREAMING_SNAKE_CASE. It enforces case-sensitive comparisons and removes identity provider prefixes to prevent access mismatches.

How do I handle global and domain-specific roles in a microservices architecture?

Handling global and domain-specific roles in a microservices architecture requires defining a clear hierarchy. Domain-specific roles apply to individual services while global roles span the entire ecosystem.

How should microservices retrieve token roles from a Keycloak identity provider?

Microservices should retrieve token roles from an identity provider like Keycloak by extracting them directly from a 'roles' claim. This ensures consistent access control across diverse tech stacks.

Why do role prefix and case mismatches happen between Keycloak and microservices?

Role prefix and case mismatches happen between Keycloak and microservices due to inconsistent naming conventions. Removing IdP prefixes and enforcing case-sensitive SCREAMING_SNAKE_CASE resolves these integration issues.