Typeui CLI
Apps & Automationtypeui-cliTypeui CLI is an Agent Skill for apps & automation published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Guide for agentic tools to use the typeui.sh CLI for generating, updating, listing, and pulling design system skill files.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/skills/skills-bergside-typeui/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/typeui-cli, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
typeui.sh CLI Operator Skill
Mission
Use typeui.sh to generate, update, list, and pull design-system skill files for agentic tooling in a project.
When To Use This Skill
- User asks to create or refresh design-system instructions for agents.
- User wants to pull an existing style by slug.
- User wants to browse available styles and select one interactively.
- User asks for preview-only runs before writing files.
Preconditions
- Run commands from the target project root.
- Node.js 18+ is available.
- If running from this repository source, build first:
npm installnpm run build
Command Reference
npx typeui.sh generate- Run interactive prompts and create new managed skill content.
npx typeui.sh update- Update existing managed sections in generated files.
npx typeui.sh pull <slug>- Pull a specific registry skill and write it to selected provider paths.
npx typeui.sh list- List available registry slugs, show preview links, and pull one selection.
npx typeui.sh verify- Verify and cache license state for license-aware workflows.
npx typeui.sh license- Show local cached license summary.
npx typeui.sh clear-cache- Clear local
~/.typeui-shcache state.
- Clear local
Local Dev Invocation (This Repo)
node dist/cli.js --helpnode dist/cli.js generatenode dist/cli.js updatenode dist/cli.js listnode dist/cli.js pull <slug>
Shared Flags
-p, --providers <providers>- Comma-separated providers (example:
cursor,codex).
- Comma-separated providers (example:
--dry-run- Preview file changes without writing.
Provider Behavior
- Universal target is always included:
.agents/skills/design-system/SKILL.md. - Selected providers add extra output targets (for example
.cursor/...,.codex/...).
Registry Behavior
- Source of truth for list/pull data is:
https://github.com/bergside/awesome-design-skills
- Registry index used by CLI:
https://raw.githubusercontent.com/bergside/awesome-design-skills/main/skills/index.json
pull <slug>flow:- Validate slug format.
- Resolve
skillPathfrom index. - Fetch markdown from the raw GitHub path.
listflow:- Reads the same index and shows preview links from:
https://www.typeui.sh/design-systems/<slug>
Recommended Agent Workflow
- If user knows the style: run
pull <slug> --dry-runfirst. - If user does not know the style: run
listand select one. - Re-run without
--dry-runwhen preview looks correct. - Report generated/updated file paths and whether each changed.
Troubleshooting
Registry pull failed: not_found- Slug is not in registry index or markdown path is missing.
- Run
listand pick a valid slug.
Slug must contain only lowercase letters, numbers, dashes, or underscores- Normalize slug format before retrying.
No existing managed design system foundduringupdate- Run
generatefirst to create managed blocks.
- Run