Agent skill

Pixiv

Access Pixiv for searching illustrations, manga, and viewing rankings.

Install Pixiv

skills CLI

$ npx skills add CraftOS-dev/CraftBot --skill pixiv -a claude-code

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

GitHub CLI

$ gh skill install CraftOS-dev/CraftBot pixiv --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/CraftOS-dev/CraftBot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/pixiv-skill .claude/skills/pixiv && 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 "pixiv" agent skill from https://github.com/CraftOS-dev/CraftBot/tree/main/skills/pixiv-skill into .claude/skills/pixiv/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pixiv", 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/CraftOS-dev/CraftBot/tree/main/skills/pixiv-skill

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 CraftOS-dev/CraftBot --skill pixiv -a codex

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

GitHub CLI

$ gh skill install CraftOS-dev/CraftBot pixiv --agent codex

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

Manual copy

$ git clone --depth 1 https://github.com/CraftOS-dev/CraftBot.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/pixiv-skill .agents/skills/pixiv && 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 "pixiv" agent skill from https://github.com/CraftOS-dev/CraftBot/tree/main/skills/pixiv-skill into .agents/skills/pixiv/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pixiv", 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 CraftOS-dev/CraftBot --skill pixiv -a cursor

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

GitHub CLI

$ gh skill install CraftOS-dev/CraftBot pixiv --agent cursor

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

Manual copy

$ git clone --depth 1 https://github.com/CraftOS-dev/CraftBot.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/pixiv-skill .cursor/skills/pixiv && 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 "pixiv" agent skill from https://github.com/CraftOS-dev/CraftBot/tree/main/skills/pixiv-skill into .cursor/skills/pixiv/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pixiv", 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/CraftOS-dev/CraftBot.git --path skills/pixiv-skill

--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 CraftOS-dev/CraftBot --skill pixiv -a gemini-cli

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

GitHub CLI

$ gh skill install CraftOS-dev/CraftBot pixiv --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/CraftOS-dev/CraftBot.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/pixiv-skill .gemini/skills/pixiv && 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 "pixiv" agent skill from https://github.com/CraftOS-dev/CraftBot/tree/main/skills/pixiv-skill into .gemini/skills/pixiv/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pixiv", 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 CraftOS-dev/CraftBot pixiv

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 CraftOS-dev/CraftBot --skill pixiv -a github-copilot

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

Manual copy

$ git clone --depth 1 https://github.com/CraftOS-dev/CraftBot.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/pixiv-skill .github/skills/pixiv && 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 "pixiv" agent skill from https://github.com/CraftOS-dev/CraftBot/tree/main/skills/pixiv-skill into .github/skills/pixiv/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pixiv", 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 CraftOS-dev/CraftBot --skill pixiv -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 CraftOS-dev/CraftBot pixiv --agent opencode

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

Manual copy

$ git clone --depth 1 https://github.com/CraftOS-dev/CraftBot.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/pixiv-skill .opencode/skills/pixiv && 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 "pixiv" agent skill from https://github.com/CraftOS-dev/CraftBot/tree/main/skills/pixiv-skill into .opencode/skills/pixiv/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pixiv", 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: pixiv
GitHub stars: 392
Token cost: ~785 tokens
SKILL.md length: 301 words
Files: 7 (incl. scripts)
Skills in repo: 89
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Access Pixiv for searching illustrations, manga, and viewing rankings.

Works in 2 steps: Ask the user for their Pixiv Refresh… → Run: node…
Tasks that involve Comics and storyboards
SKILL.md covers Setup, Usage and How to get a Token (for User)
Runs JavaScript and Shell scripts from its folder; calls node; needs REFRESH_TOKEN

What it does

Pixiv is an agent skill from CraftOS-dev/CraftBot. Access Pixiv for searching illustrations, manga, and viewing rankings. Supports searching by keyword and viewing daily/weekly/monthly rankings.

Its SKILL.md is about 790 tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts (for example `README.md`, `_meta.json` and `scripts/download-ugoira.js`).

It sits in Media & Creative, covering Comics and storyboards. The repository describes itself as: One agent. Every kind of work. The licence is MIT.

When your agent uses it

Tasks that involve Comics and storyboards

Example prompts

“/pixiv”

Requirements

Node.js
A Bash shell
A credential in REFRESH_TOKEN

Workflow steps

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

Ask the user for their Pixiv Refresh Token.
Run: node skills/pixiv/scripts/pixiv-cli.js login

What it can do on your machine

Read from SKILL.md and the folder at commit b50970c. 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
Ships 4 files in scripts/ (JavaScript and Shell), which the agent can run.
Shell commands in SKILL.md call:
- node
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:
- REFRESH_TOKEN
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Pixiv loads about 785 tokens when it runs. Until then it costs about 37 tokens; SKILL.md has 301 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from CraftOS-dev/CraftBot at commit b50970c, republished under its MIT licence (© CraftOS-dev). 301 words, ~785 tokens.

Download SKILL.mdSave it as .claude/skills/pixiv/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.

name: pixiv
description: Access Pixiv for searching illustrations, manga, and viewing rankings. Supports searching by keyword and viewing daily/weekly/monthly rankings.

Pixiv Skill

This skill allows searching and browsing Pixiv illustrations.

Setup

Before using, you must have a valid Pixiv Refresh Token. The token is stored in config.json inside the skill directory.

To configure:

Ask the user for their Pixiv Refresh Token.
Run: node skills/pixiv/scripts/pixiv-cli.js login <REFRESH_TOKEN>

Usage

Searching Illustrations

To search for illustrations by keyword:

bash

node skills/pixiv/scripts/pixiv-cli.js search "KEYWORD" [PAGE]

Example:

bash

node skills/pixiv/scripts/pixiv-cli.js search "miku" 1

Returns a JSON array of illustration details (title, url, tags, user, etc.).

Viewing Rankings

To view rankings:

bash

node skills/pixiv/scripts/pixiv-cli.js ranking [MODE] [PAGE]

Modes: day, week, month, day_male, day_female, week_original, week_rookie, day_ai. Default is day.

Example:

bash

node skills/pixiv/scripts/pixiv-cli.js ranking day

Viewing User Profile

To view a user's profile details:

bash

node skills/pixiv/scripts/pixiv-cli.js user <USER_ID>

Example:

bash

node skills/pixiv/scripts/pixiv-cli.js user 11

Viewing Logged-in User Profile (Me)

To view the profile of the currently logged-in account (based on Refresh Token):

bash

node skills/pixiv/scripts/pixiv-cli.js me

Viewing Followed Users (Following)

To list users that the logged-in account follows:

bash

node skills/pixiv/scripts/pixiv-cli.js following [PAGE]

Viewing Feed (New Works from Followed Users)

To view latest illustrations from followed users:

bash

node skills/pixiv/scripts/pixiv-cli.js feed [RESTRICT] [PAGE]

RESTRICT can be all, public, or private. Default is all.

Downloading Illustrations

To download an illustration (single image, manga/multiple, or ugoira zip):

bash

node scripts/pixiv-cli.js download <ILLUST_ID>

Files are saved to downloads/<ILLUST_ID>/. Returns JSON containing the list of downloaded files.

Publishing Illustrations (New)

To publish a new illustration directly to Pixiv using the AppAPI v2 (pure code, no browser needed):

bash

node scripts/pixiv-cli.js post <FILEPATH> "<TITLE>" "[TAGS_COMMA_SEPARATED]" [VISIBILITY]

VISIBILITY: public (default), login_only, mypixiv, or private.
Automatic AI-generated tagging (illust_ai_type: 2) is applied by default.

Example:

bash

node scripts/pixiv-cli.js post "./output.png" "My New Art" "Original, Girl, AI" private

How to get a Token (for User)

If the user asks how to get a token:

Direct them to look up "Pixiv Refresh Token" or use a tool like gppt (Get Pixiv Token).
Or tell them to log in to Pixiv in their browser, and look for the refresh_token in Local Storage or Cookies (though OAuth refresh token is cleaner).
The easiest way for non-technical users is to use a helper script, but we don't have one here. Just ask them to provide it.

Files

SKILL.md and 6 other files (scripts) in skills/pixiv-skill of CraftOS-dev/CraftBot.

SKILL.md
README.md
_meta.json
scripts/download-ugoira.js
scripts/pack.sh
scripts/pixiv-app-publish.js
scripts/pixiv-cli.js

Open the folder on GitHubat commit b50970c

Compare with similar skills

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

Pixiv compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Pixiv this skillCraftOS-dev/CraftBot	392	—	~785	Automated safety check: Pass	MIT	today
Canghe Comicfreestylefly/canghe-skills	461	8 repos	~3.2k	Automated safety check: Pass	None	4 mo ago
Tutti UI Systemtutti-os/tutti	3.8k	—	~2.7k	Automated safety check: Pass	Apache-2.0	1 mo ago
3D Animation Short Generatortl2012tl/comfyUI-llama-TE	239	4 repos	~3.7k	Automated safety check: Pass	None	15 days ago
Text to PNG Card Casterlijigang/ljg-skills	7.5k	—	~1.9k	Automated safety check: Pass	MIT	yesterday
Video ComposeUtopai-Research/pai-code	354	1 repos	~4.1k	Automated safety check: Pass	Custom licence	8 days ago

Similar skills

Canghe Comic
freestylefly/canghe-skills
Knowledge comic creator supporting multiple art styles and tones.
461 GitHub starsUsed in 8 repos~3.2k tokens
Media & CreativeAuto-check passed
Tutti UI System
tutti-os/tutti
A skill your agent uses when working with @tutti-os/ui-system components, replacing local UI with shared components, querying component ids or metadata, promoting UI into shared base or business…
3.8k GitHub stars~2.7k tokensUpdated 1 mo ago
Media & CreativeAuto-check passed
3D Animation Short Generator
tl2012tl/comfyUI-llama-TE
Create complete stylized 3D animated shorts from a story idea through an ordered production workflow covering project brief, story outline, character and environment cards, standardized shot…
239 GitHub starsUsed in 4 repos~3.7k tokens
Media & CreativeAuto-check passed
Text to PNG Card Caster
lijigang/ljg-skills
Turns text, URLs or local files into tall PNG cards through HTML typography, with four modes: long reading card, full-text layout, comic and whiteboard.
7.5k GitHub stars~1.9k tokensUpdated yesterday
Media & CreativeAuto-check passed
Video Compose
Utopai-Research/pai-code
Generates and prompts video clips on the filmmaking canvas. An agent skill from Utopai-Research/pai-code.
354 GitHub starsUsed in 1 repo~4.1k tokens
Media & CreativeAuto-check passed
H3 Cinematic Director
jtydhr88/ComfyTV
Convert approved scripts, shot briefs, storyboards, keyframes, character sheets, scene assets, prop sheets, and sound briefs into director-level storyboards and production-ready MiniMax H3 prompts.
1.1k GitHub stars~2.7k tokensUpdated yesterday
Media & CreativeAuto-check passed

Questions about Pixiv

What does Pixiv do?

Access Pixiv for searching illustrations, manga, and viewing rankings. Pixiv is an agent skill from CraftOS-dev/CraftBot. Access Pixiv for searching illustrations, manga, and viewing rankings.

When should I use Pixiv?

Pixiv fits situations like: tasks that involve Comics and storyboards.

How do I install Pixiv in Claude Code?

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

How do I install Pixiv in Codex?

Run `npx skills add CraftOS-dev/CraftBot --skill pixiv -a codex`. Or copy the skill folder (skills/pixiv-skill in CraftOS-dev/CraftBot) into .agents/skills/pixiv in your project. Codex loads it when a task matches its description.

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

What does Pixiv need to run?

Going by SKILL.md and its folder, Pixiv needs JavaScript and a shell for the scripts in its folder, the command-line tools its instructions call (node) and credentials named REFRESH_TOKEN. Our summary lists: Node.js; A Bash shell; A credential in REFRESH_TOKEN.

Does Pixiv 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 Pixiv 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Pixiv use?

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

About 785 tokens (SKILL.md is roughly 3.1k 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 Pixiv?

Skills that share tags, products or a category with Pixiv: Canghe Comic (freestylefly/canghe-skills, 461 stars), Tutti UI System (tutti-os/tutti, 3.8k stars), 3D Animation Short Generator (tl2012tl/comfyUI-llama-TE, 239 stars) and Text to PNG Card Caster (lijigang/ljg-skills, 7.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pixiv?

CraftOS-dev (a GitHub user) maintains it in CraftOS-dev/CraftBot, which has 392 GitHub stars. The repository holds 89 skills in this directory. The repository was last updated on October 7, 2026.

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

Install Pixiv

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Pixiv Skill

Setup

Usage

Searching Illustrations

Viewing Rankings

Viewing User Profile

Viewing Logged-in User Profile (Me)

Viewing Followed Users (Following)

Viewing Feed (New Works from Followed Users)

Downloading Illustrations

Publishing Illustrations (New)

How to get a Token (for User)

Files

Compare with similar skills

Similar skills

More from CraftOS-dev/CraftBot

Related

Questions about Pixiv