К основному содержанию
скилл CX Codex

assetcat — скилл для Claude Code: поиск игровых ассетов

Скилл для Claude Code ищет игровые ассеты в библиотеке, проиндексированной через assetcat. Он проверяет лицензии и статус генерации ИИ, а выбранные файлы копирует в проект вместе с кредитами.

MIT ★ 67 обновлён 2026-11-13

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add digitalhobbit/assetcat --skill assetcat -a claude-code
Открыть на GitHub

Что делает assetcat

Скилл ищет спрайты, тайлсеты, звуки, музыку, шрифты и 3D-модели в пользовательской библиотеке через CLI assetcat. По запросу он помогает выяснить, какие ассеты уже есть, проверяет лицензию и отметку о генерации ИИ, затем переносит выбранные файлы в проект с данными об источнике и кредитами.

Для работы нужны установленный assetcat и проиндексированная библиотека. Если библиотеки ещё нет, её нужно подготовить командами assetcat init <library folder> и assetcat index; скилл не запускает init за пользователя. Если CLI не установлен, в инструкциях предусмотрен запуск через uvx assetcat.

Какие задачи решает

  • найти в библиотеке тайлсет или спрайт для игры
  • проверить лицензию ассета и отметку о генерации ИИ
  • скопировать выбранные файлы в проект вместе с кредитами
  • узнать, какие игровые ассеты уже есть в библиотеке

Примеры запросов агенту

  • Найди в моей библиотеке пиксельный тайлсет подземелья.
  • Проверь лицензию и статус генерации ИИ у этого ассета.
  • Скопируй выбранные ассеты в папку проекта и добавь кредиты.

Как установить assetcat

1Через Skills CLI (Vercel)

npx skills add digitalhobbit/assetcat --skill assetcat -a claude-code

2Вручную: положить файлы

~/.claude/skills/assetcat/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/assetcat/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об assetcat

Как установить assetcat в Claude Code?

Выполни npx skills add digitalhobbit/assetcat --skill assetcat -a claude-code. Файл скилла находится по пути ~/.claude/skills/assetcat/SKILL.md.

Что делает assetcat?

Скилл ищет игровые ассеты в индексированной библиотеке, показывает сведения о лицензии и генерации ИИ, а затем копирует выбранные файлы в проект с кредитами.

Что нужно для работы assetcat?

Нужен CLI assetcat и проиндексированная библиотека. Для её подготовки используются assetcat init <library folder> и assetcat index; CLI также можно запускать через uvx assetcat.

Исходный текст

SKILL.md · MIT
---
name: assetcat
description: Find, check and pull game assets (sprites, tilesets, sounds, music, fonts, 3D models) from the user's indexed asset library with the `assetcat` CLI. Use when the user asks for assets for a game or prototype, wants to know what they own ("do I have a pixel-art dungeon tileset?"), asks about an asset's license or whether it's AI-generated, or wants assets copied into a project with credits.
---

# Asset library (assetcat)

The user's asset library (bundles, store packs, Kenney's all-in-1...) is indexed by `assetcat`.
Search it, look at what you find, check license and AI status, then pull the chosen files into
the project. Never copy files out of the library by hand: `pull` also copies the license and
records where every file came from.

Run it as `assetcat ...` if it's installed. Otherwise use `uvx assetcat ...`, or whatever command the
project's own docs give (a project may wrap it). If it says there's no library yet, the user
has to run `assetcat init <library folder>` and `assetcat index` once on this machine; don't run
`init` for them.

## Find

Add `--json` to every command whose output you parse. Paths in JSON are absolute.

```sh
assetcat search --packs dungeon tileset          # packs: names, contents, readmes, tags
assetcat search slime --type character,sheet     # assets inside packs
assetcat search --type tileset --grid --max-size 16x16
assetcat search door --pack <pack>               # within one pack (id, key or name)
assetcat packs --kind sfx                        # list packs; --tree shows the structure
assetcat packs --tag style:pixel-art --tag perspective:top-down   # packs by tag
assetcat show <pack>                             # license, AI status, folders, grids, readme, duplicates
assetcat show <library path of a file>           # one asset: size, grid, variants, license
assetcat search --meaning a slime monster --type character,sheet   # images by what they show
assetcat search --similar <library path of an image>              # images that look like it
assetcat search barrel --media model [--animated] [--rigged]      # 3D models (glTF clips, skeletons)
```

**By meaning.** If the library has image vectors (`assetcat classify --kind embed` was run),
`--meaning` finds images by what they show, whatever their names, and `--similar` finds images
that look like one you found. Results come ranked by `score`; they always return something, so
look at the scores (a big drop means the rest are weak) and at the images. Combine with filters
(`--type`, `--pack`, `--tag`). If it says there are no vectors or the AI extra is missing, fall
back to word search; don't install anything or run `classify` yourself.

**Subjects.** With vectors, images may also carry AI subjects (what they show: potion, sword,
slime). Word search matches them, `show <file> --json` lists them as `subjects` with a score,
and `show <pack> --json` has `contains` (subject -> number of images). They're cautious, so a
missing subject means little; a present one is usually right.

Asset types: sprite, character, sheet, tileset, ui, icon, background, portrait, vfx, preview,
sfx, music, voice, model, font. Pack kinds: graphics, 3d, music, sfx, audio, mixed, fonts,
engine, archived, other. Names are matched by word prefix, so try synonyms and broader words
when a search comes back empty, and search packs before assets.

**Tags.** Packs may carry tags as `namespace:value`: `kind:` (ui, tileset, characters, icons,
vfx, backgrounds, props, music, sfx, fonts, 3d), `style:` (pixel-art, vector, hand-drawn,
painted, low-poly, realistic), `perspective:` (top-down, side, isometric, first-person),
`genre:` and `mood:`, plus the user's own words. Most come from a vision model (`ai_tags` in
`show --json`, with `ai_model`) and some from the user. AI tags are good hints, not facts: check
the contact sheet before relying on one. Not every library has them; `assetcat classify` makes
them, and that's the user's call to run (it needs a local model server and takes a while).

**Look before you choose.** `assetcat sheet <pack> [folder]` renders a contact sheet and prints
its PNG path; open that image to see what a pack or folder actually looks like. Single image
files can be viewed directly by their absolute path. Describe what you saw when you propose
assets; don't pick by file name alone.

**Grids.** For sheets and tilesets, `show` and `search` report the tile size when it's known
(from Tiled files, atlases, Kenney's Tilesheet.txt, the file name, or the user's curation).
Use that size when setting up a TileSet or sprite frames; pulls copy sheets whole, not sliced.

**3D models.** An asset groups a model's formats (`formats: glb,fbx,obj`); prefer glTF/GLB for
Godot and the web. `show` lists triangles, animation clips (glTF) and the files a model loads
(textures, `.bin` buffers, `.mtl`), marking missing ones. Many models come with a rendered
preview image (`preview` in `show --json`): open it to see the model.

**Shortlists.** The user can star packs, folders and assets into named shortlists in the browse
UI (`assetcat serve`). They're TOML files in the profile's `shortlists/` folder (the profile
path is `profile` in `assetcat stats --json`), with `kind` and `ref` per item (`ref` is a pack id
or a library path). If the user says "use my X shortlist",
read that file and start from its items.

## Check before pulling

From `show <pack> --json`:

- `license` and `license_info` (name, summary, `attribution_required`, url). `unknown` means
  nobody has recorded it: tell the user and don't ship the asset until they have.
- `ai_generated`: `no` (human-made, with `ai_reason`), `yes`, or `unknown`. If the project cares
  about AI provenance (its docs say so, or the user asked), only use packs marked `no`, and say so
  when you skip others. Never change the recorded status yourself.
- `duplicates`: the same files may exist in another pack under a different license; prefer the
  one with the clearer license.
- `pending` > 0: some files are still cloud placeholders and can't be pulled yet.

## Pull

```sh
assetcat pull <pack | folder | file>... --to <project assets folder> \
    --manifest <project>/assets/sources.toml [--require-ai no] [--flatten] [--dry-run] [--json]
```

- Targets: a pack (id, key or name), or a library path of a folder or file inside a pack. A pack
  lands in `<to>/<pack folder>/`, a folder in `<to>/<folder>/`, a file in `<to>/<file>` (with its
  atlas or Tiled file if it has one; a 3D model with the textures, buffers and `.mtl` files it
  loads, at the same relative path, e.g. `Textures/colormap.png`). `--flatten` puts everything
  directly in `<to>`, except those model files, which stay where the model looks for them.
  Warnings in the output name files a model needs that aren't in the library.
- Each pack's license file is copied as `License-<Pack>.<ext>` next to the pulled files; a
  bundle-wide license is named after the bundle (`--license-name` changes the pattern,
  `--license-lf` normalizes line endings). If a pack has none, `pull` says so; then the license
  recorded in curation is all there is.
- `--manifest` records every file's source, pack and content hash, plus each pack's license,
  AI status and a ready-made credit line. Keep one manifest per project and always pass it.
- `--require-ai no` refuses packs not marked human-made. Only add `--force` if the user
  explicitly accepts that pack.
- It never overwrites a different existing file unless you pass `--overwrite`; ask first.
- Use `--dry-run` to show the user what a large pull would copy.

Pull only what the project uses: a folder or a few files, not a 2,000-file pack for one sprite.

## After pulling

- Add the credit lines `pull` printed (also in the manifest under `[packs."..."].credit`) to the
  project's credits, README or about screen. Attribution is mandatory where
  `attribution_required = true`.
- Keep the pulled license files with the assets.
- If the project discloses AI use (for example a Steam store page), the manifest's `ai_generated`
  and `ai_reason` per pack are the record to base it on.

## Don't

- Don't write anything inside the asset library. Curation (licenses, AI status, notes) is edited
  in the browse UI or the profile's TOML files by the user, not by you, unless they ask.
- Don't assume a license from the store or bundle name; use what `show` reports.

© digitalhobbit · MIT · digitalhobbit/assetcat

Похожие скиллы

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
game-design-theory pluginagentmarketplace Скилл game-design-theory для разработки игр на нескольких платформах (Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode). Содержит фреймворки MDA, теорию потока Чиксентмихайи, типы игроков по Барттлу и системы наград. CX Codex +1 2 700установок godot-ui Zate Скилл godot-ui для Claude Code даёт агенту знания о Control-нодах, темах и типовых экранах Godot. Закрывает сборку меню, HUD и инвентаря. CX Codex +1 2 700установок blender-export RobLe3 Скилл blender-export для Claude Code и пяти других платформ, который экспортирует сцены Blender в glTF/GLB, FBX, OBJ, USD и STL с нужными настройками под каждую цель. CX Codex +1 2 600установок blender-animation RobLe3 Скилл blender-animation для ИИ-агента, который ставит ключевые кадры, настраивает кривые и морф-таргеты в Blender через MCP-сервер. CX Codex +1 2 500установок msw-ui-kit MSW-Git Скилл msw-ui-kit для Claude Code, Codex, Cursor и других платформ помогает собирать игровой UI из проверенных активов. CX Codex +1 2 500установок roblox-game-development greedychipmunk Скилл roblox-game-development для разработки игр на Roblox: помогает писать скрипты на Luau, собирать игровые системы и готовить проект к релизу. CX Codex +1 2 400установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой