Agent skill

Fa Route Generator

by fantastic-admin in fantastic-admin/basic

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

MITAuto-check passedFrontend & Design

Install Fa Route Generator

skills CLI
$ npx skills add fantastic-admin/basic --skill fa-route-generator -a claude-code

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

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

At a glance

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

  • Works in 3 steps: 收集路由信息 → 创建路由文件 → 更新 routes.ts
  • Frontend & Design work in your project
  • SKILL.md covers 第一步:确认工作区(必须阻塞等待用户回复), 前置检查, 工作流程 and 框架约定, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

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

Its SKILL.md is about 570 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/examples.md` and `references/route-meta.md`).

It sits in Frontend & Design. It works with 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

  • Frontend & Design work in your project

Example prompts

  • “新建了一个页面”
  • “/fa-route-generator”

Workflow steps

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

  1. 收集路由信息
  2. 创建路由文件
  3. 更新 routes.ts

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

    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 Route Generator loads about 565 tokens when it runs, and up to ~3.4k if it reads all its reference files. Until then it costs about 53 tokens; SKILL.md has 84 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~53
When it runs · the whole SKILL.md, loaded when a task matches
~565
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.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). 84 words, ~565 tokens.

Download SKILL.mdSave it as .claude/skills/fa-route-generator/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
fa-route-generator
description
管理 Vue Router 路由配置,用于 Fantastic-admin 框架。当用户提到以下任何需求时必须使用此技能:新建页面需要加路由、详情页不想显示在菜单里、新增页和编辑页老是开两个标签、从列表跳详情返回后状态丢失、给菜单项加 NEW 标签或红点、路由需要权限控制、配置页面保活、修改路由 meta、添加面包屑配置。即使用户只是说"加个路由"或"新建了一个页面",也应触发此技能。

路由生成器

框架通过路由自动生成导航菜单,路由配置需要遵循特定约定。

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

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

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

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

确认后,后续所有文件路径均以该应用目录为根,例如 apps/<app>/src/router/。

前置检查

读取 apps/<app>/src/settings.ts,检查 app.routeBaseOn 的值:

  • 'frontend'(默认):可以继续
  • 'backend':路由由后端驱动,手动创建的路由文件会被忽略,告知用户此模式不支持前端路由文件生成

工作流程

场景 A: 创建新路由
1. 收集路由信息

向用户询问或确认:路由路径、页面标题、图标(可选)、是否多级路由、所属主导航分组。

2. 创建路由文件

在 apps/<app>/src/router/modules/ 下创建 <模块名>.ts:

typescript
import type { RouteRecordRaw } from 'vue-router'

function Layout() {
  return import('@/layouts/index.vue')
}

const routes: RouteRecordRaw = {
  path: '/example',
  component: Layout,
  name: 'example',
  meta: {
    title: '示例',
    icon: 'i-ep:menu',
  },
  children: [
    {
      path: '',
      name: 'exampleIndex',
      component: () => import('@/views/example/index.vue'),
      meta: {
        title: '示例页面',
      },
    },
  ],
}

export default routes
3. 更新 routes.ts

在 apps/<app>/src/router/routes.ts 中添加 import 并注册到对应主导航分组的 children 数组。

场景 B: 修改现有路由

定位路由文件(在 apps/<app>/src/router/modules/ 下搜索),读取后按需修改 meta 属性。常见修改:

权限控制:

typescript
meta: { auth: 'user:view' }  // 或数组 ['user:view', 'user:edit']

页面保活(从详情返回列表时保留列表状态):

typescript
// 列表页
meta: { keepAlive: ['productDetail'] }
// 详情页
meta: { menu: false, activeMenu: '/product', noKeepAlive: 'productList' }

隐藏菜单项:

typescript
meta: { menu: false, activeMenu: '/parent/path' }

框架约定

  • 一级路由 path 必须以 / 开头,component 必须是 Layout
  • 子路由 path 不要以 / 开头
  • 多级路由的中间层级无需设置 component
  • 所有路由的 name 必须全局唯一

Meta 属性配置

详细属性说明见 references/route-meta.md,更多示例见 references/examples.md。

常用属性:title(必需)、icon、menu、auth、keepAlive、activeMenu、breadcrumb

© 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-route-generator of fantastic-admin/basic.

  • SKILL.md
  • references/examples.md
  • references/route-meta.md

Open the folder on GitHubat commit 1b5961e

Compare with similar skills

Fa Route Generator 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 Route Generator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Fa Route Generator this skillfantastic-admin/basic3.4k—~565Automated 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 today
    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 28 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 4 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 17 days ago
    Frontend & DesignAuto-check passed

More from fantastic-admin/basic

All 9 skills in this repo
  • Fa Slot Creator

    fantastic-admin/basic

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

    3.4k GitHub stars~565 tokensUpdated 10 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 10 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 10 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 10 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 10 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 10 days ago
    Auto-check passed

Works with

Questions about Fa Route Generator

What does Fa Route Generator do?

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

When should I use Fa Route Generator?

Fa Route Generator fits situations like: frontend & Design work in your project.

How do I install Fa Route Generator in Claude Code?

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

How do I install Fa Route Generator in Codex?

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

Can I use Fa Route Generator 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-route-generator -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-route-generator, .gemini/skills/fa-route-generator, .github/skills/fa-route-generator and .opencode/skills/fa-route-generator in your project.

What does Fa Route Generator need to run?

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

Does Fa Route Generator 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 Route Generator 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 Route Generator use?

Fa Route Generator 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 Route Generator use?

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

What are the alternatives to Fa Route Generator?

Skills that share tags, products or a category with Fa Route Generator: 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 Route Generator?

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.