install-codex-pet

Installs shared Codex pet packages into Omnibot using the codex-pets npm CLI.

2.0k|140|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/omnimind-ai/OpenOmniBot --skill install-codex-pet
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: install-codex-pet
Source: https://github.com/omnimind-ai/OpenOmniBot/tree/main/app/src/main/assets/builtin_skills/install-codex-pet
Command: npx skills add https://github.com/omnimind-ai/OpenOmniBot --skill install-codex-pet

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires codex-pets, and includes scripts (resource) components.

What problem does it solve?

Adding shared Codex pets to Omnibot requires running the official codex-pets CLI against the correct pet root directory; doing this manually risks installing packages into the wrong location (the default /root/.codex) where Omnibot's appearance scanner cannot find them.

Core Features & Use Cases

  • Official CLI Installation: Runs npx codex-pets add or add-collection with CODEX_HOME pointed at /workspace/.omnibot so pets land in the scanned directory.
  • Slug Validation: Accepts only lowercase slugs of letters, digits, and hyphens, and refuses to guess when no slug is provided.
  • Post-Install Validation: A shell script verifies pet.json, spritesheet.webp, id matching, and displayName before reporting success.
  • Use Case: A user says "install the claude-pixel pet" and the Skill runs npx codex-pets add claude-pixel with the correct CODEX_HOME, validates the package, and reports the installed display name.

Quick Start

Ask the assistant to install a Codex pet by slug, for example: install the claude-pixel pet into Omnibot.

Frequently Asked Questions about install-codex-pet

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install a Codex pet into Omnibot?

Provide the lowercase pet slug and the Skill runs npx codex-pets add <slug> with CODEX_HOME set to /workspace/.omnibot. The pet lands in /workspace/.omnibot/pets/<pet-id>/ where the appearance page discovers it automatically.

How do I install a whole Codex pet collection?

Use the collection slug with the add-collection command: npx codex-pets add-collection <slug>, keeping CODEX_HOME=/workspace/.omnibot. Each installed pet is then validated individually by the validation script.

Why is my installed pet not showing up in Omnibot?

The codex-pets CLI defaults to /root/.codex, which Omnibot's appearance scanner does not read. The Skill prevents this by always exporting CODEX_HOME=/workspace/.omnibot before running any codex-pets command.

What pet slugs are accepted by codex-pets install?

Only lowercase slugs made of letters, digits, and hyphens are accepted. The Skill does not guess a slug when the request does not contain one, and the validation script rejects malformed pet ids.

What happens if node or npm is missing in the terminal?

The Skill checks for node, npm, and npx before running anything. If they are missing, it reports that the embedded terminal environment needs its base packages installed instead of attempting the install.