you-skills

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

YouSkills

This skill provides guidance on YouSkills — a local-only visual manager for AI skills (Codex, Cursor, OpenClaw, custom paths). Use it when the user wants to install, run, troubleshoot, or integrate with YouSkills.

本技能提供YouSkills相关指南——YouSkills是一款纯本地运行的AI技能（Codex、Cursor、OpenClaw、自定义路径）可视化管理器。当用户想要安装、运行、排查问题或是集成YouSkills时可使用本技能。

What YouSkills Does

YouSkills功能

Local-only: Scans standard skill roots and user paths; strictly read-only, no cloud.
Web UI: Card/list views, filters, themes, i18n (zh/en).
Agent-friendly: HTTP API for skills list and manifest.

纯本地运行：扫描标准技能根目录和用户自定义路径；完全只读，无云端交互。
Web UI：支持卡片/列表视图、筛选、多主题、国际化（中/英）。
Agent友好：提供HTTP API用于获取技能列表和配置清单。

When to Use This Skill

何时使用本技能

User asks how to install or run you-skills.
User mentions "local skills", "visualize skills", "view my skills", "you-skills".
User has issues with
```
npx you-skills
```
(e.g. 404, registry, or "opened a file" instead of browser).
User wants to integrate an agent with local skills (API usage).

用户询问如何安装或运行you-skills时。
用户提到“本地技能”、“技能可视化”、“查看我的技能”、“you-skills”时。
用户使用
```
npx you-skills
```
遇到问题时（例如404、源相关问题，或是运行后只打开了一个文件而非浏览器）。
用户想要将Agent与本地技能集成（API使用）时。

Install & Run

安装与运行

Requires Node.js 18+.

要求Node.js 18及以上版本。

One-off (no global install)

一次性运行（无需全局安装）

bash

npx you-skills --registry=https://registry.npmjs.org/

bash

npx you-skills --registry=https://registry.npmjs.org/

Global install

全局安装

bash

npm install -g you-skills --registry=https://registry.npmjs.org/
you-skills

Note: If the user's default npm registry is a mirror (e.g. npmmirror), installs may 404. Always use

--registry=https://registry.npmjs.org/

for you-skills.

bash

npm install -g you-skills --registry=https://registry.npmjs.org/
you-skills

注意：如果用户的默认npm源是镜像站（例如npmmirror），安装可能会出现404。安装you-skills时请始终使用

--registry=https://registry.npmjs.org/

参数。

Port & Environment

端口与环境

URL:
```
http://localhost:12434
```
Port:
```
12434
```
Env (optional):
```
CODEX_HOME
```
,
```
CURSOR_HOME
```
for default scan paths.

访问地址：
```
http://localhost:12434
```
端口：
```
12434
```
可选环境变量：
```
CODEX_HOME
```
、
```
CURSOR_HOME
```
用于指定默认扫描路径。

Agent / Integration API

Agent / 集成API

```
GET /api/skills?root=
```
— List skills (default roots or custom
```
root
```
).

GET /api/skills/manifest

GET /api/manifest

— Structured manifest for agents.

```
GET /api/config
```
— Current config (classification_scheme_id, theme_id).
```
PATCH /api/config
```
— Update config.

PATCH /api/skills/category

— Update one skill’s category (writes to

~/.you-skills/category-cache.json

only).

```
GET /api/browse?path=
```
— List directories (for picking root).

```
GET /api/skills?root=
```
—— 列出技能（默认根目录或自定义
```
root
```
路径）。
```
GET /api/skills/manifest
```
或
```
GET /api/manifest
```
—— 供Agent使用的结构化配置清单。
```
GET /api/config
```
—— 当前配置（classification_scheme_id、theme_id）。
```
PATCH /api/config
```
—— 更新配置。

PATCH /api/skills/category

—— 更新单个技能的分类（仅写入

~/.you-skills/category-cache.json

）。

```
GET /api/browse?path=
```
—— 列出目录（用于选择根目录）。

Common Issues

常见问题

404 when installing
User may be using a mirror. Use
```
--registry=https://registry.npmjs.org/
```
for both
```
npm install
```
and
```
npx
```
.
“Only opened a file” after run
Ensure they run the command in a terminal (e.g.
```
you-skills
```
or
```
npx you-skills
```
), not by double-clicking
```
cli.js
```
. The CLI starts the server and opens the browser.
First-time / “real user” test
Clear app data: remove
```
~/.you-skills
```
(config + category cache). Use browser incognito or clear localStorage for
```
localhost:12434
```
to see consent and initial config again.

安装时出现404
用户可能使用了镜像源。执行
```
npm install
```
和
```
npx
```
命令时都请添加
```
--registry=https://registry.npmjs.org/
```
参数。
运行后“仅打开了一个文件”
请确保用户是在终端中执行命令（例如
```
you-skills
```
或
```
npx you-skills
```
），而不是双击
```
cli.js
```
文件。CLI工具会启动服务并自动打开浏览器。
首次使用/“真实用户”测试
清除应用数据：删除
```
~/.you-skills
```
目录（配置+分类缓存）。使用浏览器无痕模式，或是清除
```
localhost:12434
```
的localStorage数据，即可重新看到授权提示和初始配置页面。

you-skills

Original

Translation

YouSkills

YouSkills

What YouSkills Does

YouSkills功能

When to Use This Skill

何时使用本技能

Install & Run

安装与运行

One-off (no global install)

一次性运行（无需全局安装）

Global install

全局安装

Port & Environment

端口与环境

Agent / Integration API

Agent / 集成API

Common Issues

常见问题

Links

相关链接