Agent skill

Install Ability

by openvetta in openvetta/open-vetta

在本机 Vetta 中安装能力——插件(plugin)、Skill/场景(scene)与 MCP 服务器。用户说「装一个插件 / install plugin / 从能力市场安装 / 加一个 MCP server / 配置 MCP / 装个 skill」,或插件装完没生效、需要 reload、pending 版本没应用时使用。不用于安装 npm 依赖、IDE…

Apache-2.0Auto-check passedAgent Workflows

Install Install Ability

skills CLI
$ npx skills add openvetta/open-vetta --skill install-ability -a claude-code

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

GitHub CLI
$ gh skill install openvetta/open-vetta install-ability --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/openvetta/open-vetta.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/skill-presets/install-ability .claude/skills/install-ability && 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
install-ability
GitHub stars
291
Token cost
~1.2k tokens
SKILL.md length
259 words
Files
2
Skills in repo
21
Repo updated
First seen
Licence
Apache-2.0

At a glance

在本机 Vetta 中安装能力——插件(plugin)、Skill/场景(scene)与 MCP 服务器。用户说「装一个插件 / install plugin / 从能力市场安装 / 加一个 MCP server / 配置 MCP / 装个 skill」,或插件装完没生效、需要 reload、pending 版本没应用时使用。不用于安装 npm 依赖、IDE…

  • Works in 5 steps: 通用前置 → 插件 → Skill 与场景 → …
  • Tasks that involve MCP servers
  • SKILL.md covers 1. 通用前置, 2. 插件, 3. Skill 与场景 and 4. MCP 服务器, plus 1 more section
  • Calls npx and node

What it does

Install Ability is an agent skill from openvetta/open-vetta. 在本机 Vetta 中安装能力——插件(plugin)、Skill/场景(scene)与 MCP 服务器。用户说「装一个插件 / install plugin / 从能力市场安装 / 加一个 MCP server / 配置 MCP / 装个 skill」,或插件装完没生效、需要 reload、pending 版本没应用时使用。不用于安装 npm 依赖、IDE 插件、浏览器扩展,也不用于开发插件(那是 plugin-workbench)或创作 Skill(那是 create-skill)。

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `ability.json`).

It sits in Agent Workflows, covering MCP servers. It works with Model Context Protocol and npm. The repository describes itself as: Open-source, local-first AI agent for coding and real work. BYOK models, MCP, skills, plugins, workflows, and private knowledge bases. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve MCP servers

Example prompts

  • “/install-ability”

Requirements

  • Node.js

Workflow steps

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

  1. 通用前置
  2. 插件
  3. Skill 与场景
  4. MCP 服务器
  5. 报告

What it can do on your machine

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

    Shell commands in SKILL.md call:

    • npx
    • node

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

  • Network

    No URLs in SKILL.md. Its commands use npx, 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

Install Ability loads about 1.2k tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 259 words of instructions outside code blocks.

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

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 openvetta/open-vetta at commit a2d314a, republished under its Apache-2.0 licence (© openvetta). 259 words, ~1,192 tokens.

Download SKILL.mdSave it as .claude/skills/install-ability/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
install-ability
description
在本机 Vetta 中安装能力——插件(plugin)、Skill/场景(scene)与 MCP 服务器。用户说「装一个插件 / install plugin / 从能力市场安装 / 加一个 MCP server / 配置 MCP / 装个 skill」,或插件装完没生效、需要 reload、pending 版本没应用时使用。不用于安装 npm 依赖、IDE 插件、浏览器扩展,也不用于开发插件(那是 plugin-workbench)或创作 Skill(那是 create-skill)。
metadata.version
1.0.0
metadata.author
Vetta
metadata.category
开发

在 Vetta 中安装能力

Vetta 的能力分三种,安装路径互不相同。先分类,再动手。

用户给的东西类型安装路径
npm 包名、.zip、http(s) zip 链接、本地插件工程目录插件vetta-plugin-cli add → 按需 reload(§2)
能力市场里的插件条目插件引导用户在能力市场页安装(§2.6)
能力市场里的 skill / scene(有 slug)Skill / 场景skills.manage install-from-market(§3)
用户自己写的 / 仓库里的 SKILL.mdSkill / 场景交给 create-skill skill(§3.2)
command + args,或一个 MCP 的 http urlMCPmcp.manage upsert(§4)

分不清时先问用户,不要凭包名猜类型:npm 上的 @modelcontextprotocol/server-* 是 MCP,不是 Vetta 插件。

1. 通用前置

  • 只在用户明确要求安装时执行。当前任务缺某个工具,不构成自行安装能力的理由。
  • 所有写操作都会弹宿主审批。用户拒绝就停下并如实报告,不要改走别的路子达成同一效果。
  • 禁止直接改注册表:~/.vetta/plugins/、~/.vetta/plugins-manifest.json、~/.vetta/skills-manifest.json(市场安装的部分)、~/.vetta/agent/mcp.json 都由宿主维护,手写会与宿主状态错位。
  • 安装源来自用户。第三方 zip / http 链接在安装前把来源念给用户确认一次。

2. 插件

2.1 命令入口
bash
npx @vetta-org/plugin-cli add <npm-package|./local.zip|https://…/x.zip|.>
npx @vetta-org/plugin-cli reload <plugin-id>

. 表示「当前插件工程」(会先 pack)。加 --json 便于解析结果。

npx 不可用或离线时,用系统插件「制作插件」内置的同一份 CLI:先 plugins.query → {"operation":"get","id":"plugin-workbench"} 取 rootPath,再

bash
node "{workbenchRoot}/agent/cli/vetta-plugin-cli.js" add <source> --json

CLI 不直接写插件目录,它把请求交给正在运行的宿主校验、审批、安装。npm 包会以关闭生命周期脚本的方式下载,只解出 package.json#vetta.archive 声明的那个归档。

2.2 安装后必须重载(本 skill 的核心)
  • 首次安装:宿主直接启用,输出 Installed <id>@<version>. —— 到此结束。

  • 覆盖升级已装插件:宿主把新版本挂成 pending,输出

    Installed <id>@<old>. Update <new> is pending reload. Run `vetta-plugin-cli reload <id>` to apply it.

    此刻插件仍在跑旧代码。安装动作没有完成,必须立刻重载:

    bash
    npx @vetta-org/plugin-cli reload <plugin-id>

--json 下的判据(不要靠读人类文案):

字段含义动作
result.plugin.pendingVersion 非空新版本待应用必须 reload
reload 返回 plugin.activeVersion当前生效版本应等于刚装的版本,否则报告异常

reload 走与 UI 相同的宿主审批流,用户确认后新版本才生效。

2.3 热更新是例外

改已安装插件、或对方是开发中的工程时,先 plugins.query → get <id>:

  • 返回项含 devWatch → 热更新已开启,源码构建成功后自动重载。不要 reload、不要重装。
  • 无 devWatch → 走 §2.1 / §2.2 常规流程。

开发迭代(不是安装)可以直接开热更新:在插件工程目录 npx @vetta-org/plugin-cli watch,--stop 关闭。

2.4 没有 CLI 时的等价调用
json
plugins.manage {"operation":"install-from-url","url":"https://…/x.zip"}
plugins.manage {"operation":"reload","id":"<plugin-id>"}

本地路径安装用 install-from-path(zip 绝对路径 + "enable": true)。若目标是「制作插件」工作台里的工程,改为引导用户点面板的「应用到 Vetta」,那条路径不弹确认。

2.5 退出码

0 成功 · 2 参数错 · 3 连不上宿主(Vetta 没运行,或 VETTA_CONFIG_DIR/VETTA_HOME 指到了别的环境)· 4 宿主拒绝(权限、id 冲突、系统插件不可覆盖)· 5 其它失败。遇到 3 先让用户确认 Vetta 桌面端在前台运行,不要反复重试。

2.6 能力市场里的插件

市场插件没有 Agent 侧的按 slug 安装动作。用 navigation.open 打开能力市场页,让用户点安装;装完再按 §2.7 校验即可。

2.7 校验

plugins.query → {"operation":"get","id":"<id>"},确认 enabled === true、activeVersion 是目标版本、pendingVersion 不存在。

3. Skill 与场景

3.1 从能力市场装
json
skills.manage {"operation":"install-from-market","type":"skill","slug":"<slug>"}

type 为 "skill" 或 "scene"。slug 不确定就别猜:用 navigation.open 打开能力市场让用户挑,拿到准确 slug 再装。

Skill 不需要 reload,装完即进入能力页。校验:skills.query {"operation":"manifest"},确认目标 name 在清单里且 enabled: true。

3.2 本地 / 自己写的 Skill

不要在这里手搓目录和清单——按 create-skill skill 的流程做(全局 ~/.vetta/skills/<name>/、项目 <root>/.vetta/skills/<name>/、插件 agent/skills/<name>/ 各有各的注册方式)。

3.3 启停与卸载
json
skills.manage {"operation":"set-enabled","name":"<name>","enabled":false}
skills.manage {"operation":"uninstall","name":"<name>"}

卸载前先 skills.query manifest 核对真实 type,类型对不上宿主会直接拒绝。

4. MCP 服务器

json
mcp.manage {"operation":"upsert","name":"filesystem",
  "data":{"command":"npx","args":["-y","@modelcontextprotocol/server-filesystem","/abs/dir"]}}

mcp.manage {"operation":"upsert","name":"remote",
  "data":{"type":"http","url":"https://example.com/mcp","headers":{"Authorization":"Bearer …"}}}
  • 缺省是 stdio;http 必须显式写 "type":"http"。可选字段:env、cwd、disabled、autoApprove、startupTimeout、debug。
  • 密钥只从用户处取,放进 env / headers,不要写进仓库文件、不要回显到聊天里。
  • upsert 同名即覆盖,用它做「更新配置」,不要先 remove 再加。
  • 校验:mcp.query {"operation":"get","name":"<name>"}(密钥字段会脱敏)。起不来时,先把 command args 在终端手跑一次看报错,再改配置——不要靠反复 upsert 试。
  • 停用 / 删除:mcp.manage set-enabled / remove。
  • 新装 MCP 的工具在当前会话里可能要等宿主重连才出现。这不是安装失败,别为了让工具出现而重装。

5. 报告

安装结束后向用户说明:装了什么类型、id/name 与版本、是否执行了 reload 及重载后的 activeVersion、校验结果,以及任何被用户拒绝或未能执行的步骤。不要把「已提交安装请求」说成「已安装成功」。

© openvetta, Apache-2.0. 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 1 other file in packages/skill-presets/install-ability of openvetta/open-vetta.

  • SKILL.md
  • ability.json

Open the folder on GitHubat commit a2d314a

Compare with similar skills

Install Ability 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.

Install Ability compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Install Ability this skillopenvetta/open-vetta291—~1.2kAutomated safety check: PassApache-2.0
MCP Server BuildershareAI-lab/learn-claude-code78k5 repos~1.2kAutomated safety check: PassMIT
Yahoo Finance2gadicc/yahoo-finance2801—~1.8kAutomated safety check: PassMIT
Workflow Schema Tuningbreaking-brake/cc-wf-studio5.4k—~1.3kAutomated safety check: PassCustom licence
Paseo Plugin Buildergetpaseo/paseo20k—~9.4kAutomated safety check: PassCustom licence
Context Mode Doctormksglu/context-mode26k—~262Automated safety check: PassCustom licence

Similar skills

  • MCP Server Builder

    shareAI-lab/learn-claude-code

    Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.

    78k GitHub starsUsed in 5 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • Yahoo Finance2

    gadicc/yahoo-finance2

    A skill your agent uses when building with the yahoo-finance2 TypeScript/Deno/npm library, using its Yahoo Finance data modules, CLI, or MCP server, or contributing to the yahoo-finance2 repository…

    801 GitHub stars~1.8k tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed
  • Workflow Schema Tuning

    breaking-brake/cc-wf-studio

    Guides edits to cc-wf-studio's workflow schema so AI agents generate better workflows, treating schema text as prompt engineering rather than validation.

    5.4k GitHub stars~1.3k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Paseo Plugin Builder

    getpaseo/paseo

    Builds, installs and troubleshoots trusted local Paseo plugins, from lifecycle hooks and slash commands to screens, themes and timeline renderers.

    20k GitHub stars~9.4k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Context Mode Doctor

    mksglu/context-mode

    Run context-mode diagnostics. Checks runtimes, hooks, FTS5, plugin registration, npm and marketplace versions. Trigger: /context-mode:ctx-doctor

    26k GitHub stars~262 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Sets up and drives Ruflo, an npm-installed orchestration layer for multi-agent swarms, persistent memory, routing, hooks and its MCP tool catalog.

    74k GitHub starsUsed in 1 repo~975 tokens
    Agent WorkflowsAuto-check passed

More from openvetta/open-vetta

All 21 skills in this repo
  • Mobile Android Design

    openvetta/open-vetta

    Master Material Design 3 and Jetpack Compose patterns for building native Android apps.

    291 GitHub starsUsed in 3 repos~950 tokens
    Auto-check passed
  • Publish Ability

    openvetta/open-vetta

    Publish a skill, scene, MCP server, plugin, or bundle to the Vetta ability marketplace.

    291 GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Plugin Workbench

    openvetta/open-vetta

    Create, implement, build, pack, install, reload, and manage Vetta desktop plugins for non-developers.

    291 GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Create Skill

    openvetta/open-vetta

    Create or update Vetta-compatible Agent Skills. An agent skill from openvetta/open-vetta.

    291 GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Mobile UI Design

    openvetta/open-vetta

    Design mobile-style HTML pages (iOS / Android) for preview in the Mobile UI Preview panel.

    291 GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Remotion Video

    openvetta/open-vetta

    Create, modify, and render Remotion React video projects in the current Vetta conversation workspace.

    291 GitHub stars~744 tokensUpdated today
    Auto-check passed

Categories

Questions about Install Ability

What does Install Ability do?

在本机 Vetta 中安装能力——插件(plugin)、Skill/场景(scene)与 MCP 服务器。用户说「装一个插件 / install plugin / 从能力市场安装 / 加一个 MCP server / 配置 MCP / 装个 skill」,或插件装完没生效、需要 reload、pending 版本没应用时使用。不用于安装 npm 依赖、IDE…. Install Ability is an agent skill from openvetta/open-vetta.

When should I use Install Ability?

Install Ability fits situations like: tasks that involve MCP servers.

How do I install Install Ability in Claude Code?

Run `npx skills add openvetta/open-vetta --skill install-ability -a claude-code`. Or copy the skill folder (packages/skill-presets/install-ability in openvetta/open-vetta) into .claude/skills/install-ability in your project. Claude Code loads it when a task matches its description.

How do I install Install Ability in Codex?

Run `npx skills add openvetta/open-vetta --skill install-ability -a codex`. Or copy the skill folder (packages/skill-presets/install-ability in openvetta/open-vetta) into .agents/skills/install-ability in your project. Codex loads it when a task matches its description.

Can I use Install Ability 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 openvetta/open-vetta --skill install-ability -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/install-ability, .gemini/skills/install-ability, .github/skills/install-ability and .opencode/skills/install-ability in your project.

What does Install Ability need to run?

Going by SKILL.md and its folder, Install Ability needs the command-line tools its instructions call (npx and node). Our summary lists: Node.js.

Does Install Ability access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Install Ability 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 Install Ability use?

Install Ability is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Install Ability use?

About 1.2k tokens (SKILL.md is roughly 4.8k 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 Install Ability?

Skills that share tags, products or a category with Install Ability: MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), Yahoo Finance2 (gadicc/yahoo-finance2, 801 stars), Workflow Schema Tuning (breaking-brake/cc-wf-studio, 5.4k stars) and Paseo Plugin Builder (getpaseo/paseo, 20k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Install Ability?

openvetta (a GitHub organization) maintains it in openvetta/open-vetta, which has 291 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on October 8, 2026.

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