Agent skill

Fa Form Builder

by fantastic-admin in fantastic-admin/basic

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

MITAuto-check passedFrontend & Design

Install Fa Form Builder

skills CLI
$ npx skills add fantastic-admin/basic --skill fa-form-builder -a claude-code

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

GitHub CLI
$ gh skill install fantastic-admin/basic fa-form-builder --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-form-builder .claude/skills/fa-form-builder && 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-form-builder
GitHub stars
3.4k
Token cost
~670 tokens
SKILL.md length
164 words
Files
2 (incl. references)
Skills in repo
9
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 4 steps: :收集基本信息 → :收集字段信息 → :判断布局 → …
  • Tasks that involve Forms and validation
  • SKILL.md covers 第一步:确认工作区(必须阻塞等待用户回复), 工作流程, 命名规范 and 代码模板
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Fa Form Builder is an agent skill from fantastic-admin/basic. 为 Fantastic-admin 框架生成独立的表单页面,使用 FaForm/FaFormItem + vee-validate + zod 验证,表单 model 使用 ref,全部使用框架内建 Fa 组件。当用户说:'帮我做一个用户信息填写页'、'我只需要一个提交表单,不需要列表'、'做个设置页面,有几个输入框和保存按钮'、'生成一个注册/编辑/配置表单页'、'只要表单页,不需要增删改查',即使用户只是说'做个表单页面'也应触发此技能。

Its SKILL.md is about 670 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/templates.md`).

It sits in Frontend & Design, covering Forms and validation. It works with Zod, Vue.js and shadcn/ui. 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

  • Tasks that involve Forms and validation

Example prompts

  • “帮我做一个用户信息填写页”
  • “我只需要一个提交表单,不需要列表”
  • “做个设置页面,有几个输入框和保存按钮”
  • “/fa-form-builder”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. :收集基本信息
  2. :收集字段信息
  3. :判断布局
  4. :确认并生成

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.

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

  • Network

    No URLs in SKILL.md.

    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 Form Builder loads about 670 tokens when it runs, and up to ~2.4k if it reads all its reference files. Until then it costs about 60 tokens; SKILL.md has 164 words of instructions outside code blocks.

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

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). 164 words, ~670 tokens.

Download SKILL.mdSave it as .claude/skills/fa-form-builder/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
fa-form-builder
description
为 Fantastic-admin 框架生成独立的表单页面,使用 FaForm/FaFormItem + vee-validate + zod 验证,表单 model 使用 ref,全部使用框架内建 Fa* 组件。当用户说:'帮我做一个用户信息填写页'、'我只需要一个提交表单,不需要列表'、'做个设置页面,有几个输入框和保存按钮'、'生成一个注册/编辑/配置表单页'、'只要表单页,不需要增删改查',即使用户只是说'做个表单页面'也应触发此技能。

表单页面生成器

在 Fantastic-admin 框架中生成独立的 Router 表单页面,使用 FaForm/FaFormItem 承接 vee-validate + zod 表单验证。

生成的文件:

  • apps/<app>/src/views/{path}/{name}/index.vue — 表单页面(含验证、提交骨架、固定操作栏)

第一步:确认工作区(必须阻塞等待用户回复)

本项目是 monorepo 架构,apps/ 目录下存放各应用。在执行任何文件读写操作之前,必须先确认目标应用:

  1. 执行 ls apps/ 列出所有可用应用
  2. 立即向用户提问,明确询问要在哪个应用中生成表单页面,并停止等待回复
  3. 收到用户明确回复后,才能继续后续步骤

严格规则:如果用户没有在请求中明确说明目标应用(例如"在 example 应用中"、"apps/core"),则必须提问,不得自行猜测或默认选择任何应用。

确认后,后续所有文件路径均以该应用目录为根。


工作流程

Step 1:收集基本信息

向用户询问(可合并为一次提问):

  1. 模块名(英文,用于文件路径,如 user、profile、setting)
  2. 模块中文名(用于页面标题,如 用户信息、个人资料)
  3. 存放路径(在 apps/<app>/src/views/ 下的子目录,如 system、account,留空则直接放在 src/views/ 下)
Step 2:收集字段信息

询问用户该表单有哪些字段,每个字段需要:

  • 字段名(英文,如 name、avatar、status)
  • 中文标签(如 姓名、头像、状态)
  • 字段类型(见 references/templates.md 中的字段类型映射表)
  • 是否必填

如果用户没有提供字段信息,使用默认字段 title(标题,string,必填)作为示例占位,并在生成后提示用户替换。

Step 3:判断布局

字段较多时单列会导致页面过长,双列更紧凑。根据字段数量和复杂度判断是否询问用户布局偏好:

  • 单列:max-w-600px,grid gap-6(字段少、字段较长时适合)
  • 双列:max-w-1200px,grid grid-cols-1 gap-x-8 gap-y-6 items-start md:grid-cols-2(字段多、字段较短时适合)
Step 4:确认并生成

汇总信息,展示将要生成的文件,确认后写入。

生成完成后提示:如需配置路由,请使用 fa-route-generator 技能;如需 API 模块,请使用 fa-crud-page-generator 或手动创建。


命名规范

给定模块名 name 和路径 path(相对于 apps/<app>/src/views/):

用途规则示例(path=system, name=user)
视图目录apps/<app>/src/views/{path}/{name}/apps/<app>/src/views/system/user/
组件名PascalCase({path}-{name}-form)SystemUserForm

代码模板

详细的代码模板和字段类型映射表见 references/templates.md。

生成代码时替换模板中的占位符:

  • {cname} → 模块中文名
  • {componentName} → PascalCase 组件名
  • {zodSchema} → zod 字段定义(每个必填字段对应一行 zod 规则)
  • {initialValues} → model 字段初始值(string 默认 '',boolean 默认 false,number 默认 0,array 默认 [])
  • {formItems} → 各字段对应的 FaFormItem 代码片段
  • {imports} → 必要的额外 import;默认留空,Fa* 组件通常由自动导入处理
  • {maxWidth} → 单列 max-w-600px / 双列 max-w-1200px
  • {gridClass} → 双列时 grid grid-cols-1 gap-x-8 gap-y-6 items-start md:grid-cols-2 / 单列时 grid gap-6

生成的代码是骨架:API 调用处用 // TODO: 注释标记,动态数据源(select options、upload action 等)用占位注释标记,用户根据实际接口替换。表单对象必须使用 const model = ref({...}),模板中直接 :model="model";脚本里读写字段使用 model.value.xxx。操作栏按钮使用 FaButton:取消用 variant="outline",提交用默认 variant 并传 :loading="loading"。

© 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 1 other file (references) in skills/fa-form-builder of fantastic-admin/basic.

  • SKILL.md
  • references/templates.md

Open the folder on GitHubat commit 1b5961e

Compare with similar skills

Fa Form Builder 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 Form Builder compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Fa Form Builder this skillfantastic-admin/basic3.4k—~670Automated safety check: PassMIT
Reglevictorgarciaesgi/regle506—~840Automated safety check: PassMIT
Buzzformbuildnbuzz/buzzform101—~1.5kAutomated safety check: PassMIT
Regle Migrate Vuelidatevictorgarciaesgi/regle506—~752Automated safety check: PassMIT
Opik Frontend Patternscomet-ml/opik22k—~1.1kAutomated safety check: PassApache-2.0
Regle Schemasvictorgarciaesgi/regle506—~485Automated safety check: PassMIT

Similar skills

  • Regle

    victorgarciaesgi/regle

    Core Regle form validation in Vue 3 — setup with useRegle, the reactive r$ object, validation properties, displaying errors, and modifiers.

    506 GitHub stars~840 tokensUpdated 9 days ago
    Frontend & DesignAuto-check passed
  • Buzzform

    buildnbuzz/buzzform

    A skill your agent uses when working with BuzzForm schema-driven forms, @buildnbuzz/form-core, @buildnbuzz/form-react, or any related APIs like defineSchema, InferType, FormProvider, useDataField…

    101 GitHub stars~1.5k tokensUpdated 4 mo ago
    Frontend & DesignAuto-check passed
  • Regle Migrate Vuelidate

    victorgarciaesgi/regle

    Migrate Vuelidate form validation to Regle. An agent skill from victorgarciaesgi/regle.

    506 GitHub stars~752 tokensUpdated 9 days ago
    Frontend & DesignAuto-check passed
  • Sets the conventions for the Opik React frontend: TanStack Query for data, Zustand for shared state, one-way layer imports and a fix for Google Translate crashes.

    22k GitHub stars~1.1k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Regle Schemas

    victorgarciaesgi/regle

    Validate Regle forms with schema libraries via @regle/schemas — Zod, Valibot, ArkType, and any Standard Schema spec library using useRegleSchema, useRules, refineRules, and InferInput.

    506 GitHub stars~485 tokensUpdated 9 days ago
    Frontend & DesignAuto-check passed
  • Frontend Patterns Template

    bybren-llc/safe-agentic-workflow

    Frontend patterns for modern web frameworks, component libraries, auth flows, and analytics. Use when building UI components, creating pages, implementing…

    421 GitHub stars~2k tokensUpdated 2 mo 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 Theme Customizer

    fantastic-admin/basic

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

    3.4k GitHub stars~1.3k 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

Questions about Fa Form Builder

What does Fa Form Builder do?

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

When should I use Fa Form Builder?

Fa Form Builder fits situations like: tasks that involve Forms and validation.

How do I install Fa Form Builder in Claude Code?

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

How do I install Fa Form Builder in Codex?

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

Can I use Fa Form Builder 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-form-builder -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-form-builder, .gemini/skills/fa-form-builder, .github/skills/fa-form-builder and .opencode/skills/fa-form-builder in your project.

What does Fa Form Builder need to run?

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

Does Fa Form Builder access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Fa Form Builder 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 Form Builder use?

Fa Form Builder 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 Form Builder use?

About 670 tokens (SKILL.md is roughly 2.7k 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 1.7k tokens, read only when the agent opens those files.

What are the alternatives to Fa Form Builder?

Skills that share tags, products or a category with Fa Form Builder: Regle (victorgarciaesgi/regle, 506 stars), Buzzform (buildnbuzz/buzzform, 101 stars), Regle Migrate Vuelidate (victorgarciaesgi/regle, 506 stars) and Opik Frontend Patterns (comet-ml/opik, 22k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Fa Form Builder?

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.