← Back to Skills Marketplace
mtsku

AniList CLI

by matsku · GitHub ↗ · v0.3.2
cross-platform ✓ Security Clean
346
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install anilist
Description
CLI for searching, retrieving anime and manga information, interacting with user profile and lists on Anilist, and more.
README (SKILL.md)

AniList CLI Skill

Use this skill for direct AniList CLI workflows. This guide is for LLM/agent execution only.

Installation Check

  1. Check availability:
    • command -v anilistcli
  2. If missing, install:
    • npm install -g @mtsku/anilist-cli
  3. Verify:
    • anilistcli --help

Command Map

  • Discovery:
    • anilistcli discover seasonal --season WINTER --year 2026 -n 20
    • anilistcli discover upcoming -n 15
  • Airing:
    • anilistcli airing upcoming --hours 48 -n 25
    • anilistcli airing next "\x3Ctitle>"
    • anilistcli airing mine --hours 72 --limit 50
  • Search/media:
    • anilistcli search anime "\x3Cquery>" -n 5
    • anilistcli media recs "\x3Ctitle>" -n 10
    • anilistcli media relations "\x3Canilist-url-or-title>"
  • Profile/social:
    • anilistcli profile [username]
    • anilistcli friends [username] -n 50
  • List management:
    • anilistcli mine summary --hours 72 -n 10
    • anilistcli list view --type anime --status-in "CURRENT,PLANNING"
    • anilistcli planning add "\x3Ctitle>"
    • anilistcli status set "\x3Ctitle>" CURRENT
    • anilistcli progress set "\x3Ctitle>" 12

Auth Setup

  • Set token:
    • anilistcli auth set-token "\x3Ctoken>"
  • Verify auth:
    • anilistcli auth where

Output Mode

  • Use --json for machine-readable output.
  • Public read endpoints work without auth.
  • For mutations, run --dry-run first unless explicit write execution is requested.
  • Quote title inputs that include spaces.
Usage Guidance
This skill appears coherent for running an AniList CLI, but before installing: 1) check the npm package page (npmjs) and repository for @mtsku/anilist-cli — confirm the maintainer, recent activity, and source code. 2) Prefer installing in a contained environment (container or VM) or install locally rather than globally to limit system impact. 3) Inspect the package source (or its GitHub repo) to see how it stores auth tokens (where it writes config). 4) Only provide your AniList token if you trust the package; if unsure, use public read endpoints without auth or use a known upstream client. If you can't find a trustworthy source for the npm package, treat the install as risky and avoid providing secrets.
Capability Analysis
Type: OpenClaw Skill Name: anilist Version: 0.3.2 The skill provides a standard interface for the AniList CLI tool, allowing an agent to search for anime/manga and manage user lists. It uses a public npm package (@mtsku/anilist-cli) for installation and provides clear, functional instructions in SKILL.md that align with its stated purpose without any evidence of malicious intent or prompt injection.
Capability Assessment
Purpose & Capability
Name and description describe an AniList CLI. Declared requirement (node) and the install package (@mtsku/anilist-cli) align with that purpose; the CLI binary anilistcli matches commands listed in SKILL.md.
Instruction Scope
SKILL.md only instructs the agent to check for the binary, optionally run npm install -g, and execute anilistcli commands (search, discover, profile, list management, auth). It does not instruct reading unrelated files or env vars. Note: it recommends a global npm install which modifies system-wide node modules.
Install Mechanism
Install uses npm (package @mtsku/anilist-cli), which is a common and expected mechanism for Node CLIs. However, the skill metadata lists no homepage/source and the registry owner is not human-readable; this reduces traceability and increases risk of installing an untrusted npm package.
Credentials
The skill declares no required environment variables and the SKILL.md references only a token provided via the CLI (anilistcli auth set-token). That is proportional to an API-backed CLI. The SKILL.md does not disclose where the token will be stored (local config file, home directory, etc.), which is an implementation detail worth verifying.
Persistence & Privilege
The skill is not always-enabled and does not request system config paths or other skills' credentials. The main persistent effect is installing a global npm binary and whatever config the CLI writes locally when you run auth set-token.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install anilist
  3. After installation, invoke the skill by name or use /anilist
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.3.2
- Added OpenClaw metadata for installation and binary requirements. - Updated installation and command verification steps for improved clarity. - Reorganized command examples under functional categories. - Simplified and clarified agent execution and output guidelines. - Updated authentication setup instructions.
v0.3.1
- Updated description to emphasize searching, retrieving anime/manga information, and interacting with user profiles and lists. - No changes to usage, commands, or install instructions.
v0.3.0
**Significant update to usage guidance and command structure.** - Rewrites and simplifies documentation, focusing on installation and direct command use. - Switches all usage to `anilistcli` instead of `anilistctl`. - Provides clear agent rules for execution, authentication, and safe mutation practices. - Adds new command templates covering search, friends, and direct profile access. - Removes previous detailed Bash command mappings for more concise usage patterns.
v0.2.1
- Added detailed usage, installation, and authentication instructions to SKILL.md. - Listed key AniList CLI commands for discovery, airing schedules, recommendations, and list updates. - Described fast-path command mappings for common user intents. - Clarified token precedence and provided token setup instructions. - Included notes on public data access, write permissions, and input validation. - Improved documentation for end users and developers.
Metadata
Slug anilist
Version 0.3.2
License
All-time Installs 0
Active Installs 0
Total Versions 4
Frequently Asked Questions

What is AniList CLI?

CLI for searching, retrieving anime and manga information, interacting with user profile and lists on Anilist, and more. It is an AI Agent Skill for Claude Code / OpenClaw, with 346 downloads so far.

How do I install AniList CLI?

Run "/install anilist" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is AniList CLI free?

Yes, AniList CLI is completely free (open-source). You can download, install and use it at no cost.

Which platforms does AniList CLI support?

AniList CLI is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created AniList CLI?

It is built and maintained by matsku (@mtsku); the current version is v0.3.2.

💬 Comments