Agent skill

Fa Theme Customizer

by fantastic-admin in fantastic-admin/basic

为 Fantastic-admin 框架创建和定制主题配色方案,始终同时生成明色(light)和暗色(dark)两套主题。当用户提到以下任何需求时必须使用此技能:换主题颜色、换配色、做一个 XX 风格的主题、主题太单调了、品牌色是 XXX 帮我生成主题、把 tweakcn…

MITAuto-check passedFrontend & Design

Install Fa Theme Customizer

skills CLI
$ npx skills add fantastic-admin/basic --skill fa-theme-customizer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install fantastic-admin/basic fa-theme-customizer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/fantastic-admin/basic.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/fa-theme-customizer .claude/skills/fa-theme-customizer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
fa-theme-customizer
GitHub stars
3.4k
Token cost
~1.3k tokens
SKILL.md length
58 words
Files
3 (incl. references)
Skills in repo
9
Repo updated
First seen
Licence
MIT

At a glance

为 Fantastic-admin 框架创建和定制主题配色方案,始终同时生成明色(light)和暗色(dark)两套主题。当用户提到以下任何需求时必须使用此技能:换主题颜色、换配色、做一个 XX 风格的主题、主题太单调了、品牌色是 XXX 帮我生成主题、把 tweakcn…

  • Frontend & Design work in your project
  • SKILL.md covers 主题文件位置, 工作流程 and 参考资源
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Fa Theme Customizer is an agent skill from fantastic-admin/basic. 为 Fantastic-admin 框架创建和定制主题配色方案,始终同时生成明色(light)和暗色(dark)两套主题。当用户提到以下任何需求时必须使用此技能:换主题颜色、换配色、做一个 XX 风格的主题、主题太单调了、品牌色是 XXX 帮我生成主题、把 tweakcn 配色转成框架主题、想要暗色/冷色/暖色调、根据设计稿颜色生成主题。即使用户只是描述一种感觉("清新"、"沉稳"、"科技感")或提供一个颜色值("2563EB"),也应触发此技能。支持"吉卜力"、"赛博朋克"、"莫兰迪"、"北欧极简"等专业设计风格关键词。

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/design-styles.md` and `references/theme-structure.md`).

It sits in Frontend & Design. It works with shadcn/ui and Vue.js. The repository describes itself as: ⭐⭐⭐⭐⭐ 面向 AI 编程的管理系统框架,兼容PC、移动端。AI-oriented management system framework, compatible with PC and mobile device. The licence is MIT.

When your agent uses it

  • Frontend & Design work in your project

Example prompts

  • “)或提供一个颜色值(”
  • “),也应触发此技能。支持”
  • “/fa-theme-customizer”

What it can do on your machine

Read from SKILL.md and the folder at commit 1b5961e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are typescript).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • tweakcn.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Fa Theme Customizer loads about 1.3k tokens when it runs, and up to ~5.7k if it reads all its reference files. Until then it costs about 71 tokens; SKILL.md has 58 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~71
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from fantastic-admin/basic at commit 1b5961e, republished under its MIT licence (© fantastic-admin). 58 words, ~1,336 tokens.

Download SKILL.mdSave it as .claude/skills/fa-theme-customizer/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
fa-theme-customizer
description
为 Fantastic-admin 框架创建和定制主题配色方案,始终同时生成明色(light)和暗色(dark)两套主题。当用户提到以下任何需求时必须使用此技能:换主题颜色、换配色、做一个 XX 风格的主题、主题太单调了、品牌色是 XXX 帮我生成主题、把 tweakcn 配色转成框架主题、想要暗色/冷色/暖色调、根据设计稿颜色生成主题。即使用户只是描述一种感觉("清新"、"沉稳"、"科技感")或提供一个颜色值("#2563EB"),也应触发此技能。支持"吉卜力"、"赛博朋克"、"莫兰迪"、"北欧极简"等专业设计风格关键词。

主题定制器

为 Fantastic-admin 框架生成符合规范的主题配色。

主题文件位置

  • 主题定义:packages/themes/index.ts(在此替换新主题,跨所有应用共享)
  • 类型推断:自动从 packages/themes/index.ts 的 key 推断,无需手动更新类型

工作流程

第一步:确认设计风格

如果用户没有明确指定颜色,先提供风格参考。读取 references/design-styles.md 获取完整的风格目录和配色建议。

第二步:生成 OKLCH 色值

框架使用 OKLCH 色彩空间,格式为 L C H(不含 oklch() 包裹,直接写三个数值)。

转换规则:

  • 明色背景:1 0 0(纯白)或接近白色的暖/冷色调
  • 暗色背景:0.141 0.005 285.823(默认深灰)或更深的色调
  • 主色(primary):明色通常比暗色亮度(L值)高 0.05~0.1

读取 references/theme-structure.md 了解完整的 CSS 变量说明和取值规范。

第三步:输出主题代码

在 packages/themes/index.ts 中替换新主题,格式严格遵循现有主题结构:

typescript
export const lightTheme = {
  // shadcn 标准 token(必填)
  '--background': 'L C H',
  '--foreground': 'L C H',
  '--card': 'L C H',
  '--card-foreground': 'L C H',
  '--popover': 'L C H',
  '--popover-foreground': 'L C H',
  '--primary': 'L C H',
  '--primary-foreground': 'L C H',
  '--secondary': 'L C H',
  '--secondary-foreground': 'L C H',
  '--muted': 'L C H',
  '--muted-foreground': 'L C H',
  '--accent': 'L C H',
  '--accent-foreground': 'L C H',
  '--destructive': '0.577 0.245 27.325',  // 通常保持不变
  '--border': 'L C H',
  '--input': 'L C H',
  '--ring': 'L C H',  // 通常与 primary 相同
  // 框架专属 token(必填)
  '--g-main-area-bg': 'oklch(L C H)',  // 明色略深于背景,形成层次感
  '--g-header-bg': 'oklch(var(--background))',
  '--g-header-color': 'oklch(var(--foreground))',
  '--g-header-menu-color': 'oklch(var(--accent-foreground))',
  '--g-header-menu-hover-bg': 'oklch(var(--accent))',
  '--g-header-menu-hover-color': 'oklch(var(--accent-foreground))',
  '--g-header-menu-active-bg': 'oklch(var(--primary))',
  '--g-header-menu-active-color': 'oklch(var(--primary-foreground))',
  '--g-main-sidebar-bg': 'oklch(var(--background))',
  '--g-main-sidebar-menu-color': 'oklch(var(--accent-foreground))',
  '--g-main-sidebar-menu-hover-bg': 'oklch(var(--accent))',
  '--g-main-sidebar-menu-hover-color': 'oklch(var(--accent-foreground))',
  '--g-main-sidebar-menu-active-bg': 'oklch(var(--primary))',
  '--g-main-sidebar-menu-active-color': 'oklch(var(--primary-foreground))',
  '--g-sub-sidebar-bg': 'oklch(var(--background))',
  '--g-sub-sidebar-menu-color': 'oklch(var(--accent-foreground))',
  '--g-sub-sidebar-menu-hover-bg': 'oklch(var(--accent))',
  '--g-sub-sidebar-menu-hover-color': 'oklch(var(--accent-foreground))',
  '--g-sub-sidebar-menu-active-bg': 'oklch(var(--primary))',
  '--g-sub-sidebar-menu-active-color': 'oklch(var(--primary-foreground))',
  '--g-tabbar-bg': 'oklch(var(--background))',
  '--g-tabbar-tab-color': 'oklch(var(--accent-foreground) / 50%)',
  '--g-tabbar-tab-hover-bg': 'oklch(var(--accent) / 50%)',
  '--g-tabbar-tab-hover-color': 'oklch(var(--accent-foreground) / 50%)',
  '--g-tabbar-tab-active-bg': 'oklch(var(--accent))',
  '--g-tabbar-tab-active-color': 'oklch(var(--foreground))',
  '--g-toolbar-bg': 'oklch(var(--background))',
} as const

export const darkTheme = {
  // shadcn 标准 token(同明色结构,但色值更深)
  '--background': 'L C H',
  // ... 其余 shadcn token
  // 框架专属 token(暗色与明色有 5 处关键差异,见 references/theme-structure.md)
  '--g-main-area-bg': 'oklch(var(--background))',  // 暗色与背景相同,避免过多层次
  '--g-header-bg': 'oklch(var(--background))',
  '--g-header-color': 'oklch(var(--foreground))',
  '--g-header-menu-color': 'oklch(var(--muted-foreground))',       // 差异:用 muted-foreground
  '--g-header-menu-hover-bg': 'oklch(var(--muted))',               // 差异:用 muted
  '--g-header-menu-hover-color': 'oklch(var(--muted-foreground))',
  '--g-header-menu-active-bg': 'oklch(var(--accent))',             // 差异:用 accent 而非 primary
  '--g-header-menu-active-color': 'oklch(var(--accent-foreground))',
  '--g-main-sidebar-bg': 'oklch(var(--background))',
  '--g-main-sidebar-menu-color': 'oklch(var(--muted-foreground))',
  '--g-main-sidebar-menu-hover-bg': 'oklch(var(--muted))',
  '--g-main-sidebar-menu-hover-color': 'oklch(var(--muted-foreground))',
  '--g-main-sidebar-menu-active-bg': 'oklch(var(--accent))',
  '--g-main-sidebar-menu-active-color': 'oklch(var(--accent-foreground))',
  '--g-sub-sidebar-bg': 'oklch(var(--background))',
  '--g-sub-sidebar-menu-color': 'oklch(var(--muted-foreground))',
  '--g-sub-sidebar-menu-hover-bg': 'oklch(var(--muted))',
  '--g-sub-sidebar-menu-hover-color': 'oklch(var(--muted-foreground))',
  '--g-sub-sidebar-menu-active-bg': 'oklch(var(--accent))',
  '--g-sub-sidebar-menu-active-color': 'oklch(var(--accent-foreground))',
  '--g-tabbar-bg': 'oklch(var(--background))',
  '--g-tabbar-tab-color': 'oklch(var(--accent-foreground) / 50%)',
  '--g-tabbar-tab-hover-bg': 'oklch(var(--accent) / 50%)',
  '--g-tabbar-tab-hover-color': 'oklch(var(--accent-foreground) / 50%)',
  '--g-tabbar-tab-active-bg': 'oklch(var(--accent))',
  '--g-tabbar-tab-active-color': 'oklch(var(--foreground))',
  '--g-toolbar-bg': 'oklch(var(--background))',
} as const

参考资源

  • 设计风格目录:references/design-styles.md — 包含 20+ 种专业设计风格的配色方案和灵感来源
  • CSS 变量说明:references/theme-structure.md — 每个变量的作用、取值规范和明暗差异(含完整暗色模板)
  • 社区配色:https://tweakcn.com/community — 可直接参考社区主题的 shadcn CSS 变量

© fantastic-admin, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in skills/fa-theme-customizer of fantastic-admin/basic.

  • SKILL.md
  • references/design-styles.md
  • references/theme-structure.md

Open the folder on GitHubat commit 1b5961e

Compare with similar skills

Fa Theme Customizer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Fa Theme Customizer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Fa Theme Customizer this skillfantastic-admin/basic3.4k—~1.3kAutomated safety check: PassMIT
UithingBayBreezy/ui-thing729—~1.3kAutomated safety check: PassCustom licence
Tailwind To Stylexshadcn-labs/shadcn-cssinjs123—~2.7kAutomated safety check: PassMIT
UI UX Pro MaxOhh-889/skyroc79527 repos~3.6kAutomated safety check: NotesMIT
Atlaspacifio/ui154—~2.5kAutomated safety check: PassMIT
Shadcn Vuehirotaka/pragmatic-nuxt170—~3.9kAutomated safety check: PassMIT

Similar skills

  • Uithing

    BayBreezy/ui-thing

    Manages UI Thing components, prose, blocks, themes, shortcuts, docs, and MCP-driven workflows in Nuxt projects and in the UI Thing source repo.

    729 GitHub stars~1.3k tokensUpdated 5 days ago
    Frontend & DesignAuto-check passed
  • Tailwind To Stylex

    shadcn-labs/shadcn-cssinjs

    Migrate TailwindCSS to StyleX. An agent skill from shadcn-labs/shadcn-cssinjs.

    123 GitHub stars~2.7k tokensUpdated 27 days ago
    Frontend & DesignAuto-check passed
  • UI UX Pro Max

    Ohh-889/skyroc

    UI/UX design intelligence. An agent skill from Ohh-889/skyroc.

    795 GitHub starsUsed in 27 repos~3.6k tokens
    Frontend & DesignAuto-check: notes
  • Atlas

    pacifio/ui

    Atlas — a design language and UI guide system for agent interfaces.

    154 GitHub stars~2.5k tokensUpdated 5 mo ago
    Frontend & DesignAuto-check passed
  • Shadcn Vue

    hirotaka/pragmatic-nuxt

    Manages shadcn-vue components and projects — adding, searching, fixing, debugging, styling, and composing UI.

    170 GitHub stars~3.9k tokensUpdated 3 days ago
    Frontend & DesignAuto-check passed
  • Shadcn Vue Skilld

    skilld-dev/vue-ecosystem-skills

    A skill your agent uses when adding, configuring, or debugging shadcn-vue in a Vue or Nuxt project.

    181 GitHub stars~1.2k tokensUpdated 15 days ago
    Frontend & DesignAuto-check passed

More from fantastic-admin/basic

All 9 skills in this repo
  • Fa Route Generator

    fantastic-admin/basic

    管理 Vue Router 路由配置,用于 Fantastic-admin 框架。当用户提到以下任何需求时必须使用此技能:新建页面需要加路由、详情页不想显示在菜单里、新增页和编辑页老是开两个标签、从列表跳详情返回后状态丢失、给菜单项加 NEW 标签或红点、路由需要权限控制、配置页面保活、修改路由 meta、添加面包屑配置。即使用户只是说"加个路由"或"新建了一个页面",也应触发此技能。

    3.4k GitHub stars~565 tokensUpdated 8 days ago
    Auto-check passed
  • Fa Slot Creator

    fantastic-admin/basic

    在 Fantastic-admin 框架中创建插槽,向布局的任意位置注入自定义内容。当用户提到以下任何需求时必须使用此技能:在头部/侧边栏/工具栏/标签栏加东西、logo 旁边加内容、侧边栏底部加用户信息、加个悬浮按钮、在导航菜单右侧加自定义组件、想在框架布局某个区域插入内容、在页面顶部或底部插入全局横幅/公告/版权栏。即使用户只是说"在顶部加个…

    3.4k GitHub stars~565 tokensUpdated 8 days ago
    Auto-check passed
  • Fa Feedback

    fantastic-admin/basic

    当用户在使用 fa- 系列技能(如 fa-framework-settings、fa-slot-creator、fa-form-builder、fa-route-generator、fa-store-generator、fa-page-optimizer、fa-theme-customizer 等)时,在同一个目标上经历了 3…

    3.4k GitHub stars~610 tokensUpdated 8 days ago
    Auto-check passed
  • Fa Page Optimizer

    fantastic-admin/basic

    优化 Vue 页面,用 Fantastic-admin 框架内建组件(packages/components/)替换自定义实现和原生 HTML。当用户说:'帮我优化这个页面'、'把这些原生 HTML 换成框架组件'、'用 FaCard/FaModal/FaButton 重构一下'、'这个页面太乱了'、'统一一下 UI…

    3.4k GitHub stars~431 tokensUpdated 8 days ago
    Auto-check passed
  • Fa Crud Page Generator

    fantastic-admin/basic

    为 Fantastic-admin 框架生成完整的 CRUD 业务模块,遵循框架标准模块结构和内建 Fa 组件体系,使用 FaForm/FaFormItem 生成新增/编辑表单,产出列表页、详情/编辑页、DetailForm 表单组件、API 模块、fake mock 数据、可选路由。用户说:'帮我做一个商品管理页面'、'搭一个用户列表,能搜索分页新增编辑删除'、'生成订单模块'、'新建 XX…

    3.4k GitHub stars~1.1k tokensUpdated 8 days ago
    Auto-check passed
  • Fa Form Builder

    fantastic-admin/basic

    为 Fantastic-admin 框架生成独立的表单页面,使用 FaForm/FaFormItem + vee-validate + zod 验证,表单 model 使用 ref,全部使用框架内建 Fa 组件。当用户说:'帮我做一个用户信息填写页'、'我只需要一个提交表单,不需要列表'、'做个设置页面,有几个输入框和保存按钮'、'生成一个注册/编辑/配置表单页'、'只要表单页,不需要增删改查'…

    3.4k GitHub stars~670 tokensUpdated 8 days ago
    Auto-check passed

Works with

Questions about Fa Theme Customizer

What does Fa Theme Customizer do?

为 Fantastic-admin 框架创建和定制主题配色方案,始终同时生成明色(light)和暗色(dark)两套主题。当用户提到以下任何需求时必须使用此技能:换主题颜色、换配色、做一个 XX 风格的主题、主题太单调了、品牌色是 XXX 帮我生成主题、把 tweakcn…. Fa Theme Customizer is an agent skill from fantastic-admin/basic.

When should I use Fa Theme Customizer?

Fa Theme Customizer fits situations like: frontend & Design work in your project.

How do I install Fa Theme Customizer in Claude Code?

Run `npx skills add fantastic-admin/basic --skill fa-theme-customizer -a claude-code`. Or copy the skill folder (skills/fa-theme-customizer in fantastic-admin/basic) into .claude/skills/fa-theme-customizer in your project. Claude Code loads it when a task matches its description.

How do I install Fa Theme Customizer in Codex?

Run `npx skills add fantastic-admin/basic --skill fa-theme-customizer -a codex`. Or copy the skill folder (skills/fa-theme-customizer in fantastic-admin/basic) into .agents/skills/fa-theme-customizer in your project. Codex loads it when a task matches its description.

Can I use Fa Theme Customizer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add fantastic-admin/basic --skill fa-theme-customizer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/fa-theme-customizer, .gemini/skills/fa-theme-customizer, .github/skills/fa-theme-customizer and .opencode/skills/fa-theme-customizer in your project.

What does Fa Theme Customizer need to run?

SKILL.md names no scripts, command-line tools or credentials: Fa Theme Customizer is instructions for the agent only.

Does Fa Theme Customizer access the network?

SKILL.md names 1 domain. As links in the text: tweakcn.com. This is read from the text; nothing was executed.

Is Fa Theme Customizer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Fa Theme Customizer use?

Fa Theme Customizer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Fa Theme Customizer use?

About 1.3k tokens (SKILL.md is roughly 5.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4.3k tokens, read only when the agent opens those files.

What are the alternatives to Fa Theme Customizer?

Skills that share tags, products or a category with Fa Theme Customizer: Uithing (BayBreezy/ui-thing, 729 stars), Tailwind To Stylex (shadcn-labs/shadcn-cssinjs, 123 stars), UI UX Pro Max (Ohh-889/skyroc, 795 stars) and Atlas (pacifio/ui, 154 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Fa Theme Customizer?

fantastic-admin (a GitHub organization) maintains it in fantastic-admin/basic, which has 3,414 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on September 29, 2026.

Source: fantastic-admin/basic on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.