Skip to content
Back to search

quark-drive

MarketplaceWorks with Claude CodeGitHub

Quark Drive Skills: Pokemon Champions Agent Skills for dex and metagame facts, exact battle calculations, and audited team building. Companion interface: Quark Drive Web.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026. Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/pmwl0128/quark_drive_skills with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/pmwl0128/quark_drive_skills'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/pmwl0128--quark-drive-skills/badge.svg)](/listings/pmwl0128--quark-drive-skills)

HTML

<a href="/listings/pmwl0128--quark-drive-skills"><img src="/api/listings/pmwl0128--quark-drive-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

You need **Python 3.10+**. The calculator uses `quickjs-ng` by default and falls back to Node.js if it is unavailable. Ordinary dex, metagame, and team queries need no other Python packages.

The easiest option is to give an assistant with terminal access this request:

> Install all four skills from https://github.com/pmwl0128/quark_drive_skills for this agent. Install `quickjs-ng>=0.15`, or verify the Node.js fallback if that fails. Check that the agent can discover every `SKILL.md`, then run the calculator's `schema` command.

You can also install them yourself:

| Agent | Installation | |---|---| | Claude Code | Use the plugin commands below, or copy the four folders from `.agents/skills/` into `~/.claude/skills/`. | | Codex | Copy the four folders from `.agents/skills/` into `~/.agents/skills/`. | | WorkBuddy | Import local skill packages through **Add skill → Upload skill** in the Skills page. See the [official instructions](https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Skills-Market). | | Other compatible agents | Copy the four skill folders into the directory your agent reads, or use the `skills` installer below. |

Claude Code plugin commands:

/plugin marketplace add pmwl0128/quark_drive_skills
/plugin install quark-drive-skills@quark-drive

If you still have the old plugin, remove it first with `/plugin uninstall pokemon-champions@pmwl`.

With Node.js installed, the [Vercel Skills CLI](https://github.com/vercel-labs/skills) offers an interactive installer:

npx skills add pmwl0128/quark_drive_skills

Add `-g` to install globally. For a manual installation, download or clone this repository, copy the four skill directories, then install the calculator runtime:

python -m pip install "quickjs-ng>=0.15"

The installed folders should be `pokemon-champions-dex`, `pokemon-champions-meta`, `ncp-damage-calculator`, and `pokemon-champions-team`. Start a new agent session and ask a dex question, then a team-building question, to check that it selects the right skill.

To update, use `npx skills update`, `/plugin marketplace update`, or repeat your copy/import installation with the latest repository contents. Update all four skills together. The `.claude/skills/` tree is a mirror of `.agents/skills/`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 25 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "quark-drive",
  3. "owner": {
  4. "name": "pmwl",
  5. "email": "pmwl@outlook.com"
  6. },
  7. "plugins": [
  8. {
  9. "name": "quark-drive-skills",
  10. "source": "./",
  11. "description": "Quark Drive Skills: four Pokémon Champions skills for dex and metagame facts, exact damage and Speed calculations, and audited Singles/Doubles team building.",
  12. "homepage": "https://github.com/pmwl0128/quark_drive_skills",
  13. "license": "MIT",
  14. "keywords": [
  15. "quark-drive",
  16. "pokemon",
  17. "pokemon-champions",
  18. "team-building",
  19. "agent-skills",
  20. "damage-calculator",
  21. "i18n"
  22. ]
  23. }
  24. ]
  25. }
README.md · README · 199 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <h1 align="center">Quark Drive Skills</h1>
  2. <p align="center">
  3. <img alt="skills" src="https://img.shields.io/badge/skills-4-blue"/>
  4. <img alt="modes" src="https://img.shields.io/badge/single%20%26%20double-supported-success"/>
  5. <img alt="query" src="https://img.shields.io/badge/query-offline--first-success"/>
  6. <img alt="languages" src="https://img.shields.io/badge/names-zh%20%7C%20en%20%7C%20ja-orange"/>
  7. <img alt="agents" src="https://img.shields.io/badge/Claude%20Code%20%7C%20Codex-Agent%20Skills-blueviolet"/>
  8. <img alt="license" src="https://img.shields.io/badge/license-MIT-green"/>
  9. </p>
  10. <p align="center">
  11. <b>Metagame snapshot</b> · M-8 / M-C · updated <b>2026-11-18</b>
  12. </p>
  13. <p align="center">
  14. <b>English</b> | <a href="README_zh.md">中文</a> | <a href="README_ja.md">日本語</a>
  15. </p>
  16. <p align="center">
  17. <a href="https://champion.mpan.top">Try Quark Drive Web</a> · <a href="https://github.com/pmwl0128/quark_drive_skills/releases/tag/data-latest">Downloads</a>
  18. </p>
  19. ---
  20. Four Agent Skills for Pokémon Champions: dex and metagame lookups, damage calculations, and team building, diagnosis, and SP tuning grounded in data and a defined workflow. Support Singles, Doubles, and names in English, Chinese, and Japanese. Use them with Claude Code, Codex, WorkBuddy, or another agent that can load Agent Skills and run local Python.
  21. ## Install
  22. Requires Python 3.10 or later. The calculator uses `quickjs-ng` by default and falls back to Node.js if it is unavailable. Ordinary dex, metagame, and team queries need no other Python packages.
  23. Team-code imports also work in team text inputs and import menus across Web and Console, and in assistant questions and team diagnosis. Enter one public code per import. Operators must configure an independently registered query identity or their own query gateway; setup and optional network dependencies are documented in the [team-code guide](.agents/skills/pokemon-champions-team/references/team-codes.md).
  24. The easiest option is to give an assistant with terminal access this request:
  25. > Install all four skills from https://github.com/pmwl0128/quark_drive_skills for this agent. Install `quickjs-ng>=0.15`, or verify the Node.js fallback if that fails. Check that the agent can discover every `SKILL.md`, then run the calculator's `schema` command.
  26. You can also install them yourself:
  27. | Agent | Installation |
  28. |---|---|
  29. | Claude Code | Use the plugin commands below, or copy the four folders from `.agents/skills/` into `~/.claude/skills/`. |
  30. | Codex | Copy the four folders from `.agents/skills/` into `~/.agents/skills/`. |
  31. | WorkBuddy | Import local skill packages through **Add skill → Upload skill** in the Skills page. See the [official instructions](https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Skills-Market). |
  32. | Other compatible agents | Copy the four skill folders into the directory your agent reads, or use the `skills` installer below. |
  33. Claude Code plugin commands:
  34. ```text
  35. /plugin marketplace add pmwl0128/quark_drive_skills
  36. /plugin install quark-drive-skills@quark-drive
  37. ```
  38. If you still have the old plugin, remove it first with `/plugin uninstall pokemon-champions@pmwl`.
  39. With Node.js installed, the [Vercel Skills CLI](https://github.com/vercel-labs/skills) offers an interactive installer:
  40. ```bash
  41. npx skills add pmwl0128/quark_drive_skills
  42. ```
  43. Add `-g` to install globally. For a manual installation, download or clone this repository, copy the four skill directories, then install the calculator runtime:
  44. ```bash
  45. python -m pip install "quickjs-ng>=0.15"
  46. ```
  47. The installed folders should be `pokemon-champions-dex`, `pokemon-champions-meta`, `ncp-damage-calculator`, and `pokemon-champions-team`. Start a new agent session and ask a dex question, then a team-building question, to check that it selects the right skill.
  48. To update, use `npx skills update`, `/plugin marketplace update`, or repeat your copy/import installation with the latest repository contents. Update all four skills together. The `.claude/skills/` tree is a mirror of `.agents/skills/`.
  49. ## How to use
  50. Describe what you want in your own words. Paste a Showdown export, attach a readable screenshot, or ask the assistant to read a local team or roster file.
  51. | Skill | What to ask |
  52. |---|---|
  53. | `pokemon-champions-dex` | Types, base stats, abilities, learnsets, items, natures, and Mega Stones. Supports name lookup across all three languages and questions such as “Which Fairy-types learn Earth Power?” |
  54. | `pokemon-champions-meta` | Current and historical usage, common moves and items, partners, SP spreads, and changes between snapshots. Singles and Doubles are kept separate. |
  55. | `ncp-damage-calculator` | Damage rolls, OHKO/2HKO chances, survival benchmarks, and Speed tiers under specified sets and field conditions. |
  56. | `pokemon-champions-team` | Build or revise a team, check legality and coverage, compare matchups, plan bring-three/bring-four selections, and tune SP to specific benchmarks. It calls the other skills as needed. |
  57. For example:
  58. ```text
  59. Build a Tailwind Doubles team around Mega Metagross.
  60. Improve the team in team.txt against the current top 30. Keep Incineroar, and explain the benefits and trade-offs of each replacement.
  61. Use only the Pokémon in roster.md, and suggest a bring-four plan for this matchup.
  62. ```
  63. For ongoing use, keep your roster, team versions, and battle notes in a project folder, with this repository's [AGENTS.md](AGENTS.md) or [CLAUDE.md](CLAUDE.md) as the agent instructions. Feed back your experience and requirements after playing. That gives the assistant a clearer idea of what you want from the next revision.
  64. ### What the results mean
  65. The tools handle data, arithmetic, and legality checks; your assistant chooses candidates and explains the trade-offs. Team work starts by checking your constraints, consulting the metagame and observed teams, and comparing candidates before checking the final recommendation. Data and workflow requirements help prevent incorrect facts, illegal movesets, and calculation errors. More involved work, such as building or diagnosing a team, still needs to be judged in battle. A more capable model with broader background knowledge can substantially improve the result.
  66. If the assistant occasionally skips tools and improvises an answer, ask it to read `pokemon-champions-team/SKILL.md` and follow the full workflow, including candidate comparison and final checks. Skill activation and instruction following vary by agent and model.
  67. - **Champions data only.** Stats, learnsets, and mechanics can differ from the main-series games. Only content available in Champions is covered.
  68. - **Legality has three outcomes.** `valid` passed the available checks; `invalid` has identified errors; `unknown` needs more information.
  69. - **Calculations depend on the input.** State the sets, stat stages, field, and assumptions. KO/CHECK tables describe the evaluated damage and Speed relationships, with limited coverage of setup, recovery, status, and longer sequences. Use your actual sets when reviewing your own team; standard sets are references with lower confidence.
  70. ## Browser interface
  71. Try the basic tools in **[Quark Drive Web](https://champion.mpan.top)**: browse the metagame and dex, calculate damage and Speed, check matchup tables, and save teams. Browsing and browser calculations need no account. Online Q&A, the simplified builder, diagnosis, and explanations depend on enabled features and service quotas. The builder returns one result from a form; ongoing team discussion is available through a local assistant.
  72. The downloadable local interface is **Quark Drive Console**. It adds a local workspace and sessions where you can pass work to an assistant, answer its questions, and review its results.
  73. | | Online | Local |
  74. |---|---|---|
  75. | Rankings, dex, calculations, matchup tables, quick survival checks | Available | Available |
  76. | Teams, Pokémon Box, calculation history | Stored in this browser | Stored in a workspace folder |
  77. | Exact SP tuning | Subject to enabled features and service limits | Available |
  78. | AI team work | Online features and quotas | Your local assistant and its own setup |
  79. | Session handoffs and checkpoint decisions | Unavailable | Available |
  80. ### Run the local bundle
  81. Download [Quark_Drive_Web.zip](https://github.com/pmwl0128/quark_drive_skills/releases/download/data-latest/Quark_Drive_Web.zip), extract it, and open a terminal in the extracted folder. You need Python 3.10+, but no Node.js for this prebuilt bundle.
  82. Windows PowerShell:
  83. ```powershell
  84. python -m pip install -r requirements-runtime.txt
  85. .\start-local.ps1
  86. ```
  87. Linux / macOS:
  88. ```bash
  89. python3 -m pip install -r requirements-runtime.txt
  90. chmod +x start-local.sh
  91. ./start-local.sh
  92. ```
  93. Open the full `http://127.0.0.1:<port>/#bootstrap=...` link printed by the launcher. Each link works once. Run `python bridge/pcui open` from the extracted folder for another link. To change the port, set `PCUI_LOCAL_PORT` in `~/.pokemon-champions/pc.env`.
  94. For assistant collaboration, follow the local home page's setup card. `python bridge/pcui install-agent` installs the companion instructions; add `--target codex` for Codex. Send the handoff from a session page to your assistant, then answer questions and checkpoint decisions on that page. MCP clients can use `python bridge/pcui mcp`; `--print-config` prints registrations for Claude Code and Codex.
  95. <details>
  96. <summary>Build from source</summary>
  97. You need Python 3.10+ and Node.js 22, matching release verification.
  98. ```powershell
  99. git clone https://github.com/pmwl0128/quark_drive_skills.git
  100. Set-Location .\quark_drive_skills
  101. python -m pip install -r frontend/requirements-ui.txt
  102. .\frontend\build-ui.ps1
  103. .\frontend\start-ui.ps1
  104. ```
  105. On Linux/macOS use `frontend/build-ui.sh` and `frontend/start-ui.sh` after making them executable. The build script installs npm dependencies, builds the data projection, and builds the UI. Keep the bridge, skills, projection, and UI from the same snapshot.
  106. </details>
  107. ### Storage, privacy, and updates
  108. Local browsing and calculations require no hosted-model key, and the service listens on `127.0.0.1` by default. The prebuilt bundle stores your workspace in `~/.pokemon-champions/workspace`; a source checkout uses `storage` under the launch directory. You can move it on the Storage page. Stop the service and copy the entire workspace folder to back it up.
  109. Online AI features send the relevant input to the service. A local assistant follows its own provider's data handling, even when the tools run locally.
  110. To update the bundle, extract a complete new download into a new folder. If you put the workspace inside the old application folder, move it before deleting that folder. For source installations, update the checkout and rerun the build/start scripts. Replacing individual generated folders can mix incompatible snapshots.
  111. ## Data and downloads
  112. Normal skill queries read the bundled data locally. Check the season, regulation, and snapshot date above or in the UI, and update the package when you need newer data. Historical seasons can be consulted through the Excel workbooks; the latest Skills release does not include historical regulations or datasets.
  113. The rolling [data-latest release](https://github.com/pmwl0128/quark_drive_skills/releases/tag/data-latest) includes:
  114. - Workbooks in [English](https://github.com/pmwl0128/quark_drive_skills/releases/download/data-latest/workbook_en.xlsx), [Chinese](https://github.com/pmwl0128/quark_drive_skills/releases/download/data-latest/workbook_zh.xlsx), and [Japanese](https://github.com/pmwl0128/quark_drive_skills/releases/download/data-latest/workbook_ja.xlsx), with Singles/Doubles tables and a factual update report. No AI commentary is added. Running `export-excel` yourself requires `openpyxl>=3.1`.
  115. - [Singles](https://github.com/pmwl0128/quark_drive_skills/releases/download/data-latest/trend_single_en.png) and [Doubles](https://github.com/pmwl0128/quark_drive_skills/releases/download/data-latest/trend_double_en.png) rank charts covering up to ten recent refreshes, also available in Chinese and Japanese. KO lists show ranks, not usage percentages; their coverage and capture dates can differ from usage data.
  116. - The prebuilt local interface linked above. Rolling files are replaced with each release.
  117. ### Sources and thanks
  118. | Data | Sources |
  119. |---|---|
  120. | Metagame | [Silph Scope](https://silph-scope.com/) is the primary source; [GameWith](https://gamewith.jp/), [PokeChamp DB](https://pokechamdb.com/), and [MetaRoll](https://metaroll.app/ladder) provide fallback data. |
  121. | Dex and names | [Serebii](https://www.serebii.net/), [52Poke](https://wiki.52poke.com/), [PokéAPI](https://pokeapi.co/) |
  122. | Calculation engine | Bundled [NCP VGC Damage Calculator](https://github.com/nerd-of-now/NCP-VGC-Damage-Calculator) core, independently checked against [smogon/damage-calc](https://github.com/smogon/damage-calc). |
  123. | Singles teams | [Yakkun](https://yakkun.com/), [OP.GG](https://op.gg/), [GameWith](https://gamewith.jp/), [Game8](https://game8.jp/), [POCH](https://poch.ms/en) |
  124. | Doubles teams | [Limitless](https://play.limitlesstcg.com/), [Nimbasa City Post](https://www.nimbasacitypost.com/), [VGCPastes / Pokepaste](https://pokepast.es/) |
  125. Thanks to the authors, tournament organizers, and contributors who publish these resources. The release contains processed query data, not raw scrape caches.
  126. Special thanks to [Silph Scope](https://silph-scope.com/) for their help with the metagame query API and team-code lookup.
  127. ## Roadmap
  128. - Reduce repeated tool calls and improve workflow consistency across agents.
  129. - Improve team analysis where battle context and uncertain information affect the recommendation.
  130. - Improve online delivery and response times, and adjust capacity to actual demand.
  131. ## License
  132. The project uses the [MIT license](LICENSE). The NCP calculator's upstream terms are retained in `ncp-damage-calculator/references/upstream-LICENSE`; see [NOTICE](NOTICE) for attribution.
  133. Pokémon and character names are trademarks of Nintendo / Creatures Inc. / GAME FREAK inc. This is an unofficial fan project with no affiliation or endorsement.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.