{"id":"acd8de96-da44-4f6a-978a-729835bfd69f","shortId":"qgfHjQ","kind":"skill","title":"typeui-cli","tagline":"Guide for agentic tools to use the typeui.sh CLI for generating, updating, listing, and pulling design system skill files.","description":"# typeui.sh CLI Operator Skill\n\n## Mission\n\nUse `typeui.sh` to generate, update, list, and pull design-system skill files for agentic tooling in a project.\n\n## When To Use This Skill\n\n- User asks to create or refresh design-system instructions for agents.\n- User wants to pull an existing style by slug.\n- User wants to browse available styles and select one interactively.\n- User asks for preview-only runs before writing files.\n\n## Preconditions\n\n- Run commands from the target project root.\n- Node.js 18+ is available.\n- If running from this repository source, build first:\n  - `npm install`\n  - `npm run build`\n\n## Command Reference\n\n- `npx typeui.sh generate`\n  - Run interactive prompts and create new managed skill content.\n- `npx typeui.sh update`\n  - Update existing managed sections in generated files.\n- `npx typeui.sh pull <slug>`\n  - Pull a specific registry skill and write it to selected provider paths.\n- `npx typeui.sh list`\n  - List available registry slugs, show preview links, and pull one selection.\n\n## Local Dev Invocation (This Repo)\n\n- `node dist/cli.js --help`\n- `node dist/cli.js generate`\n- `node dist/cli.js update`\n- `node dist/cli.js list`\n- `node dist/cli.js pull <slug>`\n\n## Shared Flags\n\n- `-p, --providers <providers>`\n  - Comma-separated providers (example: `cursor,codex`).\n- `--dry-run`\n  - Preview file changes without writing.\n\n## Provider Behavior\n\n- Universal target is always included: `.agents/skills/design-system/SKILL.md`.\n- Selected providers add extra output targets (for example `.cursor/...`, `.codex/...`).\n\n## Registry Behavior\n\n- Source of truth for list/pull data is:\n  - `https://github.com/bergside/awesome-design-skills`\n- Registry index used by CLI:\n  - `https://raw.githubusercontent.com/bergside/awesome-design-skills/main/skills/index.json`\n- `pull <slug>` flow:\n  1. Validate slug format.\n  2. Resolve `skillPath` from index.\n  3. Fetch markdown from the raw GitHub path.\n- `list` flow:\n  - Reads the same index and shows preview links from:\n  - `https://www.typeui.sh/design-systems/<slug>`\n\n## Recommended Agent Workflow\n\n1. If user knows the style: run `pull <slug> --dry-run` first.\n2. If user does not know the style: run `list` and select one.\n3. Re-run without `--dry-run` when preview looks correct.\n4. Report generated/updated file paths and whether each changed.\n\n## Troubleshooting\n\n- `Registry pull failed: not_found`\n  - Slug is not in registry index or markdown path is missing.\n  - Run `list` and pick a valid slug.\n- `Slug must contain only lowercase letters, numbers, dashes, or underscores`\n  - Normalize slug format before retrying.\n- `No existing managed design system found` during `update`\n  - Run `generate` first to create managed blocks.","tags":["typeui","cli","bergside","agent-skills","ai-tools","claude-design","codex","design","design-md","design-system","design-tools","gemini"],"capabilities":["skill","source-bergside","skill-typeui-cli","topic-agent-skills","topic-ai-tools","topic-claude-design","topic-cli","topic-codex","topic-design","topic-design-md","topic-design-system","topic-design-tools","topic-gemini","topic-google-stitch","topic-skills"],"categories":["typeui"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/bergside/typeui/typeui-cli","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add bergside/typeui","source_repo":"https://github.com/bergside/typeui","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 766 github stars · SKILL.md body (2,725 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-02T18:53:04.256Z","embedding":null,"createdAt":"2026-04-18T21:57:21.753Z","updatedAt":"2026-05-02T18:53:04.256Z","lastSeenAt":"2026-05-02T18:53:04.256Z","tsv":"'/bergside/awesome-design-skills':239 '/bergside/awesome-design-skills/main/skills/index.json':247 '/design-systems/':280 '1':250,284 '18':102 '2':254,296 '3':259,309 '4':321 'add':220 'agent':6,42,63,282 'agents/skills/design-system/skill.md':217 'alway':215 'ask':53,84 'avail':77,104,161 'behavior':211,229 'block':383 'brows':76 'build':111,117 'chang':207,329 'cli':3,12,24,244 'codex':201,227 'comma':196 'comma-separ':195 'command':95,118 'contain':356 'content':131 'correct':320 'creat':55,127,381 'cursor':200,226 'dash':361 'data':235 'design':19,37,59,372 'design-system':36,58 'dev':172 'dist/cli.js':177,180,183,186,189 'dri':203,293,315 'dry-run':202,292,314 'exampl':199,225 'exist':69,136,370 'extra':221 'fail':333 'fetch':260 'file':22,40,92,141,206,324 'first':112,295,379 'flag':192 'flow':249,268 'format':253,366 'found':335,374 'generat':14,31,122,140,181,378 'generated/updated':323 'github':265 'github.com':238 'github.com/bergside/awesome-design-skills':237 'guid':4 'help':178 'includ':216 'index':241,258,272,341 'instal':114 'instruct':61 'interact':82,124 'invoc':173 'know':287,301 'letter':359 'link':166,276 'list':16,33,159,160,187,267,305,348 'list/pull':234 'local':171 'look':319 'lowercas':358 'manag':129,137,371,382 'markdown':261,343 'miss':346 'mission':27 'must':355 'new':128 'node':176,179,182,185,188 'node.js':101 'normal':364 'npm':113,115 'npx':120,132,142,157 'number':360 'one':81,169,308 'oper':25 'output':222 'p':193 'path':156,266,325,344 'pick':350 'precondit':93 'preview':87,165,205,275,318 'preview-on':86 'project':46,99 'prompt':125 'provid':155,194,198,210,219 'pull':18,35,67,144,145,168,190,248,291,332 'raw':264 'raw.githubusercontent.com':246 'raw.githubusercontent.com/bergside/awesome-design-skills/main/skills/index.json':245 're':311 're-run':310 'read':269 'recommend':281 'refer':119 'refresh':57 'registri':148,162,228,240,331,340 'repo':175 'report':322 'repositori':109 'resolv':255 'retri':368 'root':100 'run':89,94,106,116,123,204,290,294,304,312,316,347,377 'section':138 'select':80,154,170,218,307 'separ':197 'share':191 'show':164,274 'skill':21,26,39,51,130,149 'skill-typeui-cli' 'skillpath':256 'slug':72,163,252,336,353,354,365 'sourc':110,230 'source-bergside' 'specif':147 'style':70,78,289,303 'system':20,38,60,373 'target':98,213,223 'tool':7,43 'topic-agent-skills' 'topic-ai-tools' 'topic-claude-design' 'topic-cli' 'topic-codex' 'topic-design' 'topic-design-md' 'topic-design-system' 'topic-design-tools' 'topic-gemini' 'topic-google-stitch' 'topic-skills' 'troubleshoot':330 'truth':232 'typeui':2 'typeui-c':1 'typeui.sh':11,23,29,121,133,143,158 'underscor':363 'univers':212 'updat':15,32,134,135,184,376 'use':9,28,49,242 'user':52,64,73,83,286,298 'valid':251,352 'want':65,74 'whether':327 'without':208,313 'workflow':283 'write':91,151,209 'www.typeui.sh':279 'www.typeui.sh/design-systems/':278","prices":[{"id":"6052127a-2173-43a7-b877-cfb92da515af","listingId":"acd8de96-da44-4f6a-978a-729835bfd69f","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"bergside","category":"typeui","install_from":"skills.sh"},"createdAt":"2026-04-18T21:57:21.753Z"}],"sources":[{"listingId":"acd8de96-da44-4f6a-978a-729835bfd69f","source":"github","sourceId":"bergside/typeui/typeui-cli","sourceUrl":"https://github.com/bergside/typeui/tree/main/skills/typeui-cli","isPrimary":false,"firstSeenAt":"2026-04-18T21:57:21.753Z","lastSeenAt":"2026-05-02T18:53:04.256Z"}],"details":{"listingId":"acd8de96-da44-4f6a-978a-729835bfd69f","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"bergside","slug":"typeui-cli","github":{"repo":"bergside/typeui","stars":766,"topics":["agent-skills","ai","ai-tools","claude-design","cli","codex","design","design-md","design-system","design-tools","gemini","google-stitch","skills","terminal","ui"],"license":"other","html_url":"https://github.com/bergside/typeui","pushed_at":"2026-04-28T11:24:39Z","description":"Design skills for agentic tools such as Claude Design, Google Stitch, Codex, Cursor, and more","skill_md_sha":"75f19d317e4f3343472a0f103674cc467925eae5","skill_md_path":"skills/typeui-cli/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/bergside/typeui/tree/main/skills/typeui-cli"},"layout":"multi","source":"github","category":"typeui","frontmatter":{"name":"typeui-cli","license":"MIT","description":"Guide for agentic tools to use the typeui.sh CLI for generating, updating, listing, and pulling design system skill files."},"skills_sh_url":"https://skills.sh/bergside/typeui/typeui-cli"},"updatedAt":"2026-05-02T18:53:04.256Z"}}