Browse, install, submit, and edit pixel-art pets with the Petdex CLI.

MITAuto-check passedGame Development

Install Petdex

skills CLI
$ npx skills add crafter-station/petdex --skill petdex -a claude-code

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

GitHub CLI
$ gh skill install crafter-station/petdex petdex --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/crafter-station/petdex.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/petdex .claude/skills/petdex && 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
petdex
GitHub stars
4.2k
Token cost
~614 tokens
SKILL.md length
281 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Browse, install, submit, and edit pixel-art pets with the Petdex CLI.

  • A user asks for a coding companion
  • SKILL.md covers Browse and install, Submit artwork, Edit a pet the user owns and Desktop controls
  • Calls bunx and npx
  • Wants to install a Petdex pet

What it does

Petdex is an agent skill from crafter-station/petdex. Browse, install, submit, and edit pixel-art pets with the Petdex CLI. Use when a user asks for a coding companion, wants to install a Petdex pet, or wants to publish or update artwork they own.

Its SKILL.md is about 610 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 Game Development, covering Sprites and pixel art. It works with Vercel, PostgreSQL, Next.js and React. The repository describes itself as: A public gallery of animated pets for Codex, Claude Code, DeepSeek Harness, Hermes, OpenCode, Gemini CLI, and more. The licence is MIT.

When your agent uses it

  • A user asks for a coding companion
  • Wants to install a Petdex pet
  • Wants to publish
  • Update artwork they own

Example prompts

  • “/petdex”

Requirements

  • Node.js

What it can do on your machine

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

    • bunx
    • npx

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

    • petdex.dev

    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

Petdex loads about 614 tokens when it runs. Until then it costs about 50 tokens; SKILL.md has 281 words of instructions outside code blocks.

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

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 crafter-station/petdex at commit 7e32703, republished under its MIT licence (© crafter-station). 281 words, ~614 tokens.

Download SKILL.mdSave it as .claude/skills/petdex/SKILL.md (or your agent's skills folder).
name
petdex
description
Browse, install, submit, and edit pixel-art pets with the Petdex CLI. Use when a user asks for a coding companion, wants to install a Petdex pet, or wants to publish or update artwork they own.

Petdex

Use the published petdex CLI for the catalog. Node.js 20 or later is required.

Read the current command help before using unfamiliar flags:

sh
bunx petdex --help
bunx petdex --version

If Bun is unavailable, use npx -y petdex for the same commands.

Browse and install

sh
bunx petdex list
bunx petdex install boba
bunx petdex install boba mochi

Choose a slug from the catalog. Installation writes the pet to both ~/.petdex/pets/<slug>/ and ~/.codex/pets/<slug>/. Report the installed slugs and any command failure.

Submit artwork

Publish only artwork the user has asked to submit, with the license they selected. If the license is missing, ask rather than choosing the rights for them.

sh
bunx petdex login
bunx petdex whoami
bunx petdex submit ./my-pet --license cc-by

Login opens a browser and stores credentials locally. A headless session needs an existing login; never ask the user to paste tokens.

The example uses CC BY. Supported license IDs are cc0, cc-by, cc-by-sa, cc-by-nc, and all-rights-reserved. Each pet folder needs pet.json and spritesheet.webp or spritesheet.png. The sheet must use the supported 8-by-9 or 8-by-11 atlas layout. A ZIP or a parent directory containing multiple pets is also accepted.

Let duplicate detection run normally. Use --force only when the user wants duplicate submissions. Report the submission result; submission is not approval or publication in the gallery.

Edit a pet the user owns

sh
bunx petdex edit boba --desc "A tiny otter sipping bubble tea"
bunx petdex edit boba --sprite ./spritesheet.webp

Send only the requested changes. The CLI also accepts --displayName, --meta, and --zip.

Desktop controls

The floating companion is Petdex Desktop, available at https://petdex.dev/download. Its Settings window selects the pet and installs agent hooks. The catalog CLI does not start the desktop app or manage those hooks. Retired commands such as init, up, doctor, select, and hooks install are not the setup flow.

For authentication trouble, run whoami and follow the CLI error. For unsupported commands or flags, use --help. Do not treat a nonzero exit as success.

© crafter-station, MIT. 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 .claude/skills/petdex of crafter-station/petdex.

Open the folder on GitHubat commit 7e32703

Compare with similar skills

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

Petdex compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Petdex this skillcrafter-station/petdex4.2k—~614Automated safety check: PassMIT
Nextjs Nextra Starter Distillpdsuwwz/nextjs-nextra-starter318—~596Automated safety check: PassMIT
Nextjs Nextra Starter Distill Zhpdsuwwz/nextjs-nextra-starter318—~313Automated safety check: PassMIT
Frontend Design UltimateaAAaqwq/AGI-Super-Team1052 repos~2.7kAutomated safety check: PassMIT
AI SDKvercel-labs/ai-facts16820 repos~1.2kAutomated safety check: PassNone
Website ClonerJCodesMore/ai-website-cloner-template36k—~1.7kAutomated safety check: PassMIT

Similar skills

  • Nextjs Nextra Starter Distill

    pdsuwwz/nextjs-nextra-starter

    Distill and apply this repository's Next.js Nextra starter architecture, implemented features, extension points, and migration patterns.

    318 GitHub stars~596 tokensUpdated 22 days ago
    Frontend & DesignAuto-check passed
  • Nextjs Nextra Starter Distill Zh

    pdsuwwz/nextjs-nextra-starter

    蒸馏并应用当前仓库的 Next.js Nextra 启动模板架构、已实现功能、二次开发扩展点与迁移模式。适用于理解本项目、继续二次开发、修改 docs/landing/i18n/theme/auth/UI 行为,或把这些 Next.js 16 + Nextra 4 + Tailwind CSS 4 模式复用到其他项目。

    318 GitHub stars~313 tokensUpdated 22 days ago
    Frontend & DesignAuto-check passed
  • Frontend Design Ultimate

    aAAaqwq/AGI-Super-Team

    Create distinctive, production-grade static sites with React, Tailwind CSS, and shadcn/ui — no mockups needed.

    105 GitHub starsUsed in 2 repos~2.7k tokens
    Frontend & DesignAuto-check passed
  • AI SDK

    vercel-labs/ai-facts

    Official

    Answer questions about the AI SDK and help build AI-powered features.

    168 GitHub starsUsed in 20 repos~1.2k tokens
    AI & LLM EngineeringAuto-check passed
  • Website Cloner

    JCodesMore/ai-website-cloner-template

    Rebuilds existing web pages as editable local code that matches their content, assets, responsive layout and interactions, including Framer sites and animated pages.

    36k GitHub stars~1.7k tokensUpdated 4 days ago
    Frontend & DesignAuto-check passed
  • Official

    React and Next.js performance optimization guidelines from Vercel Engineering.

    6.4k GitHub starsUsed in 129 repos~1.6k tokens
    Frontend & DesignAuto-check passed

More from crafter-station/petdex

  • Coss

    crafter-station/petdex

    Helps implement coss UI components correctly. An agent skill from crafter-station/petdex.

    4.2k GitHub stars~1.4k tokensUpdated 11 days ago
    Auto-check passed
  • Coss Particles

    crafter-station/petdex

    Index of all COSS UI particle examples. An agent skill from crafter-station/petdex.

    4.2k GitHub stars~10k tokensUpdated 11 days ago
    Auto-check passed

Questions about Petdex

What does Petdex do?

Browse, install, submit, and edit pixel-art pets with the Petdex CLI. Petdex is an agent skill from crafter-station/petdex. Browse, install, submit, and edit pixel-art pets with the Petdex CLI.

When should I use Petdex?

Petdex fits situations like: A user asks for a coding companion; wants to install a Petdex pet; wants to publish; update artwork they own.

How do I install Petdex in Claude Code?

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

How do I install Petdex in Codex?

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

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

What does Petdex need to run?

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

Does Petdex access the network?

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

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

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

About 614 tokens (SKILL.md is roughly 2.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 Petdex?

Skills that share tags, products or a category with Petdex: Nextjs Nextra Starter Distill (pdsuwwz/nextjs-nextra-starter, 318 stars), Nextjs Nextra Starter Distill Zh (pdsuwwz/nextjs-nextra-starter, 318 stars), Frontend Design Ultimate (aAAaqwq/AGI-Super-Team, 105 stars) and AI SDK (vercel-labs/ai-facts, 168 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Petdex?

crafter-station (a GitHub organization) maintains it in crafter-station/petdex, which has 4,212 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on September 28, 2026.

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