Skip to main content
skill CX Codex

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.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add uni-helper/skills --skill uni-helper -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/uni-helper/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/uni-helper/

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

Similar skills

Everything for Frontend and UI →

From the same set4

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor