Agent skill

Uview Plus

by ijry in ijry/uview-plus

在 uni-app + Vue3 项目里使用 uview-plus 组件库时使用。覆盖 up-/u- 组件写法、easycom 接入、组件与图标清单、uni.$u 工具库、主题与暗黑模式、H5/小程序/App-nvue/鸿蒙多端差异。写页面、初次接入或升级 uview-plus、排查"组件不渲染/样式不生效/属性无效/图标空白"时都适用。

MITAuto-check passed

Install Uview Plus

skills CLI
$ npx skills add ijry/uview-plus --skill uview-plus -a claude-code

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

GitHub CLI
$ gh skill install ijry/uview-plus uview-plus --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/ijry/uview-plus.git skills-src && mkdir -p .claude/skills && cp -r skills-src/src/uni_modules/uview-plus/skills/uview-plus .claude/skills/uview-plus && 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
uview-plus
GitHub stars
719
Token cost
~915 tokens
SKILL.md length
175 words
Files
6 (incl. references)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

在 uni-app + Vue3 项目里使用 uview-plus 组件库时使用。覆盖 up-/u- 组件写法、easycom 接入、组件与图标清单、uni.$u 工具库、主题与暗黑模式、H5/小程序/App-nvue/鸿蒙多端差异。写页面、初次接入或升级 uview-plus、排查"组件不渲染/样式不生效/属性无效/图标空白"时都适用。

  • Works in 4 steps: pages.json 的 easycom.custom 里有… → main.js 里 app.use(uviewPlus) → App.vue 首行 @import… → …
  • SKILL.md covers 先确认接入完整, 硬规则, 一个可运行的样板 and 按需展开
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Uview Plus is an agent skill from ijry/uview-plus. 在 uni-app + Vue3 项目里使用 uview-plus 组件库时使用。覆盖 up-/u- 组件写法、easycom 接入、组件与图标清单、uni.$u 工具库、主题与暗黑模式、H5/小程序/App-nvue/鸿蒙多端差异。写页面、初次接入或升级 uview-plus、排查"组件不渲染/样式不生效/属性无效/图标空白"时都适用。

Its SKILL.md is about 920 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including reference files (for example `references/api.md`, `references/components.md` and `references/icons.md`).

It works with Vue.js. The repository describes itself as: 零云®uview-plus,是uni-app全面兼容nvue的uni-app生态框架,全面的组件和便捷的工具会让您信手拈来,如鱼得水。 The licence is MIT.

Example prompts

  • “组件不渲染/样式不生效/属性无效/图标空白”
  • “/uview-plus”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. pages.json 的 easycom.custom 里有 uview-plus 的三条规则
  2. main.js 里 app.use(uviewPlus)
  3. App.vue 首行 @import "uview-plus/index.scss";,且
  4. uni.scss 里 @import "uview-plus/theme.scss";

What it can do on your machine

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

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

  • Network

    Links to these hosts (documentation or services it may open):

    • uview-plus.jiangruyi.com

    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

Uview Plus loads about 915 tokens when it runs, and up to ~11k if it reads all its reference files. Until then it costs about 46 tokens; SKILL.md has 175 words of instructions outside code blocks.

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

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 ijry/uview-plus at commit e6e28b6, republished under its MIT licence (© ijry). 175 words, ~915 tokens.

Download SKILL.mdSave it as .claude/skills/uview-plus/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
uview-plus
description
在 uni-app + Vue3 项目里使用 uview-plus 组件库时使用。覆盖 up-*/u-* 组件写法、easycom 接入、组件与图标清单、uni.$u 工具库、主题与暗黑模式、H5/小程序/App-nvue/鸿蒙多端差异。写页面、初次接入或升级 uview-plus、排查"组件不渲染/样式不生效/属性无效/图标空白"时都适用。

uview-plus

uni-app 生态的 Vue3 组件库(fork 自 uView2)。139 个组件加一套 JS 工具库(uni.$u),一套代码覆盖 H5、微信/支付宝/头条/QQ 小程序、Android/iOS App(vue 与 nvue)、鸿蒙。

包的位置:npm 装法在 node_modules/uview-plus/,HBuilderX 装法在项目里的 uni_modules/uview-plus/。下文的相对路径都以这个包根目录为准,遇到不确定的用法优先读包内源码而不是凭印象写。

先确认接入完整

写页面之前先确认宿主项目这 4 处都配好了。缺任意一处的典型症状就是"组件写了不渲染""样式全丢""属性不生效",这类问题九成不是组件 bug:

  1. pages.json 的 easycom.custom 里有 uview-plus 的三条规则
  2. main.js 里 app.use(uviewPlus)
  3. App.vue 首行 @import "uview-plus/index.scss";,且 <style lang="scss">
  4. uni.scss 里 @import "uview-plus/theme.scss";

新项目接入、或上面任意一条没配,读 references/setup.md(npm 与 uni_modules 两种装法都有,含 manifest、tsconfig、nvue 的额外要求)。

硬规则

  1. 不要 import 组件。easycom 会按规则自动引入,模板里直接写 <up-button text="按钮"></up-button>。手写 import 反而容易和 easycom 规则打架。
  2. 前缀用 up-。u-、u-- 仍然兼容(三条 easycom 规则都指向同一份 components/u-*),但 u- 会和 uni-app 官方组件抢名字(例如 u-slider),新代码统一用 up-,同一项目里不要混用。
  3. 组件名从 references/components.md 里挑,不要凭印象拼。清单里没有的名字就是不存在,结果是编译报错或者整块不渲染。
  4. 属性、事件、插槽不要猜。一手说明在包内:
    • components/u-<名字>/u-<名字>.vue 顶部 JSDoc 的 @property / @event
    • components/u-<名字>/props.js 是属性的真实默认值(约四分之一的组件没有这个文件,属性直接写在 .vue 里)
    • types/comps/<驼峰名>.d.ts 是 TS 类型(覆盖常用组件,不是全部)
  5. 图标名从 references/icons.md 里挑。<up-icon name="star-fill"></up-icon>,名字写错不会报错,只是渲染空白。要用清单外的图标,走 customIcon 配置自己的字体图标。
  6. 双向绑定分两类,搞反了就是"弹窗打不开"或"输入框不联动":
    • 值类组件(up-input、up-checkbox-group、up-rate、up-slider、up-datetime-picker …)内部是 modelValue,写 v-model="xxx"
    • 显隐类组件(up-popup、up-action-sheet、up-modal、up-picker、up-cascader、up-tooltip、up-guide、up-swipe-action-item)内部是 show + update:show,写 v-model:show="show"
    • 其余组件先看它的 emits 数组再决定,不要想当然。
  7. 数值型尺寸的单位取决于 config.unit(默认 px,项目可全局改成 rpx)。要确定的单位就把单位写全:width="80px"。
  8. 组件内部尽量不要依赖宿主全局 class。需要覆盖样式时优先用组件自身的 customStyle / 具体属性,小程序有样式隔离,全局类不一定命中。

一个可运行的样板

vue
<template>
	<view>
		<up-navbar title="表单" :autoBack="true"></up-navbar>
		<up-form ref="formRef" :model="form" :rules="rules" labelWidth="80">
			<up-form-item label="手机号" prop="mobile" borderBottom>
				<up-input v-model="form.mobile" placeholder="请输入手机号" border="none"></up-input>
			</up-form-item>
		</up-form>
		<up-button type="primary" text="提交" @click="submit"></up-button>
		<up-popup v-model:show="show" mode="bottom">
			<view style="padding: 24px;">提交成功</view>
		</up-popup>
	</view>
</template>

<script setup>
import { reactive, ref } from 'vue'

const formRef = ref(null)
const show = ref(false)
const form = reactive({ mobile: '' })
const rules = {
	mobile: [{ required: true, message: '请输入手机号', trigger: ['blur', 'change'] }]
}

function submit() {
	formRef.value
		.validate()
		.then(() => {
			show.value = true
		})
		.catch(() => {
			uni.$u.toast('请检查表单')
		})
}
</script>

要点:up-form 的 validate() 返回 Promise(校验失败 reject 错误数组);uni.$u.* 在 .vue 与普通 .js 里都能用,不必 import。

按需展开

需要做的事读这个文件
装包、接入、easycom / scss / manifest / tsconfig / nvue Root 配置references/setup.md
挑组件、查某个组件的属性事件在哪references/components.md
用图标references/icons.md
路由、请求、校验、时间、主题、暗黑模式、多语言等 JS 能力references/api.md
组件不渲染、样式不生效、多端表现不一致、报错排查references/pitfalls.md

包内还有一手资料:changelog.md(版本变更,升级排查先看它)、types/(TS 声明)。当前版本看包内 package.json 的 version;uni.$u.config.v 只返回大版本 '3',不能用来判断补丁版本。

在线文档 https://uview-plus.jiangruyi.com ,与包内源码不一致时以源码为准。

© ijry, 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 5 other files (references) in src/uni_modules/uview-plus/skills/uview-plus of ijry/uview-plus.

  • SKILL.md
  • references/api.md
  • references/components.md
  • references/icons.md
  • references/pitfalls.md
  • references/setup.md

Open the folder on GitHubat commit e6e28b6

Compare with similar skills

Uview Plus 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.

Uview Plus compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Uview Plus this skillijry/uview-plus719—~915Automated safety check: PassMIT
Tailwindcss Developmentanonaddy/anonaddy4.9k10 repos~865Automated safety check: PassMIT
GSAP Core Animationgreensock/gsap-skills16k4 repos~3.7kAutomated safety check: PassMIT
GSAP in Vue, Nuxt and Sveltegreensock/gsap-skills16k4 repos~2.6kAutomated safety check: PassMIT
Vuetify Playgroundvuetifyjs/vuetify41k—~730Automated safety check: PassCustom licence
Inertia Vue Developmentanonaddy/anonaddy4.9k3 repos~3.4kAutomated safety check: PassMIT

Similar skills

  • Tailwindcss Development

    anonaddy/anonaddy

    Always invoke when the user's message includes 'tailwind' in any form.

    4.9k GitHub starsUsed in 10 repos~865 tokens
    Frontend & DesignAuto-check passed
  • GSAP Core Animation

    greensock/gsap-skills

    Covers the GSAP core API for tweens, easing, staggers, defaults and matchMedia, and when to choose GSAP over CSS animations or other JavaScript animation libraries.

    16k GitHub starsUsed in 4 repos~3.7k tokens
    Frontend & DesignAuto-check passed
  • GSAP in Vue, Nuxt and Svelte

    greensock/gsap-skills

    Shows how to use GSAP in Vue, Nuxt, Svelte and other lifecycle-based frameworks: create after mount, scope selectors to the component, and revert on unmount.

    16k GitHub starsUsed in 4 repos~2.6k tokens
    Frontend & DesignAuto-check passed
  • Vuetify Playground

    vuetifyjs/vuetify

    Maintains the Vuetify repo's local Playground.vue so contributors get a realistic reproduction and a short demo they can paste into a pull request description.

    41k GitHub stars~730 tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Inertia Vue Development

    anonaddy/anonaddy

    Develops Inertia.js v3 Vue client-side applications. An agent skill from anonaddy/anonaddy.

    4.9k GitHub starsUsed in 3 repos~3.4k tokens
    Auto-check passed
  • Web Clone

    Jane-xiaoer/claude-skill-web-clone

    网站复刻 / 克隆方法论。USE WHEN 用户说 复刻网站、克隆网站、clone website、抄个站、仿站、 照着这个站做一个、reproduce site、还原某个网页效果、把这个站搬下来改成我的、 复刻某个交互/WebGL/Canvas/Three.js 效果。提供「先拿真源码 → 判路径 → 逆向拆解 → 搭工程 → 替换内容」的可移植决策树,覆盖静态站 /…

    1k GitHub starsUsed in 1 repo~2.7k tokens
    Game DevelopmentAuto-check passed

Works with

Questions about Uview Plus

What does Uview Plus do?

在 uni-app + Vue3 项目里使用 uview-plus 组件库时使用。覆盖 up-/u- 组件写法、easycom 接入、组件与图标清单、uni.$u 工具库、主题与暗黑模式、H5/小程序/App-nvue/鸿蒙多端差异。写页面、初次接入或升级 uview-plus、排查"组件不渲染/样式不生效/属性无效/图标空白"时都适用。. Uview Plus is an agent skill from ijry/uview-plus.

How do I install Uview Plus in Claude Code?

Run `npx skills add ijry/uview-plus --skill uview-plus -a claude-code`. Or copy the skill folder (src/uni_modules/uview-plus/skills/uview-plus in ijry/uview-plus) into .claude/skills/uview-plus in your project. Claude Code loads it when a task matches its description.

How do I install Uview Plus in Codex?

Run `npx skills add ijry/uview-plus --skill uview-plus -a codex`. Or copy the skill folder (src/uni_modules/uview-plus/skills/uview-plus in ijry/uview-plus) into .agents/skills/uview-plus in your project. Codex loads it when a task matches its description.

Can I use Uview Plus 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 ijry/uview-plus --skill uview-plus -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/uview-plus, .gemini/skills/uview-plus, .github/skills/uview-plus and .opencode/skills/uview-plus in your project.

What does Uview Plus need to run?

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

Does Uview Plus access the network?

SKILL.md names 1 domain. As links in the text: uview-plus.jiangruyi.com. This is read from the text; nothing was executed.

Is Uview Plus 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 Uview Plus use?

Uview Plus 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 Uview Plus use?

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

What are the alternatives to Uview Plus?

Skills that share tags, products or a category with Uview Plus: Tailwindcss Development (anonaddy/anonaddy, 4.9k stars), GSAP Core Animation (greensock/gsap-skills, 16k stars), GSAP in Vue, Nuxt and Svelte (greensock/gsap-skills, 16k stars) and Vuetify Playground (vuetifyjs/vuetify, 41k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Uview Plus?

ijry (a GitHub user) maintains it in ijry/uview-plus, which has 719 GitHub stars. The repository was last updated on October 6, 2026.

Source: ijry/uview-plus on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.