CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

authz-configurator

Add authorization (authz) to a SigNoz backend feature end-to-end — register kinds/resources, grant managed-role permissions, wire routes with ResourceDefs, backfill tuples for existing orgs, and write the authz integration tests. Use this whenever the user mentions authz, authorization, permissions, access control, managed roles (admin/editor/viewer), OpenFGA, ResourceDef, CheckResources, 403/forbidden behavior on an endpoint, wiring or protecting a new route, registering a new resource/kind, or writing integration tests that assert role-based allow/deny. Also use it when a new API endpoint is being added and its access control hasn't been decided yet — every route needs an authz decision even if the user didn't say the word.

Quality

100%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

100%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is an exemplary workflow skill: a triage section routes work shapes to the right steps, each step gives exact files, code, and commands with the non-obvious failure modes called out (silent over-authorization from wrong selectors, schema-enum drift, startup panics), and a verification checklist closes the loop. Progressive disclosure is handled correctly — the body stays an overview while two real, well-signaled reference files hold the worked examples.

DimensionReasoningScore

Conciseness

Every section carries repo-specific, non-inferable detail (the `Kind.Enum()` drift trap, the 31-character factory-name panic, the `allowedResources` allowlist, migration patterns 083/099), and conceptual background is delegated to `docs/contributing/go/authz.md` and two reference files rather than restated. It assumes Claude's competence throughout — I could not identify a passage that is padding or a trimmable explanation, which is the 5 anchor rather than the minor-trimmable-instances anchor at 4.

5 / 5

Actionability

Guidance is copy-paste ready throughout: exact file paths (`pkg/types/coretypes/registry_kind.go`), real code snippets (`KindThing = MustNewKind("thing")`, the `Transaction` entry, the `allowedResources` line), exact commands (`go run cmd/enterprise/*.go generate openapi/authz/config transaction-groups`, `uv run pytest --basetemp=./tmp/ -vv --reuse ...`), and even the migration-name regex `^[a-z][a-z0-9_-]{0,30}$` with a preferred short name. This matches the fully-executable anchor at 5.

5 / 5

Workflow Clarity

Steps 1–7 are clearly sequenced, preceded by a triage table mapping work shapes to step subsets, and closed by a Verification section with a build command, seven explicit consistency greps, and integration suites to run. The batch migration step includes idempotency (`ON CONFLICT ... DO NOTHING`) and an explicit user checkpoint ("Ask the user whether backfill is needed rather than assuming"), so the missing-validation cap at 3 does not apply and the explicit-checkpoint anchor at 5 fits.

5 / 5

Progressive Disclosure

SKILL.md is a concise overview; detail lives in exactly two one-level-deep references (`references/route-wiring.md`, `references/integration-tests.md`), both verified to exist and to deliver the promised content (real route-wiring examples from `serviceaccount.go`; suite layout, fixtures, and run commands). Each reference is clearly signaled with when to read it ("Read references/route-wiring.md before wiring any create route, linking route, or custom selector"), matching the clear-overview anchor at 5.

5 / 5

Total

20

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is a model skill description: it states what the skill does through five concrete actions and gives two explicit, trigger-rich when-clauses including the non-obvious case of an endpoint whose access control hasn't been decided. Trigger coverage includes synonyms and natural user phrasings, and the SigNoz-specific vocabulary makes conflict with other skills negligible.

DimensionReasoningScore

Specificity

Enumerates five concrete, distinct actions — "register kinds/resources, grant managed-role permissions, wire routes with ResourceDefs, backfill tuples for existing orgs, and write the authz integration tests" — covering the full workflow with no gaps, matching the comprehensive-coverage anchor rather than the minor-gaps anchor at 4.

5 / 5

Completeness

Explicitly answers "what" with a third-person action list and "when" twice — "Use this whenever the user mentions authz..." and "Also use it when a new API endpoint is being added and its access control hasn't been decided yet". The explicit when-clause with concrete trigger phrases matches the 5 anchor exactly; the missing-when cap at 3 does not apply.

5 / 5

Trigger Term Quality

Covers synonyms and natural user phrasings comprehensively: "authz, authorization, permissions, access control, managed roles (admin/editor/viewer), OpenFGA, ResourceDef, CheckResources, 403/forbidden behavior", "wiring or protecting a new route", "role-based allow/deny". Both technical terms and colloquial triggers a user would actually say are present, so it exceeds the good-coverage anchor at 4.

5 / 5

Distinctiveness Conflict Risk

Clear niche (SigNoz backend authorization) anchored by project-specific terms — OpenFGA, ResourceDef, CheckResources, managed roles — that no generic skill would share, giving minimal conflict risk. It is distinct on its triggers, not merely "mostly distinct" as at 4; the one broadening clause (new API endpoints) is still scoped to authz decisions within this repo.

5 / 5

Total

20

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

SigNoz/signoz

Path

.claude/skills/authz-configurator/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.