Agent skill

Omacvm

by gillesgoetsch in gillesgoetsch/OmacVM

Set up, change, update or troubleshoot OmacVM (Omarchy in a Parallels, UTM or VMware Fusion VM on an Apple Silicon Mac) with the omacvm command.

MITAuto-check passedMarketing & SEO

Install Omacvm

skills CLI

$ npx skills add gillesgoetsch/OmacVM --skill omacvm -a claude-code

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

GitHub CLI

$ gh skill install gillesgoetsch/OmacVM omacvm --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/gillesgoetsch/OmacVM.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/omacvm .claude/skills/omacvm && 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/

Paste into Claude Code

Install the "omacvm" agent skill from https://github.com/gillesgoetsch/OmacVM/tree/main/.claude/skills/omacvm into .claude/skills/omacvm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "omacvm", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/gillesgoetsch/OmacVM/tree/main/.claude/skills/omacvm

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add gillesgoetsch/OmacVM --skill omacvm -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install gillesgoetsch/OmacVM omacvm --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/gillesgoetsch/OmacVM.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/omacvm .agents/skills/omacvm && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "omacvm" agent skill from https://github.com/gillesgoetsch/OmacVM/tree/main/.claude/skills/omacvm into .agents/skills/omacvm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "omacvm", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add gillesgoetsch/OmacVM --skill omacvm -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install gillesgoetsch/OmacVM omacvm --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/gillesgoetsch/OmacVM.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/omacvm .cursor/skills/omacvm && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "omacvm" agent skill from https://github.com/gillesgoetsch/OmacVM/tree/main/.claude/skills/omacvm into .cursor/skills/omacvm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "omacvm", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/gillesgoetsch/OmacVM.git --path .claude/skills/omacvm

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add gillesgoetsch/OmacVM --skill omacvm -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install gillesgoetsch/OmacVM omacvm --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/gillesgoetsch/OmacVM.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/omacvm .gemini/skills/omacvm && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "omacvm" agent skill from https://github.com/gillesgoetsch/OmacVM/tree/main/.claude/skills/omacvm into .gemini/skills/omacvm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "omacvm", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install gillesgoetsch/OmacVM omacvm

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add gillesgoetsch/OmacVM --skill omacvm -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/gillesgoetsch/OmacVM.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/omacvm .github/skills/omacvm && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "omacvm" agent skill from https://github.com/gillesgoetsch/OmacVM/tree/main/.claude/skills/omacvm into .github/skills/omacvm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "omacvm", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add gillesgoetsch/OmacVM --skill omacvm -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install gillesgoetsch/OmacVM omacvm --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/gillesgoetsch/OmacVM.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/omacvm .opencode/skills/omacvm && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "omacvm" agent skill from https://github.com/gillesgoetsch/OmacVM/tree/main/.claude/skills/omacvm into .opencode/skills/omacvm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "omacvm", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: omacvm
GitHub stars: 173
Token cost: ~795 tokens
SKILL.md length: 411 words
Files: 1
Skills in repo: 1
Repo updated: Oct 9, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Set up, change, update or troubleshoot OmacVM (Omarchy in a Parallels, UTM or VMware Fusion VM on an Apple Silicon Mac) with the omacvm command.

Works in 4 steps: ./omacvm vms --json (a UTM VM with… → Show the plan (resources, features,… → Run the plan's command with… → …
Someone wants an Omarchy VM built
SKILL.md covers Rules, New VM and Existing VM
Needs OMACVM_PASSWORD

What it does

Omacvm is an agent skill from gillesgoetsch/OmacVM. Set up, change, update or troubleshoot OmacVM (Omarchy in a Parallels, UTM or VMware Fusion VM on an Apple Silicon Mac) with the omacvm command. Use when someone wants an Omarchy VM built, its CPUs or memory changed, a feature switched (macOS-native scroll momentum, trackpad gestures, Bridge, Omanotch, wallpaper, idle lock, autologin, memory-optimized kernel), OmacVM added to an existing Omarchy VM, updated, or checked.

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

It sits in Marketing & SEO, covering Marketing analytics. It works with macOS and Linux. The repository describes itself as: Omarchy VM for Apple Silicon (OmacVM.app, UTM, VMware or Parallels), feeling native: Full notch rendering, trackpad gestures, macOS-like scrolling, GPU acceleration, synced…. The licence is MIT.

When your agent uses it

Someone wants an Omarchy VM built
A feature switched (macOS-native scroll momentum
Trackpad gestures
Memory-optimized kernel)

Example prompts

“/omacvm”

Workflow steps

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

./omacvm vms --json (a UTM VM with "state": "unknown": UTM does not
Show the plan (resources, features, needs_human), ask for the password
Run the plan's command with OMACVM_PASSWORD set.
Hand over needs_human; when the person is logged in to Omarchy,

What it can do on your machine

Read from SKILL.md and the folder at commit 9004806. 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.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- OMACVM_PASSWORD
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Omacvm loads about 795 tokens when it runs. Until then it costs about 108 tokens; SKILL.md has 411 words of instructions outside code blocks.

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

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 gillesgoetsch/OmacVM at commit 9004806, republished under its MIT licence (© gillesgoetsch). 411 words, ~795 tokens.

Download SKILL.mdSave it as .claude/skills/omacvm/SKILL.md (or your agent's skills folder).

name: omacvm
description: Set up, change, update or troubleshoot OmacVM (Omarchy in a Parallels, UTM or VMware Fusion VM on an Apple Silicon Mac) with the omacvm command. Use when someone wants an Omarchy VM built, its CPUs or memory changed, a feature switched (macOS-native scroll momentum, trackpad gestures, Bridge, Omanotch, wallpaper, idle lock, autologin, memory-optimized kernel), OmacVM added to an existing Omarchy VM, updated, or checked.

OmacVM

Drive everything through ./omacvm in this repository (or omacvm on the PATH after ./install.sh). Read AGENTS.md section 0 for the recipes and sections 7-8 before fixing anything by hand.

Rules

Without a terminal omacvm never asks: pass options, read --json. Exit codes: 0 done, 1 failed, 2 usage (the message names what is missing), 3 needs a person (the message says what).
Only the person can: choose their Omarchy password, grant macOS permissions (Location Services, Accessibility, Input Monitoring), set Parallels' "Send macOS system shortcuts: Always", install Parallels, UTM 5 or VMware Fusion. Hand these over (needs_human in the JSON); never work around them, never invent a password.
macOS-native scroll momentum (scroll-momentum) is experimental and off by default: offer it, let the person decide.
A build takes 30-70 minutes (OmacVM.app 10-30, Fusion 45-85, minutes in the plan): run it in the background and follow its output.
Do not edit /usr/share/omarchy or the user's macOS Spaces; do not put personal data into this repository.

New VM

./omacvm vms --json (a UTM VM with "state": "unknown": UTM does not take orders from this terminal; over SSH it never does, so UTM VMs are driven from a terminal app on the Mac that may control UTM); then ./omacvm build --plan --json --vm-type parallels|utm|fusion [--vm-name NAME] [--feature scroll-momentum=on].
Show the plan (resources, features, needs_human), ask for the password and for changes.
Run the plan's command with OMACVM_PASSWORD set.
Hand over needs_human; when the person is logged in to Omarchy, ./omacvm check --vm NAME --json until "ok": true (entries with "needs_human": true are theirs).

Show full SKILL.md (148 more words)Show less

Existing VM

Features: ./omacvm features --vm NAME --json, then ./omacvm enable|disable FEATURE... --vm NAME --yes, then check. Listing (features, check, vms) never starts a VM: one that is off is shown from its folder ("running": false). enable, disable and apply start a stopped VM only when it is named with --vm.
CPUs and memory: ./omacvm resources --vm NAME --json (what it has, the limits, the tiers), then ./omacvm resources --vm NAME --resources TIER or --cpus N --memory-gb N. Parallels, UTM and Fusion VMs must be stopped (exit 3: the person shuts it down); a change applies on the next start. A name in two apps: add --vm-type.
Omarchy installed by hand: ./omacvm apply --vm NAME; exit 3 prints one command for the person to run in the VM's terminal, then apply again.
Update: ./omacvm update (or --vm NAME).
Problems: ./omacvm check --vm NAME --json, then AGENTS.md section 7.

Files

Just SKILL.md in .claude/skills/omacvm of gillesgoetsch/OmacVM.

Open the folder on GitHubat commit 9004806

Compare with similar skills

Omacvm 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.

Omacvm compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Omacvm this skillgillesgoetsch/OmacVM	173	—	~795	Automated safety check: Pass	MIT	today
Submit Product Directories V2 Qualityflaqai/backlink_skills	756	—	~2.2k	Automated safety check: Pass	MIT	16 days ago
Google SEO APIsAgriciDaniel/claude-seo	19k	1 repos	~4.2k	Automated safety check: Pass	MIT	5 days ago
AnalyticsNexus-JPF/note-companion	870	7 repos	~2.2k	Automated safety check: Pass	MIT	3 days ago
GEO Monthly Delta Reportzubair-trabzada/geo-seo-claude	11k	—	~2.4k	Automated safety check: Notes	MIT	today
Conversion Signal QAaaron-he-zhu/aaron-marketing-skills	2.9k	2 repos	~2.4k	Automated safety check: Pass	Apache-2.0	today

Similar skills

Submit Product Directories V2 Quality
flaqai/backlink_skills
SPD V2 Quality. An agent skill from flaqai/backlink_skills.
756 GitHub stars~2.2k tokensUpdated 16 days ago
Marketing & SEOAuto-check passed
Google SEO APIs
AgriciDaniel/claude-seo
Pulls real Google data for SEO work: Search Console, PageSpeed Insights, CrUX field data, the Indexing API and GA4 organic traffic, through /seo google commands.
19k GitHub starsUsed in 1 repo~4.2k tokens
Marketing & SEOAuto-check passed
Analytics
Nexus-JPF/note-companion
When the user wants to set up, improve, or audit analytics tracking and measurement.
870 GitHub starsUsed in 7 repos~2.2k tokens
Marketing & SEOAuto-check passed
GEO Monthly Delta Report
zubair-trabzada/geo-seo-claude
Compares a baseline and a current GEO audit for a client, calculates score changes and action item progress, and writes a monthly progress report.
11k GitHub stars~2.4k tokensUpdated today
Marketing & SEOAuto-check: notes
Conversion Signal QA
aaron-he-zhu/aaron-marketing-skills
A skill your agent uses when the user asks to "QA my conversion tracking before launch", "check my UTMs / pixel / event firing", "set up a tracking pre-flight", or "set the dedup rule so Meta and…
2.9k GitHub starsUsed in 2 repos~2.4k tokens
Marketing & SEOAuto-check passed
LLM Mention Tracking
unifapi-agent/agents
When the user wants to track how often their brand or domain gets mentioned across ChatGPT and AI search engines over a set of prompts, and how that share of voice compares to named competitors over…
589 GitHub stars~1.8k tokensUpdated 1 mo ago
Marketing & SEOAuto-check passed

Works with

Questions about Omacvm

What does Omacvm do?

Set up, change, update or troubleshoot OmacVM (Omarchy in a Parallels, UTM or VMware Fusion VM on an Apple Silicon Mac) with the omacvm command. Omacvm is an agent skill from gillesgoetsch/OmacVM. Set up, change, update or troubleshoot OmacVM (Omarchy in a Parallels, UTM or VMware Fusion VM on an Apple Silicon Mac) with the omacvm command.

When should I use Omacvm?

Omacvm fits situations like: someone wants an Omarchy VM built; A feature switched (macOS-native scroll momentum; trackpad gestures; memory-optimized kernel).

How do I install Omacvm in Claude Code?

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

How do I install Omacvm in Codex?

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

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

What does Omacvm need to run?

Going by SKILL.md and its folder, Omacvm needs credentials named OMACVM_PASSWORD.

Does Omacvm access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Omacvm 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 Omacvm use?

Omacvm 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 Omacvm use?

About 795 tokens (SKILL.md is roughly 3.2k 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 Omacvm?

Skills that share tags, products or a category with Omacvm: Submit Product Directories V2 Quality (flaqai/backlink_skills, 756 stars), Google SEO APIs (AgriciDaniel/claude-seo, 19k stars), Analytics (Nexus-JPF/note-companion, 870 stars) and GEO Monthly Delta Report (zubair-trabzada/geo-seo-claude, 11k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Omacvm?

gillesgoetsch (a GitHub user) maintains it in gillesgoetsch/OmacVM, which has 173 GitHub stars. The repository was last updated on October 9, 2026.

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

Install Omacvm

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

OmacVM

Rules

New VM

Existing VM

Files

Compare with similar skills

Similar skills

Submit Product Directories V2 Quality

Google SEO APIs

Analytics

GEO Monthly Delta Report

Conversion Signal QA

LLM Mention Tracking

Related

Questions about Omacvm