synthetic-token-fixtures

Selects catalog-approved synthetic credential values for review-safe test fixtures.

Updated May 18, 2026
One-click install
npx skills add https://github.com/Joey-Tools/codex-private-workflows --skill synthetic-token-fixtures-joey-tools
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: synthetic-token-fixtures
Source: https://github.com/Joey-Tools/codex-private-workflows/tree/main/personal_codex/skills/synthetic-token-fixtures
Command: npx skills add https://github.com/Joey-Tools/codex-private-workflows --skill synthetic-token-fixtures-joey-tools

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing credential-shaped test fixtures often triggers secret-scanning failures during code review, and inventing fake tokens by hand risks either failing admission checks or accidentally resembling real secrets. This Skill provides a deterministic process for choosing exact, catalog-approved synthetic access, refresh, ID, API-key, and bearer token values that pass review secret admission. ## Core Features & Use Cases - Catalog-driven token selection: Queries the installed review helper's synthetic-tokens commands to list, filter, and retrieve approved token values by role (access, refresh, id, api-key, bearer) and lifecycle state (active, expired, consumed). - Stable fixture authoring: Records selected token IDs with each fixture so later work reuses the same values instead of reselecting after a catalog update, and provides placeholder-only templates for OAuth sessions, lifecycle transitions, and independent credentials. - Historical exemption handling: Inspects helper-owned legacy exemption envelopes for values already proven in master history, without registering pull-request-only values as legacy. - Use Case: When adding a test that models an expired access token and an active refresh token, run the helper's list command, filter by role and state, retrieve the exact values by ID, and insert them verbatim into the fixture. ## Quick Start Ask the assistant to use synthetic-token-fixtures to choose review-safe synthetic token values for a new credential-shaped test fixture.

Frequently Asked Questions about synthetic-token-fixtures

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

FAQPage Schema
How do I create test fixtures with fake tokens that pass secret scanning?

Use the review helper's synthetic-tokens list command to find catalog-approved values by role and state, then retrieve each value with synthetic-tokens get and insert it verbatim. Never invent token literals, since only the helper-owned catalog defines what secret admission accepts.

What token roles and states are supported for synthetic fixtures?

The catalog supports five roles: access, refresh, id, api-key, and bearer. Each token also has a lifecycle state of active, expired, or consumed, letting you model scenarios like expired sessions or consumed refresh tokens.

Can I modify a synthetic token value to fit my fixture format?

No. Values must be inserted verbatim as the complete credential value. Do not append counters, change case or whitespace, encode, use Unicode lookalikes, or embed the value inside another string, or admission may fail.

What should I do if the catalog lacks the token role or state I need?

Stop and request an explicit catalog update rather than inventing a value. The helper-owned catalog is the only source of acceptable tokens, and creating your own IDs, suffixes, or namespaces is prohibited.

When can I use a legacy synthetic secret exemption?

Legacy exemptions apply only to values already proven in master history, passed via --synthetic-secret-exemption when running secret admission for the affected frozen range. Never register pull-request-only values as legacy or use exemptions for new fixtures.