petshare-setup

petshare-setup is a skill for Claude Code, Codex from portons/codex-pet-share. It costs 48 tokens per session (1,774 once invoked), scanned A, original, MIT.

A repository guide for creating, adapting, rebranding, or deploying a self-hosted app where people upload, view, download, and share animated digital pets, including multiplayer rooms.

In plain words
What is it for?
Use it when modifying this app or a close copy, especially its pet uploads, animated previews, downloadable packages or GIFs, provider connections, public settings, or multiplayer playground rooms.
Why use it?
It gives an agent the project rules and documents to read before changing the app, helping avoid unrelated changes and mistakes in uploads, previews, rooms, providers, or deployment.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/portons/codex-pet-share/petshare-setup
Any agent
npx skills add portons/codex-pet-share --skill petshare-setup
Clone the repo
git clone --depth 1 https://github.com/portons/codex-pet-share

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for petshare-setup

README.md
[![agentmods](https://agentmods.dev/badge/skills/portons/codex-pet-share/petshare-setup.svg)](https://agentmods.dev/skills/portons/codex-pet-share/petshare-setup)
Your own site
<a href="https://agentmods.dev/skills/portons/codex-pet-share/petshare-setup"><img src="https://agentmods.dev/badge/skills/portons/codex-pet-share/petshare-setup.svg" alt="Measured on agentmods" height="20"></a>
Per session 48 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,774 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00048 $0.01774
Opus 5 $0.00024 $0.00887
Sonnet 5 $0.00010 $0.00355
Haiku 4.5 $0.00005 $0.00177

Measured 4d ago against content hash c601a27b71a2, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

petshare-setup scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/petshare-setup/SKILL.md · 183 lines

How it starts

The opening of the file, as written. The whole thing — 183 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Petshare Setup

Use this skill when an agent is asked to spin up, fork, rebrand, deploy, or modify this repository or a close derivative. The app is a self-hostable React/Vite pixel-pet sharing surface: users upload Codex-compatible pet packages, browse animated previews, download packages/GIFs, and join multiplayer playground rooms.

This is a repo-scoped Codex skill. Keep it under .agents/skills/petshare-setup/ so Codex can discover it from the repository.

First Read

Before editing, read:

  • README.md
  • docs/GETTING_STARTED.md
  • docs/PROVIDER_ADAPTERS.md
  • AGENTS.md
  • references/petshare-architecture.md when touching app behavior, uploads, previews, animations, rooms, provider adapters, or deployment
  • references/security-boundary.md when publishing, documenting public setup, reviewing exposure risk, or changing auth/moderation/provider surfaces

Non-Negotiables

  • Keep changes literal to the request. Do not add fallbacks, backwards compatibility, provider-specific public env vars, or unrelated hardening.
  • Keep the browser public contract provider-neutral. Public build vars are only: VITE_APP_API_BASE_URL, VITE_PUBLIC_APP_ORIGIN, VITE_REALTIME_URL, VITE_REALTIME_PUBLIC_KEY, VITE_APP_NAME, VITE_APP_HANDLE, VITE_APP_TAGLINE, and VITE_APP_REPO_URL.
  • Never commit .env, .env.local, API tokens, salts, database passwords, provider account identifiers, generated migration exports, or local auth data.
  • Use provider adapters as replaceable boundaries. Feature code under src/ should not branch on provider names.
  • Do not turn this skill into an abuse manual. Do not add copy-paste scripts, unauthenticated client examples, raw room-event payload recipes, rate-limit thresholds, bypass instructions, scraping loops, or moderation-evasion advice.
  • For ports, follow AGENTS.md: check a requested port before starting a process, and never kill reserved ports unless explicitly asked.

Core Workflow

  1. Identify whether the task is setup, provider work, upload/asset work, preview/GIF work, animation/playground work, multiplayer rooms, rebranding, or security/publication review.
  2. Load only the reference file needed for that surface.
  3. Inspect current source before deciding; this repo has explicit adapter and feature boundaries.
  4. Make the smallest code/doc changes that satisfy the user request.
  5. Run the relevant validation commands below.
  6. If publishing or handing off public code, run the exposure checks from references/security-boundary.md.

Read the full file on GitHub · 183 lines

Files

What ships with it

3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 183 lines · 48 tokens per session scan A c601a27b71a2

Subscribe to this mod's changes

petshare-setup is a skill published in the GitHub repository portons/codex-pet-share (125 stars, last pushed 1mo ago), licensed MIT. It adds 48 tokens to every session and 1,774 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

game-art

Game art principles. Visual style selection, asset pipeline, animation workflow.

vudovn/ag-kit · 17 tokens

sprite-gen

Generate clean 2D game sprites and animation atlases with a component-row pipeline: base identity, numeric sprite-request SSoT, per-state layout guides, image-gen row strips, chroma-key alpha cleanup, connected-component frame extraction, cell-based atlas composition, QA reports, and runtime manifest framelayout. Its…

aldegad/sprite-gen · 291 tokens

generate2dsprite

Generate and postprocess general 2D game assets and animation sheets: pixel-art sprites, clean HD map props, creatures, characters, NPCs, spells, projectiles, impacts, props, summons, and transparent GIF exports. Use when Codex should infer the asset plan from a natural-language request, match a reference or map art…

0x0funky/agent-sprite-forge · 111 tokens

vibeue

Unreal Engine 5 development using the VibeUE Python API. Use when working in Unreal Engine — blueprints, state trees, materials, actors, landscapes, animation, niagara, widgets, sound, foliage, gameplay tags, enhanced input, skeletons, PCG (procedural content generation), and more. VibeUE is an extension of Unreal's…

kevinpbuckley/VibeUE · 82 tokens

godot-animation

Animate in Godot 4.7 three ways: AnimationPlayer for keyframed clips (incl. call and signal tracks), AnimationTree with state machines and blend spaces for character animation, and Tween for short procedural/UI tweens via createtween(). Use when working with AnimationPlayer/AnimationTree nodes in a .tscn, blending…

gamedev-skills/awesome-gamedev-agent-skills · 85 tokens

godot-audio

Play and mix audio in Godot 4.7: AudioStreamPlayer (2D/3D variants), audio buses with volume/mute and effects, music vs SFX routing, db/linear volume, and precise sync-to-beat playback timing. Use when playing sounds or music in a Godot project, routing AudioStreamPlayer nodes to buses, adjusting bus volume via…

gamedev-skills/awesome-gamedev-agent-skills · 91 tokens