Agent skill

Cv4pve Pepper

by Corsinvest in Corsinvest/cv4pve-pepper

Open the SPICE or VNC console of a Proxmox VE VM or container in a window on the user's desktop with cv4pve-pepper and remote-viewer, or write the parameter file and shortcut that does it.

GPL-3.0Auto-check passed

Install Cv4pve Pepper

skills CLI
$ npx skills add Corsinvest/cv4pve-pepper --skill cv4pve-pepper -a claude-code

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

GitHub CLI
$ gh skill install Corsinvest/cv4pve-pepper cv4pve-pepper --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/Corsinvest/cv4pve-pepper.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/cv4pve-pepper .claude/skills/cv4pve-pepper && 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
cv4pve-pepper
GitHub stars
150
Token cost
~884 tokens
SKILL.md length
442 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
GPL-3.0

At a glance

Open the SPICE or VNC console of a Proxmox VE VM or container in a window on the user's desktop with cv4pve-pepper and remote-viewer, or write the parameter file and shortcut that does it.

  • The user asks to open
  • SKILL.md covers Rules, Commands and Errors
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Connect to the console

What it does

Cv4pve Pepper is an agent skill from Corsinvest/cv4pve-pepper. Open the SPICE or VNC console of a Proxmox VE VM or container in a window on the user's desktop with cv4pve-pepper and remote-viewer, or write the parameter file and shortcut that does it. Use it when the user asks to open, see or connect to the console or screen of a VM. It opens a window for the user; it does not read the cluster or show you the screen.

Its SKILL.md is about 880 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with C# and .NET. The repository describes itself as: Open a Proxmox VE SPICE or VNC console from the command line. The licence is GPL-3.0.

When your agent uses it

  • The user asks to open
  • Connect to the console

Example prompts

  • “/cv4pve-pepper”

What it can do on your machine

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

    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):

    • corsinvest.github.io

    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

Cv4pve Pepper loads about 884 tokens when it runs. Until then it costs about 93 tokens; SKILL.md has 442 words of instructions outside code blocks.

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

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 Corsinvest/cv4pve-pepper at commit bcdd37b, republished under its GPL-3.0 licence (© Corsinvest). 442 words, ~884 tokens.

Download SKILL.mdSave it as .claude/skills/cv4pve-pepper/SKILL.md (or your agent's skills folder).
name
cv4pve-pepper
description
Open the SPICE or VNC console of a Proxmox VE VM or container in a window on the user's desktop with cv4pve-pepper and remote-viewer, or write the parameter file and shortcut that does it. Use it when the user asks to open, see or connect to the console or screen of a VM. It opens a window for the user; it does not read the cluster or show you the screen.

cv4pve-pepper

cv4pve-pepper asks Proxmox VE for a console ticket and starts remote-viewer with it: a window opens on the desktop of the machine where the command runs. It has no subcommands. The connection options (host and API token) and the path of the viewer (--viewer) are in a file the user names: if you do not know its path, ask.

Rules

  • Connect only with that file, passed with @. Do not print it or copy the token anywhere.
  • The window is for the user: you cannot see or use the console. Tell the user that a window opens.
  • Pass the exact id or name in --vmid. A pattern (%web%, 100:199) takes the first match by node name and id, which may not be the guest the user means: if the user gave only part of a name, ask.
  • --start-or-resume starts a stopped guest or resumes a paused one: it changes the cluster, with --dry-run too. Add it only after the user agrees to start that guest.
  • --dry-run does everything except starting the viewer: use it to check the connection, the guest and the privileges without opening a window.
  • SPICE is the default and pepper returns as soon as the viewer has started. With --vnc pepper runs until the user closes the viewer: start it in the background, or the command does not return.
  • In PowerShell or cmd on Windows the terminal does not wait for pepper and gives no exit code: run it with Start-Process cv4pve-pepper -ArgumentList '@<file>' -Wait -PassThru -NoNewWindow and read ExitCode. From bash it waits as any other command.
  • In an options file a value with spaces goes in quotes, as the path of the viewer on Windows: --viewer="C:\Program Files\VirtViewer v11.0-256\bin\remote-viewer.exe".
  • Exit code 0 means the viewer started (SPICE), ended normally (VNC), or the dry run prepared everything; 1 is an error, on a line starting ERROR:.
  • If an option is refused, check cv4pve-pepper --help: this skill can be newer than the tool.
Show full SKILL.md (117 more words)Show less

Commands

bash
cv4pve-pepper @<options-file> --vmid=<id|name> --dry-run          # check, no window
cv4pve-pepper @<options-file> --vmid=<id|name>                    # SPICE console
cv4pve-pepper @<options-file> --vmid=<id|name> --vnc              # VNC console; runs until the viewer is closed
cv4pve-pepper @<options-file> --vmid=<id|name> --start-or-resume  # after agreement: start it, then open

Errors

MessageWhat to do
ERROR: VM/CT '<x>' not found!Wrong id or name, or the token lacks VM.Audit on the guest
ERROR: no spice portThe display of the VM is not SPICE: use --vnc
ERROR: VM <id> not runningThe guest is stopped: ask the user whether to add --start-or-resume
ERROR: Start VM/CT <id> failed: …The start was refused or failed: often VM.PowerMgmt is missing
Option '--viewer' is required.The options file has no --viewer: ask the user for the path of remote-viewer

SPICE connects from the user's machine to the SPICE proxy on port 3128; VNC goes through the API port only. If the SPICE window opens and closes, try --vnc.

Documentation: https://corsinvest.github.io/cv4pve-pepper/

© Corsinvest, GPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/cv4pve-pepper of Corsinvest/cv4pve-pepper.

Open the folder on GitHubat commit bcdd37b

Compare with similar skills

Cv4pve Pepper 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.

Cv4pve Pepper compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cv4pve Pepper this skillCorsinvest/cv4pve-pepper150—~884Automated safety check: PassGPL-3.0
Minimax DOCXpoco-ai/poco-claw1.4k7 repos~3.9kAutomated safety check: PassMIT
Speckit ConstitutionWeihanLi/WeihanLi.Common24212 repos~2.1kAutomated safety check: PassApache-2.0
Analyzing .NET Performancedotnet/skills5.6k3 repos~3.1kAutomated safety check: PassMIT
Find Untested Sourcesmicrosoft/testfx1k2 repos~3.3kAutomated safety check: PassMIT
Add Analyzerdotnet/roslynator3.5k—~1.3kAutomated safety check: PassCustom licence

Similar skills

  • Minimax DOCX

    poco-ai/poco-claw

    Professional DOCX document creation, editing, and formatting using OpenXML SDK (.NET).

    1.4k GitHub starsUsed in 7 repos~3.9k tokens
    Documents & OfficeAuto-check passed
  • Speckit Constitution

    WeihanLi/WeihanLi.Common

    Create or update the project constitution from interactive or provided principle inputs, ensuring all dependent templates stay in sync.

    242 GitHub starsUsed in 12 repos~2.1k tokens
    DevelopmentAuto-check passed
  • Official

    Scans C# and .NET code for about 50 performance anti-patterns and reports prioritized findings with concrete fixes, at a scan depth you choose.

    5.6k GitHub starsUsed in 3 repos~3.1k tokens
    DevelopmentAuto-check passed
  • Find Untested Sources

    microsoft/testfx

    Official

    MANDATORY for static source-to-test pairing: find or list source files/modules without corresponding tests, or suggest test locations from repository structure.

    1k GitHub starsUsed in 2 repos~3.3k tokens
    MobileAuto-check passed
  • Add Analyzer

    dotnet/roslynator

    Official

    A skill your agent uses when adding a new RCS diagnostic in roslynator (RCS0 formatting, RCS1 general, RCS9 code-analysis), wiring roslynator EditorConfig options, or when docs say CHANGELOG.md…

    3.5k GitHub stars~1.3k tokensUpdated 6 days ago
    DevelopmentAuto-check passed
  • GitVersion .NET Development

    GitTools/GitVersion

    Gives repository-specific .NET guidance for GitVersion: build and test commands, central package management, project layout and coding conventions.

    3.1k GitHub stars~1.7k tokensUpdated today
    DevelopmentAuto-check passed

Works with

Questions about Cv4pve Pepper

What does Cv4pve Pepper do?

Open the SPICE or VNC console of a Proxmox VE VM or container in a window on the user's desktop with cv4pve-pepper and remote-viewer, or write the parameter file and shortcut that does it. Cv4pve Pepper is an agent skill from Corsinvest/cv4pve-pepper. Open the SPICE or VNC console of a Proxmox VE VM or container in a window on the user's desktop with cv4pve-pepper and remote-viewer, or write the parameter file and shortcut that does it.

When should I use Cv4pve Pepper?

Cv4pve Pepper fits situations like: the user asks to open; connect to the console.

How do I install Cv4pve Pepper in Claude Code?

Run `npx skills add Corsinvest/cv4pve-pepper --skill cv4pve-pepper -a claude-code`. Or copy the skill folder (skills/cv4pve-pepper in Corsinvest/cv4pve-pepper) into .claude/skills/cv4pve-pepper in your project. Claude Code loads it when a task matches its description.

How do I install Cv4pve Pepper in Codex?

Run `npx skills add Corsinvest/cv4pve-pepper --skill cv4pve-pepper -a codex`. Or copy the skill folder (skills/cv4pve-pepper in Corsinvest/cv4pve-pepper) into .agents/skills/cv4pve-pepper in your project. Codex loads it when a task matches its description.

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

What does Cv4pve Pepper need to run?

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

Does Cv4pve Pepper access the network?

SKILL.md names 1 domain. As links in the text: corsinvest.github.io. This is read from the text; nothing was executed.

Is Cv4pve Pepper 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 Cv4pve Pepper use?

Cv4pve Pepper is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Cv4pve Pepper use?

About 884 tokens (SKILL.md is roughly 3.5k 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 Cv4pve Pepper?

Skills that share tags, products or a category with Cv4pve Pepper: Minimax DOCX (poco-ai/poco-claw, 1.4k stars), Speckit Constitution (WeihanLi/WeihanLi.Common, 242 stars), Analyzing .NET Performance (dotnet/skills, 5.6k stars) and Find Untested Sources (microsoft/testfx, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cv4pve Pepper?

Corsinvest (a GitHub organization) maintains it in Corsinvest/cv4pve-pepper, which has 150 GitHub stars. The repository was last updated on October 7, 2026.

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