typeui-cli
Guide for agentic tools to use the typeui.sh CLI for generating, updating, listing, and pulling design system skill files.
- License 许可
- MIT
- 最近更新
- 2026-06-02
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- typeui-cli
- license
- MIT
- metadata
- { "author": "typeui.sh" }
- description
- Guide for agentic tools to use the typeui.sh CLI for generating, updating, listing, and pulling design system skill files.
03 SKILL.md 正文
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.
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
04 同仓库更多 Skills
webapp-testing
Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.
ckm:ui-styling
Create beautiful, accessible user interfaces with shadcn/ui components (built on Radix UI + Tailwind), Tailwind CSS utility-first styling, and canvas-based visual designs. Use when building user interfaces, implementing design systems, creating responsive layouts, adding accessible components (dialogs, dropdowns, forms, tables), customizing themes and colors, implementing dark mode, generating visual designs and posters, or establishing consistent styling patterns across applications.
ckm:design
Comprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG, Gemini 3.1 Pro), social photos (HTML→screenshot, multi-platform). Actions: design logo, create CIP, generate mockups, build slides, design banner, generate icon, create social photos, social media images, brand identity, design system. Platforms: Facebook, Twitter, LinkedIn, YouTube, Instagram, Pinterest, TikTok, Threads, Google Ads.
ckm:design-system
Token architecture, component specifications, and slide generation. Three-layer tokens (primitive→semantic→component), CSS variables, spacing/typography scales, component specs, strategic slide creation. Use for design tokens, systematic design, brand-compliant presentations.
ckm:banner-design
Design banners for social media, ads, website heroes, creative assets, and print. Multiple art direction options with AI-generated visuals. Actions: design, create, generate banner. Platforms: Facebook, Twitter/X, LinkedIn, YouTube, Instagram, Google Display, website hero, print. Styles: minimalist, gradient, bold typography, photo-based, illustrated, geometric, retro, glassmorphism, 3D, neon, duotone, editorial, collage. Uses ui-ux-pro-max, frontend-design, ai-artist, ai-multimodal skills.
typeui-cli
Guide for agentic tools to use the typeui.sh CLI for generating, updating, listing, and pulling design system skill files.