uni-helper — Claude Code skill: reference for uni-app tooling
A skill reference for the uni-helper ecosystem: Vite plugins, libraries and utilities for uni-app. Useful when your agent writes uni-app code.
npx skills add uni-helper/skills --skill uni-helper -a claude-codeWhat uni-helper does
The skill is generated from uni-helper documentation and split into sections: Vite plugins, libraries, utilities, project starters. Each topic lives in its own file under references/, so the agent pulls in only the part it needs when a matching package shows up in your project.
The plugin section covers file-based routing, a Nuxt-like layouts system, automatic component imports, manifest.json written in TypeScript, per-platform compilation through file naming, attribute and directive modifiers, and routing middleware. The libraries cover VueUse-style composables, a promise-based HTTP client, promise wrappers for uni-app APIs, and TypeScript types for templates. Utilities handle environment detection and an UnoCSS preset, and there are two starters: the create-uni CLI and a Vite template.
One section lists the recommended plugin order in vite.config.ts: the official Uni() plugin goes last, everything else before it. Get that wrong and the config misbehaves, so it is the first thing worth checking in an inherited setup.
What it helps with
- add file-based routing to a uni-app project
- set up automatic component imports
- write manifest.json in TypeScript
- split code per platform by file name
- get the Vite plugin order right
Example prompts for the agent
- Show me how to set up file-based routing with vite-plugin-uni-pages
- What is the correct plugin order for uni-helper in vite.config.ts?
- Walk me through adding uni-network to a uni-app project
How to install uni-helper
1Skills CLI (Vercel)
npx skills add uni-helper/skills --skill uni-helper -a claude-code2Manually: put the files in place
~/.claude/skills/uni-helper/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/uni-helper/
1Skills CLI (Vercel)
npx skills add uni-helper/skills --skill uni-helper -a codex2Manually: put the files in place
.agents/skills/uni-helper/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add uni-helper/skills --skill uni-helper -a cursor2Manually: put the files in place
.cursor/skills/uni-helper/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install uni-helper/skills uni-helper2Manually: put the files in place
.github/skills/uni-helper/SKILL.md1Skills CLI (Vercel)
npx skills add uni-helper/skills --skill uni-helper -a gemini-cli2Platform CLI
gemini skills install https://github.com/uni-helper/skills --path skills/uni-helperManually: put the files in place
.devin/skills/uni-helper/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add uni-helper/skills --skill uni-helper -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about uni-helper
How do I install uni-helper in Claude?
Run npx skills add uni-helper/skills --skill uni-helper -a claude-code. The skill lands in ~/.claude/skills/uni-helper/SKILL.md.
What does uni-helper do?
It is a reference for the uni-helper ecosystem in uni-app: Vite plugins, libraries, utilities and starters. The agent consults it when those packages appear in your project.
Which platforms can install this skill?
Besides Claude there are install paths for Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode. Copilot uses a different command: gh skill install uni-helper/skills uni-helper.
Source text
SKILL.md · MIT
---
name: uni-helper
description: Comprehensive skill reference for uni-helper ecosystem - AI-powered development tools for uni-app
metadata:
author: FlippeDround
version: "2026.1.30"
source: Generated from https://github.com/uni-helper/website, skills located at https://github.com/uni-helper/ai-tools
---
> The skill is based on uni-helper documentation, generated at 2026-01-30.
uni-helper is an ecosystem of AI-powered development tools for uni-app, providing Vite plugins, utility libraries, TypeScript support, and development tools to enhance the uni-app development experience.
## Vite Plugins
| Topic | Description | Reference |
|-------|-------------|-----------|
| vite-plugin-uni-pages | File-based routing system for uni-app with auto page discovery | [plugin-pages](references/plugin-pages.md) |
| vite-plugin-uni-layouts | Nuxt-like layouts system for uni-app | [plugin-layouts](references/plugin-layouts.md) |
| vite-plugin-uni-components | On-demand automatic component imports | [plugin-components](references/plugin-components.md) |
| vite-plugin-uni-manifest | Write manifest.json in TypeScript | [plugin-manifest](references/plugin-manifest.md) |
| vite-plugin-uni-platform | File-based platform compilation (*.h5|mp-weixin|app.*) | [plugin-platform](references/plugin-platform.md) |
| vite-plugin-uni-platform-modifier | Platform modifiers for attributes/directives | [plugin-platform-modifier](references/plugin-platform-modifier.md) |
| vite-plugin-uni-middleware | Middleware support for uni-app routing | [plugin-middleware](references/plugin-middleware.md) |
## Libraries
| Topic | Description | Reference |
|-------|-------------|-----------|
| uni-use | VueUse-style composable utilities for uni-app | [lib-uni-use](references/lib-uni-use.md) |
| uni-network | Promise-based HTTP client for uni-app | [lib-uni-network](references/lib-uni-network.md) |
| uni-promises | Promise wrappers for uni-app APIs | [lib-uni-promises](references/lib-uni-promises.md) |
| uni-typed | TypeScript type definitions for uni-app templates | [lib-uni-typed](references/lib-uni-typed.md) |
## Utilities
| Topic | Description | Reference |
|-------|-------------|-----------|
| uni-env | Environment detection utilities for uni-app | [util-uni-env](references/util-uni-env.md) |
| unocss-preset-uni | UnoCSS preset for uni-app | [util-unocss-preset](references/util-unocss-preset.md) |
## Project Starters
| Topic | Description | Reference |
|-------|-------------|-----------|
| create-uni | CLI scaffolding tool for uni-app projects | [starter-create-uni](references/starter-create-uni.md) |
| vitesse-uni-app | Vite-powered uni-app starter template | [starter-vitesse](references/starter-vitesse.md) |
## Plugin Order Best Practices
When using multiple uni-helper Vite plugins, the recommended order is:
```ts
// vite.config.ts
export default defineConfig({
plugins: [
UniComponents(), // 1. Component auto-import
UniPages(), // 2. File-based routing
UniLayouts(), // 3. Layout system
UniManifest(), // 4. Manifest generation
UniPlatform(), // 5. Platform-specific files
UniPlatformModifier(), // 6. Platform modifiers
UniMiddleware(), // 7. Route middleware
Uni(), // 8. Official uni-app plugin (always last)
],
})
```
## Quick Start
Create a new uni-app project with create-uni:
```bash
# npm 7+, extra double-dash is needed
npm create uni@latest
# pnpm
pnpm create uni
# yarn
yarn create uni
```
## Official Resources
- Website: https://uni-helper.js.org
- GitHub: https://github.com/uni-helper
- NPM Scope: @uni-helper
© FlippeDround · MIT · uni-helper/skills