Agent skill

Pixiv CLI MCP Tool

by FlanChanXwO in FlanChanXwO/pixiv-cli

Add, change, or review a pixiv-cli Pixiv or FANBOX MCP tool, including schema, SDK routing, structured output, errors, and stdio behavior.

MITAuto-check passedAgent Workflows

Install Pixiv CLI MCP Tool

skills CLI
$ npx skills add FlanChanXwO/pixiv-cli --skill pixiv-cli-mcp-tool -a claude-code

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

GitHub CLI
$ gh skill install FlanChanXwO/pixiv-cli pixiv-cli-mcp-tool --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/FlanChanXwO/pixiv-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/pixiv-cli-mcp-tool .claude/skills/pixiv-cli-mcp-tool && 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
pixiv-cli-mcp-tool
GitHub stars
134
Token cost
~750 tokens
SKILL.md length
353 words
Files
2
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Add, change, or review a pixiv-cli Pixiv or FANBOX MCP tool, including schema, SDK routing, structured output, errors, and stdio behavior.

  • Works in 5 steps: Apply the coverage-gap decision: reuse… → Validate schema and local inputs before… → Keep context.Context, cancellation,… → …
  • MCP tool implementation
  • SKILL.md covers Identify ownership and contract and Implement through tests
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Pixiv CLI MCP Tool is an agent skill from FlanChanXwO/pixiv-cli. Add, change, or review a pixiv-cli Pixiv or FANBOX MCP tool, including schema, SDK routing, structured output, errors, and stdio behavior. Use for MCP tool implementation or compatibility work, not routine installed-CLI operation.

Its SKILL.md is about 750 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Agent Workflows, covering MCP servers and Structured output and tool calling. The repository describes itself as: Pixiv, in your terminal — a CLI, MCP server, and Go SDK for discovery, accounts, creators, collections, and downloads. The licence is MIT.

When your agent uses it

  • MCP tool implementation
  • Compatibility work
  • Not routine installed-CLI operation

Example prompts

  • “/pixiv-cli-mcp-tool”

Workflow steps

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

  1. Apply the coverage-gap decision: reuse or extend a registration/schema or real-handler test with synthetic SDK/HTTP fixtures, and add a…
  2. Validate schema and local inputs before opening an SDK snapshot or issuing requests. Reuse typed enums and shared record/pagination…
  3. Keep context.Context, cancellation, account selection, resource lifetime, and operation-specific permissions intact. FANBOX sessions and…
  4. Emit the declared structured result; failures set isError=true without corrupting stdout or exposing credentials. Legitimate empty results…
  5. Run handler/schema tests, registration tests, and relevant SDK/stdio integration tests. A built MCP server is long-lived: use an existing…

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md.

    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 no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Pixiv CLI MCP Tool loads about 750 tokens when it runs. Until then it costs about 62 tokens; SKILL.md has 353 words of instructions outside code blocks.

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

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 FlanChanXwO/pixiv-cli at commit 0f8e913, republished under its MIT licence (© FlanChanXwO). 353 words, ~750 tokens.

Download SKILL.mdSave it as .claude/skills/pixiv-cli-mcp-tool/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
pixiv-cli-mcp-tool
description
Add, change, or review a pixiv-cli Pixiv or FANBOX MCP tool, including schema, SDK routing, structured output, errors, and stdio behavior. Use for MCP tool implementation or compatibility work, not routine installed-CLI operation.

Maintain pixiv-cli MCP Tools

Read root AGENTS.md, pixiv-cli-develop, and the relevant locale MCP reference. Find a current neighboring tool and its registration/tests; do not copy an obsolete bootstrap or application-service pattern.

Identify ownership and contract

Pixiv tools live in internal/mcpserver/pixiv/tools/<tool>; FANBOX tools in the parallel FANBOX owner. Their product roots aggregate registrations. CLI MCP commands start separate stdio servers. Use existing owner-local runtime, record, output, and filter helpers, and the public SDK for product operations.

For reverse search, tool code may depend on the top-level reverse-search service contract, never provider/assembly internals. Keep provider transport and credential wiring in production assembly. Do not introduce a general service locator, shared mutable global client, or anonymous Web fallback.

Define the tool name, input validation, output schema, optional fields, cursor/record semantics, side effects, and error result before implementation. Distinguish unsupported upstream behavior from locally implementable filtering. Exposing a parameter without working semantics is not a capability.

Implement through tests

  1. Apply the coverage-gap decision: reuse or extend a registration/schema or real-handler test with synthetic SDK/HTTP fixtures, and add a new case only for a missing contract. Run it and observe the missing behavior before implementation; do not require one test per adapter function.
  2. Validate schema and local inputs before opening an SDK snapshot or issuing requests. Reuse typed enums and shared record/pagination contracts where they are the owner.
  3. Keep context.Context, cancellation, account selection, resource lifetime, and operation-specific permissions intact. FANBOX sessions and Pixiv pool selection remain separate.
  4. Emit the declared structured result; failures set isError=true without corrupting stdout or exposing credentials. Legitimate empty results remain successful; partial outcomes must not be mislabeled complete.
  5. Run handler/schema tests, registration tests, and relevant SDK/stdio integration tests. A built MCP server is long-lived: use an existing fixture client for smoke verification instead of starting it and waiting for output indefinitely.
Show full SKILL.md (47 more words)Show less

Update both locale MCP references and any affected CLI/SDK/product-skill documentation. Run the existing documentation tests and review the actual diff. Record live/network behavior as unverified unless an authorized real test ran; do not create a new release note or publish a tool as part of ordinary implementation.

© FlanChanXwO, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in .agents/skills/pixiv-cli-mcp-tool of FlanChanXwO/pixiv-cli.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 0f8e913

Compare with similar skills

Pixiv CLI MCP Tool 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 CLI MCP Tool compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pixiv CLI MCP Tool this skillFlanChanXwO/pixiv-cli134—~750Automated safety check: PassMIT
Documentation Serverandrea9293/mcp-documentation-server343—~2.3kAutomated safety check: PassMIT
MCP Auditgetsentry/toolkit920—~1.5kAutomated safety check: PassCustom licence
Spring AI MCP Server Patternsgiuseppe-trisciuoglio/developer-kit357—~2.7kAutomated safety check: NotesMIT
MCP Server Builder with mcp-usemcp-use/mcp-use11k—~923Automated safety check: PassApache-2.0
Agent Tool Builderomer-metin/skills-for-antigravity163—~705Automated safety check: PassApache-2.0

Similar skills

  • Documentation Server

    andrea9293/mcp-documentation-server

    A skill your agent uses when you need to store, retrieve, search, or manage documents in a local knowledge base with semantic search and hybrid (vector + full-text) retrieval.

    343 GitHub stars~2.3k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • MCP Audit

    getsentry/toolkit

    Official

    Audit MCP servers for protocol compliance, metadata drift, and compatibility regressions.

    920 GitHub stars~1.5k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Spring AI MCP Server Patterns

    giuseppe-trisciuoglio/developer-kit

    Provides Spring Boot MCP server patterns that create Model Context Protocol servers with Spring AI by defining tool handlers, exposing resources, configuring prompt templates, and setting up…

    357 GitHub stars~2.7k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check: notes
  • Builds, modifies, debugs, migrates and verifies TypeScript MCP servers and MCP Apps with the mcp-use framework, treating the installed package's types as the source of truth.

    11k GitHub stars~923 tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Agent Tool Builder

    omer-metin/skills-for-antigravity

    Tools are how AI agents interact with the world. An agent skill from omer-metin/skills-for-antigravity.

    163 GitHub stars~705 tokensUpdated 8 mo ago
    AI & LLM EngineeringAuto-check passed
  • Agent Protocol

    borghei/Claude-Skills

    Design AI agent communication protocols: MCP tool schemas, A2A, function calling, and inter- agent messaging.

    891 GitHub stars~1.6k tokensUpdated 3 days ago
    AI & LLM EngineeringAuto-check passed

More from FlanChanXwO/pixiv-cli

All 11 skills in this repo
  • Pixiv CLI

    FlanChanXwO/pixiv-cli

    Operate the installed pixiv CLI to search works and users, reverse-search images with SauceNAO or ascii2d, inspect Pixiv references, read feeds and rankings, and perform explicitly authorized…

    134 GitHub stars~2.8k tokensUpdated yesterday
    Auto-check passed
  • Pixiv CLI CI

    FlanChanXwO/pixiv-cli

    Diagnose pixiv-cli GitHub Actions failures and verify current-head quality, platform, PR-verification, native/browser, and release evidence.

    134 GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Pixiv CLI Code Commenting

    FlanChanXwO/pixiv-cli

    In pixiv-cli, write and review intent-focused code comments, API documentation, docstrings, and numbered workflow stages.

    134 GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • Pixiv CLI Native

    FlanChanXwO/pixiv-cli

    Change or validate pixiv-cli Rust ugoira, cgo/FFI, committed static libraries, vendored dependencies, Linux ABI, and native runner evidence.

    134 GitHub stars~948 tokensUpdated yesterday
    Auto-check passed
  • Pixiv CLI PR

    FlanChanXwO/pixiv-cli

    Prepare, update, or verify a pixiv-cli pull request using its current template, trusted verification policy, reviewed diff, and head-specific check results.

    134 GitHub stars~802 tokensUpdated yesterday
    Auto-check passed
  • Pixiv CLI Docs

    FlanChanXwO/pixiv-cli

    Edit pixiv-cli documentation, AGENTS.md, client bridges, repository maintenance skills, or the distributed product skill.

    134 GitHub stars~997 tokensUpdated yesterday
    Auto-check passed

Questions about Pixiv CLI MCP Tool

What does Pixiv CLI MCP Tool do?

Add, change, or review a pixiv-cli Pixiv or FANBOX MCP tool, including schema, SDK routing, structured output, errors, and stdio behavior. Pixiv CLI MCP Tool is an agent skill from FlanChanXwO/pixiv-cli. Add, change, or review a pixiv-cli Pixiv or FANBOX MCP tool, including schema, SDK routing, structured output, errors, and stdio behavior.

When should I use Pixiv CLI MCP Tool?

Pixiv CLI MCP Tool fits situations like: MCP tool implementation; compatibility work; not routine installed-CLI operation.

How do I install Pixiv CLI MCP Tool in Claude Code?

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

How do I install Pixiv CLI MCP Tool in Codex?

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

Can I use Pixiv CLI MCP Tool 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 FlanChanXwO/pixiv-cli --skill pixiv-cli-mcp-tool -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-cli-mcp-tool, .gemini/skills/pixiv-cli-mcp-tool, .github/skills/pixiv-cli-mcp-tool and .opencode/skills/pixiv-cli-mcp-tool in your project.

What does Pixiv CLI MCP Tool need to run?

SKILL.md names no scripts, command-line tools or credentials: Pixiv CLI MCP Tool is instructions for the agent only.

Does Pixiv CLI MCP Tool 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 CLI MCP Tool 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 Pixiv CLI MCP Tool use?

Pixiv CLI MCP Tool 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 CLI MCP Tool use?

About 750 tokens (SKILL.md is roughly 3k 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 CLI MCP Tool?

Skills that share tags, products or a category with Pixiv CLI MCP Tool: Documentation Server (andrea9293/mcp-documentation-server, 343 stars), MCP Audit (getsentry/toolkit, 920 stars), Spring AI MCP Server Patterns (giuseppe-trisciuoglio/developer-kit, 357 stars) and MCP Server Builder with mcp-use (mcp-use/mcp-use, 11k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pixiv CLI MCP Tool?

FlanChanXwO (a GitHub user) maintains it in FlanChanXwO/pixiv-cli, which has 134 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 9, 2026.

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