Agent skill

Admin Template Project Initializer

by southliu in southliu/south-admin-react

Removes the south-admin-react template's demo pages, components and menu entries, after a dry-run preview and your confirmation, and cleans up the matching imports.

MITAuto-check passedFrontend & Design

Install Admin Template Project Initializer

skills CLI
$ npx skills add southliu/south-admin-react --skill init-project -a claude-code

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

GitHub CLI
$ gh skill install southliu/south-admin-react init-project --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/southliu/south-admin-react.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/init-project .claude/skills/init-project && 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
init-project
GitHub stars
580
Token cost
~519 tokens
SKILL.md length
109 words
Files
4 (incl. scripts)
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

Removes the south-admin-react template's demo pages, components and menu entries, after a dry-run preview and your confirmation, and cleans up the matching imports.

  • Works in 5 steps: 执行清理脚本 → 确认流程(重要) → 脚本行为说明 → …
  • Removing the demo pages and sample content from a new south-admin-react project
  • SKILL.md covers Description and Instructions
  • Runs Python, JavaScript and Shell scripts from its folder; calls python, bash and pnpm

What it does

A Python cleanup script deletes the demo and content pages, a demo component, a content server folder, and the demo menu entry together with its Chinese and English locale strings, then removes the matching import and usage lines from the header component and the menu index file by exact string match.

The script always runs with a dry-run flag first, printing the files it would delete and the references it would edit, and the agent shows that list and asks for explicit confirmation before running the real deletion. It only touches files under the project root, safely skips any target that no longer exists so it can run twice, and skips a replacement with a warning if the surrounding file was already hand-edited so the string no longer matches exactly. After cleanup it suggests running lint and the dev server to confirm the project still builds.

When your agent uses it

  • Removing the demo pages and sample content from a new south-admin-react project
  • Stripping the demo showcase component and its menu entry before customizing the template
  • Cleaning up leftover demo imports after deleting template content

Example prompts

  • “Initialize this project and strip out all the template's demo content.”
  • “Run the dry-run cleanup first so I can see what would be deleted.”
  • “Remove the demo component and its menu entry from this admin template.”

Requirements

  • Python
  • bash or the provided run.sh wrapper on Windows

Workflow steps

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

  1. 执行清理脚本
  2. 确认流程(重要)
  3. 脚本行为说明
  4. 替换规则(精确匹配)
  5. 安全检查

What it can do on your machine

Read from SKILL.md and the folder at commit fcabbfa. 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

    Ships 3 files in scripts/ (Python, JavaScript and Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • bash
    • pnpm

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

  • Network

    No URLs in SKILL.md. Its commands use pnpm, which can reach the network depending on how they are called.

    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

Admin Template Project Initializer loads about 519 tokens when it runs. Until then it costs about 49 tokens; SKILL.md has 109 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~49
When it runs · the whole SKILL.md, loaded when a task matches
~519

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); the scripts in this folder are not scanned.

SKILL.md

The full file from southliu/south-admin-react at commit fcabbfa, republished under its MIT licence (© southliu). 109 words, ~519 tokens.

Download SKILL.mdSave it as .claude/skills/init-project/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
init-project
description
初始化整个项目,清除模板自带的示例内容(src/pages/demo、src/pages/content、src/components/Github、src/servers/content、menus/demo 及相关 i18n),并连带删除代码中的 import 与引用。执行时会先以 dry-run 预览将要删除的文件和将要修改的引用,经用户确认后再真正执行。

init-project

Description

初始化项目,丢弃模板自带的示例内容。该技能会调用 .claude/skills/init-project/scripts/ 下的 Python 清理脚本,删除以下目标并连带清理代码中的引用:

  • 页面:src/pages/demo/、src/pages/content/
  • 组件:src/components/Github/
  • 接口:src/servers/content/
  • 静态菜单:src/menus/demo.ts 及 src/menus/index.ts 中的 demo 引用
  • 国际化:src/locales/zh/content.ts、src/locales/en/content.ts

同时清理以下代码引用:

  • src/layouts/components/Header.tsx:删除 import Github from '@/components/Github'; 与 <Github /> 标签
  • src/menus/index.ts:删除 import { demo } from './demo'; 与 ...(demo as SideMenu[])

Instructions

1. 执行清理脚本

调用 Python 脚本完成清理,必须先做 dry-run 预览,再确认删除:

bash
# 1) dry-run 预览(不删除任何文件,仅打印将要删除的文件和将要修改的引用)
python .claude/skills/init-project/scripts/cleanup.py --dry-run

# 2) 确认无误后,真正执行删除
python .claude/skills/init-project/scripts/cleanup.py

或使用包装脚本(Windows 下推荐):

bash
bash .claude/skills/init-project/scripts/run.sh --dry-run   # 预览
bash .claude/skills/init-project/scripts/run.sh             # 执行
2. 确认流程(重要)
  1. 先运行 --dry-run,将脚本输出的「待删除文件清单」和「待修改引用清单」展示给用户。
  2. 明确询问用户是否确认执行删除。
  3. 用户确认后再运行不带 --dry-run 的命令。
  4. 执行完成后,建议运行 pnpm lint 和 pnpm dev 验证项目可正常构建运行。
3. 脚本行为说明

脚本(cleanup.py)会:

  • 校验项目根目录(默认当前工作目录,可通过 --root <path> 指定)。
  • 计算所有待删除的文件/目录(仅删除存在的)。
  • 计算所有待修改的引用文件(按精确字符串匹配替换)。
  • --dry-run 模式下只输出计划,不写盘;非 dry-run 模式下执行删除与替换,并跳过已不存在的目标。
  • 仅做精确字符串替换,不会误伤业务代码;替换前会检查目标字符串是否存在。
4. 替换规则(精确匹配)
文件替换内容
src/layouts/components/Header.tsx删除 import Github from '@/components/Github';\n 整行,删除 <Github />\n 整行
src/menus/index.ts删除 import { demo } from './demo';\n 整行,将 ...(demo as SideMenu[]),\n 整行删除

注:脚本使用精确字符串匹配。如果上述文件已被人为修改导致字符串不再精确匹配,脚本会跳过该替换并在输出中提示「未找到匹配」,此时需人工检查。

5. 安全检查
  • 脚本默认不会删除脚本自身所在目录之外的任意文件,仅处理上述明确的目标。
  • 所有路径均相对项目根目录计算,不会跨项目删除。
  • 若目标已被删除(重复执行),脚本会安全跳过。

© southliu, 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 3 other files (scripts) in .claude/skills/init-project of southliu/south-admin-react.

  • SKILL.md
  • scripts/cleanup.py
  • scripts/init.mjs
  • scripts/run.sh

Open the folder on GitHubat commit fcabbfa

Compare with similar skills

Admin Template Project Initializer 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.

Admin Template Project Initializer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Admin Template Project Initializer this skillsouthliu/south-admin-react580—~519Automated safety check: PassMIT
Using Docs Kitlobehub/lobe-ui2.2k—~2.8kAutomated safety check: PassMIT
Building With Lobe UIlobehub/lobe-ui2.2k—~2kAutomated safety check: PassMIT
Local Testinglobehub/lobe-ui2.2k—~2.1kAutomated safety check: PassMIT
NEAR dApp Builderinternet-court/internet-court-skill6.5k1 repos~684Automated safety check: PassCustom licence
Migrate I18next To LinguiB0und/WikiSpeedrun133—~3.1kAutomated safety check: PassMIT

Similar skills

  • Using Docs Kit

    lobehub/lobe-ui

    Set up and author a documentation site with @lobehub/docs-kit (the lobedocs CLI, React Router + Vite static docs used by ui.lobehub.com).

    2.2k GitHub stars~2.8k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Building With Lobe UI

    lobehub/lobe-ui

    Build UI with the LobeHub design ecosystem — @lobehub/ui (plus its base-ui, chat, mobile, awesome, brand, mdx, i18n namespaces), @lobehub/icons, @lobehub/charts, @lobehub/fluent-emoji and…

    2.2k GitHub stars~2k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Local Testing

    lobehub/lobe-ui

    Local browser verification for the lobe-ui component library and documentation site.

    2.2k GitHub stars~2.1k tokensUpdated today
    Frontend & DesignAuto-check passed
  • NEAR dApp Builder

    internet-court/internet-court-skill

    Scaffolds new NEAR dApps with create-near-app or adds NEAR wallet sign-in, contract calls and transaction signing to an existing React or plain JavaScript app.

    6.5k GitHub starsUsed in 1 repo~684 tokens
    Frontend & DesignAuto-check passed
  • Migrate I18next To Lingui

    B0und/WikiSpeedrun

    Migrate i18next/react-i18next projects to Lingui. An agent skill from B0und/WikiSpeedrun.

    133 GitHub stars~3.1k tokensUpdated 20 days ago
    Frontend & DesignAuto-check passed
  • Rtdf

    any-tdf/any-tdf

    Build, review, and troubleshoot RTDF React applications using exact component APIs, themes, icons, localization, and scaffolding.

    779 GitHub stars~1.1k tokensUpdated 2 days ago
    Frontend & DesignAuto-check passed

More from southliu/south-admin-react

  • South Admin CRUD Generator

    southliu/south-admin-react

    Generates a full CRUD page - page component, data model and API client - from the south-admin-react project's own VS Code snippet templates.

    580 GitHub stars~1.7k tokensUpdated 19 days ago
    Auto-check passed

Questions about Admin Template Project Initializer

What does Admin Template Project Initializer do?

Removes the south-admin-react template's demo pages, components and menu entries, after a dry-run preview and your confirmation, and cleans up the matching imports. A Python cleanup script deletes the demo and content pages, a demo component, a content server folder, and the demo menu entry together with its Chinese and English locale strings, then removes the matching import and usage lines from the header component and the menu index file by exact string match.

When should I use Admin Template Project Initializer?

Admin Template Project Initializer fits situations like: removing the demo pages and sample content from a new south-admin-react project; stripping the demo showcase component and its menu entry before customizing the template; cleaning up leftover demo imports after deleting template content.

How do I install Admin Template Project Initializer in Claude Code?

Run `npx skills add southliu/south-admin-react --skill init-project -a claude-code`. Or copy the skill folder (.claude/skills/init-project in southliu/south-admin-react) into .claude/skills/init-project in your project. Claude Code loads it when a task matches its description.

How do I install Admin Template Project Initializer in Codex?

Run `npx skills add southliu/south-admin-react --skill init-project -a codex`. Or copy the skill folder (.claude/skills/init-project in southliu/south-admin-react) into .agents/skills/init-project in your project. Codex loads it when a task matches its description.

Can I use Admin Template Project Initializer 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 southliu/south-admin-react --skill init-project -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/init-project, .gemini/skills/init-project, .github/skills/init-project and .opencode/skills/init-project in your project.

What does Admin Template Project Initializer need to run?

Going by SKILL.md and its folder, Admin Template Project Initializer needs Python, JavaScript and a shell for the scripts in its folder and the command-line tools its instructions call (python, bash and pnpm). Our summary lists: Python; bash or the provided run.sh wrapper on Windows.

Does Admin Template Project Initializer 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 Admin Template Project Initializer 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Admin Template Project Initializer use?

Admin Template Project Initializer 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 Admin Template Project Initializer use?

About 519 tokens (SKILL.md is roughly 2.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Admin Template Project Initializer?

Skills that share tags, products or a category with Admin Template Project Initializer: Using Docs Kit (lobehub/lobe-ui, 2.2k stars), Building With Lobe UI (lobehub/lobe-ui, 2.2k stars), Local Testing (lobehub/lobe-ui, 2.2k stars) and NEAR dApp Builder (internet-court/internet-court-skill, 6.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Admin Template Project Initializer?

southliu (a GitHub user) maintains it in southliu/south-admin-react, which has 580 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on September 20, 2026.

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