Skip to content

README_en.md

Latest commit

 

History

History
175 lines (132 loc) · 8.89 KB

README_en.md

File metadata and controls

175 lines (132 loc) · 8.89 KB
Raw

volcengine-skills

Volcengine SKILL & CLI Survey

To improve your experience with Volcengine skill, we invite you to participate in our Survey with Prizes .

English | 简体中文

A skill marketplace maintained by the Volcengine team for AI coding agents including Claude Code, Codex, OpenCode, Cursor, and Gemini CLI. Only the core plugin is installed by default. Optional skills are grouped into Volcengine product-domain plugins and discovered through volcengine-find-skills.

Quick Install →

Plugins

Plugin Product domain Skills Default
volcengine-core Core volcengine-cli, volcengine-troubleshooting, volcengine-knowledge-search, volcengine-find-skills Yes
volcengine-storage Storage volcengine-tosutil No
volcengine-database Database volcengine-db-supabase No
volcengine-containers-middleware Containers and Middleware volcengine-vefaas No
volcengine-security Security volcengine-compliance No
volcengine-identity-access-control Identity and Access Control volcengine-landing-zone No
volcengine-service-support Service Support volcengine-sale, volcengine-prepare, volcengine-deploy, volcengine-iac, volcengine-api, volcengine-sdk-generator No

The core marketplace entry uses INSTALLED_BY_DEFAULT; all optional plugins use AVAILABLE. skills/ contains only the core/ category, whose skills are discovered automatically by the release tooling. Every optional skill is owned directly by its product-domain plugin and has no duplicate under skills/.

Skills

Skill Plugin Use case
volcengine-cli volcengine-core Create, query, and manage cloud resources with the ve CLI
volcengine-troubleshooting volcengine-core Diagnose Volcengine errors and resource issues
volcengine-knowledge-search volcengine-core Search and retrieve full official Volcengine documentation
volcengine-find-skills volcengine-core List every skill for the agent to select and install
volcengine-sale volcengine-service-support Sell Volcengine products
volcengine-prepare volcengine-service-support Analyze a repository and recommend ECS, VKE, or veFaaS
volcengine-deploy volcengine-service-support Deploy a local directory or Git repository to Volcengine
volcengine-iac volcengine-service-support Manage Volcengine infrastructure with Terraform
volcengine-tosutil volcengine-storage Manage TOS object storage resources
volcengine-db-supabase volcengine-database Manage Volcengine AI-native BaaS, Supabase edition (AIDAP)
volcengine-vefaas volcengine-containers-middleware Deploy and manage veFaaS serverless applications
volcengine-compliance volcengine-security Recommend baselines, report posture, and author custom rules
volcengine-landing-zone volcengine-identity-access-control Set up landing zones, account factories, and governance baselines
volcengine-api volcengine-service-support Query API parameters, errors, and response schemas
volcengine-sdk-generator volcengine-service-support Generate runnable SDK examples in supported languages

Default Installation

Finder Design

volcengine-find-skills embeds the single catalog for all core skills and every optional plugin skill:

  1. The finder triggers for explicit discovery and when the currently loaded or installed skills cannot cover a product, tool, or workflow required by an active Volcengine task.
  2. list returns the complete catalog so the agent can select the minimum skill set from names, product domains, summaries, and keywords.
  3. Installation requires exact skill names; plugins are classification metadata, not install targets.
  4. For every host, the finder installs selected skills directly through the skills CLI, never the whole plugin.
  5. After the installer exits successfully, the finder reads the host's installed list and returns verified: true only when every requested skill is visible.
  6. When a host cannot dynamically load a newly installed skill, start a new thread carrying the original task and completed context.

Codex

Add the marketplace and install only the core plugin:

codex plugin marketplace add volcengine/volcengine-skills
codex plugin add volcengine-core@volcengine-skills
codex plugin list

These plugin commands only bootstrap the core finder. Subsequent finder installs target exact skills.

In a new thread, ask for a skill by task, such as "find the object storage skill" or "install volcengine-tosutil". The finder reads the complete catalog, selects the appropriate skill, and installs that skill directly without installing its whole product-domain plugin. Start another thread when the current host cannot dynamically load new skills.

From a source checkout, discovery and status can be tested directly:

python3 plugins/volcengine-core/skills/volcengine-find-skills/scripts/find_skills.py list
python3 plugins/volcengine-core/skills/volcengine-find-skills/scripts/find_skills.py install volcengine-tosutil --agent codex
python3 plugins/volcengine-core/skills/volcengine-find-skills/scripts/find_skills.py status --agent codex

Generic skills CLI

This command installs only the current core skills:

npx skills add volcengine/volcengine-skills \
  --global --yes --copy --full-depth \
  --skill volcengine-cli volcengine-troubleshooting volcengine-knowledge-search volcengine-find-skills

The finder can later invoke npx skills add --skill for exact skills. To install every catalogued skill at once:

npx skills add volcengine/volcengine-skills --full-depth

Claude Code

/plugin marketplace add volcengine/volcengine-skills
/plugin install volcengine-core@volcengine-skills
/reload-plugins
/volcengine-core:volcengine-find-skills

Gemini CLI

gemini skills install https://github.com/volcengine/volcengine-skills --path skills/core/volcengine-cli
gemini skills install https://github.com/volcengine/volcengine-skills --path skills/core/volcengine-troubleshooting
gemini skills install https://github.com/volcengine/volcengine-skills --path skills/core/volcengine-knowledge-search
gemini skills install https://github.com/volcengine/volcengine-skills --path skills/core/volcengine-find-skills
gemini skills list

Approve each security prompt on first install, then restart Gemini CLI. Describe a Volcengine task directly or ask it to use volcengine-find-skills.

OpenCode

Follow the OpenCode instructions to mount the core plugin's skills/ directory.

Cursor

/add-plugin volcengine-core@https://github.com/volcengine/volcengine-skills
/volcengine-find-skills

Enter the complete command in a Cursor 2.5 or newer Agent chat. /add-plugin may not appear in autocomplete.

Directory Structure

volcengine-skills/
├── skills/
│   └── core/                         # core skills installed by the CLI
├── plugins/
│   ├── volcengine-core/              # default core plugin with core skills and hooks
│   └── volcengine-<domain>/          # optional plugin and authoritative skill source
└── .agents/plugins/marketplace.json

skills/core/ is authoritative for the core skills. Optional skills are maintained directly inside their owning plugins. The sync script copies core and generates manifests and marketplaces. After changing or adding a skill, run:

python3 scripts/sync_plugins.py
python3 scripts/validate_codex_plugin_layout.py
python3 -m unittest discover -s tests -v

License

MIT. See LICENSE.