# A2ui Catalog Extractor > Generate or maintain A2UI catalog JSON from TypeDoc reflections for TypeScript interfaces marked with @a2uiCatalog. Use when this capability is needed. - Skill: `tomevault-io/a2ui-catalog-extractor` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/a2ui-catalog-extractor` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/a2ui-catalog-extractor/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/a2ui-catalog-extractor --- # A2UI Catalog Extractor Use this skill when a task involves authoring, updating, debugging, or generating A2UI catalog JSON from TSX/TypeScript component interfaces. ## Workflow 1. Mark only the catalog-facing TypeScript interface with `@a2uiCatalog `. 2. Use only standard TypeDoc-supported tags besides `@a2uiCatalog`: summaries, `@remarks`, `@defaultValue`, and `@deprecated`. 3. Keep catalog-facing shapes inline in the marked interface. The extractor consumes TypeDoc reflection data and does not parse source files itself. 4. Generate component catalog files with: ```bash a2ui-catalog-extractor --catalog-dir src/catalog --out-dir dist ``` ## Supported Type Shapes - `string`, `number`, `boolean` - string literal unions, emitted as JSON Schema `enum` - mixed unions, emitted as `oneOf` - arrays with `T[]`, `Array`, or `ReadonlyArray` - inline object type literals - `Record` Developers should not write JSON Schema in comments. If extraction fails because a reference is unsupported, inline the component's catalog contract in the marked interface. --- > Source: [lynx-family/lynx-stack](https://github.com/lynx-family/lynx-stack) — distributed by [TomeVault](https://tomevault.io).