agentleFS
Sign inStart free
MichaelPrutkowMichaelPrutkow/anki-for-claude/skills/check-setup/SKILL.md

check-setup

Skill3 starsChanged 19 days agoMITView on GitHub

Checks whether the anki plugin can work on the user's computer - Anki running with the AnkiConnect add-on, the Image Occlusion note type, Graphviz, AnkiWeb sync - and tells the user exactly how to fix what is missing. Use right after the plugin is installed, when the anki tools are missing or fail, or when the user asks whether everything is set up.

  • Installs packages

1 other project uses a version of this.

Adopted by

Most recently taken up by

  • Other versions1 project uses a version of this.

    Word for word · 1

    1. MichaelPrutkow/anki-mcp-server★ 3100% same

    Edited · 0

    None found.

    Wrote their own version · 0

    None found.

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository4 other files it gives its agents.

The file

We split this skill into the rules it gives an agent

2 rules. About 0 are common, 1 is distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Update the plugin to the newest version.

    line 16
  2. Very specific:

    Anki and AnkiConnect: Call overview.

    line 17

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Checking the setup

The anki tools run in a small server on the user's computer and talk to Anki through the AnkiConnect add-on. You can test the setup through these tools, but you cannot install programs or click anything in Anki for the user. For every problem, tell the user exactly what to do. Only if you can run commands on the user's computer yourself (for example in Claude Code) may you offer to run an install command for them.

Go through the steps in order. Stop at the first one that fails, explain the fix, and continue once the user has done it.

  1. The anki tools exist. If overview is not among your tools, call get_device_info (search for it if it is not loaded) and search for the anki tools again. If they are still missing, this chat does not reach the plugin's server on the user's computer; whether Anki is open does not matter for this. Give the user these fixes in this order, each one only if the one before did not help:
    • In the Claude app: start a new chat, add a folder with the Add folder button before sending the first message (for example the folder with the study material), then send the request again. A chat reaches the tools on the user's computer reliably only with a folder.
    • Quit the Claude app completely, open it again and start a new chat. The first start can take a minute while the plugin's dependencies download.
    • The server runs on the Python that Anki 25.07 or newer brings along, or on uv if it is installed. On Windows the plugin does not run yet. With an older Anki, the user updates Anki (https://apps.ankiweb.net) or installs uv: brew install uv on macOS, otherwise as the uv installation guide describes (https://docs.astral.sh/uv/getting-started/installation/). Then restart the Claude app.
    • Update the plugin to the newest version.
  2. Anki and AnkiConnect. Call overview.
    • It lists decks and note types: both work.
    • "does not answer" or "not running": Anki is closed or AnkiConnect is missing. The user opens Anki. If that is not enough, they install AnkiConnect in Anki under Tools > Add-ons > Get Add-ons... with the code 2055492159 and restart Anki.
    • "did not answer in time": a window is waiting in Anki, often the profile chooser or a sync question. The user closes it. If the profile chooser comes up every time, they can open their profile once and let Anki remember it.
  3. Image Occlusion (only for image occlusion cards). overview lists a note type marked [image occlusion]. If there is none: it needs Anki 23.10 or newer; then the user adds it in Anki under Tools > Manage Note Types > Add > "Add: Image Occlusion".
  4. Graphviz (only for drawn graphs). overview says so when Graphviz is missing. The user installs it with brew install graphviz on macOS, winget install graphviz on Windows, or the graphviz package on Linux.
  5. Phone (only if the user studies on a phone). Call sync. If it fails, the user logs in to AnkiWeb in Anki under Tools > Preferences > Syncing.

End with a short checklist: each item ok, or the fix the user still has to do. Do not change any cards during the check.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free