mal-tracker

Update MyAnimeList anime and manga entries via natural-language commands.

Updated Apr 3, 2026
One-click install
npx skills add https://github.com/xtasySyrup/mal-tracker --skill mal-tracker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mal-tracker
Source: https://github.com/xtasySyrup/mal-tracker/tree/main
Command: npx skills add https://github.com/xtasySyrup/mal-tracker --skill mal-tracker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many users find updating their MyAnimeList tedious and forget to record watching or reading progress, scores, and list changes. This Skill turns casual natural-language statements into precise list updates, removing friction from maintaining anime and manga lists.

Core Features & Use Cases

  • Natural language parsing of titles, media type (anime or manga), status, episode/chapter progress, and numeric scores.
  • Search and disambiguation using the MAL search endpoints to resolve titles and present alternatives when needed.
  • Authenticated list updates via MAL API v2 my_list_status PUT calls with automatic token refresh; supports creating entries, updating status, progress, and score.
  • Use cases: say "I just finished Attack on Titan, score it an 8" to mark completed with a score, or "Add Berserk to my plan to read" to set a manga to Plan to Read.

Quick Start

Tell the agent to update your MAL by saying I just finished Attack on Titan, mark it as completed with a score of 8.

Frequently Asked Questions about mal-tracker

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update MyAnimeList using natural language?

You can update MyAnimeList by providing natural-language commands like "I just finished Attack on Titan, score it an 8". The Skill parses titles, media type, status, progress, and scores to automate list updates.

How does OAuth2 authentication work for MyAnimeList API integration?

The Skill authenticates with MyAnimeList using OAuth2 PKCE (plain), maintaining access and refresh tokens. It proactively refreshes tokens to ensure authenticated API v2 calls for list updates.

Can I add manga to my Plan to Read list without manual searching?

Yes, you can add manga to your Plan to Read list using natural language. The Skill uses MAL search endpoints to resolve titles and presents alternatives if disambiguation is needed before updating your list.

What MAL API endpoints are used to manage anime and manga list entries?

The Skill uses MAL API v2 search endpoints to find titles and the my_list_status PUT endpoints to perform updates. This supports creating entries, updating status, recording episode or chapter progress, and assigning scores.

Does the MyAnimeList tracker support both anime and manga progress tracking?

Yes, the tracker supports both anime and manga. It parses natural-language statements to record episode progress for anime and chapter progress for manga, applying updates via authenticated MAL API v2 calls.

What should I do if my anime or manga title search returns multiple results?

When title disambiguation is needed, the Skill uses MAL search endpoints to present alternative titles. You can then select the correct anime or manga entry to ensure the list update targets the right item.