tessl install github:intellectronica/agent-skills --skill anki-connectgithub.com/intellectronica/agent-skills
This skill is for interacting with Anki through AnkiConnect, and should be used whenever a user asks to interact with Anki, including to read or modify decks, notes, cards, models, media, or sync operations.
Review Score
79%
Validation Score
12/16
Implementation Score
77%
Activation Score
75%
Enable reliable interaction with Anki through the AnkiConnect local HTTP API. Use this skill to translate user requests into AnkiConnect actions, craft JSON requests, run them via curl/jq (or equivalent tools), and interpret results safely.
http://127.0.0.1:8765 (default). Verify readiness using curl, e.g. curl -sS http://127.0.0.1:8765 should return Anki-Connect.CRITICAL — NO EXCEPTIONS
Before any destructive or modifying operation on notes or cards (adding, updating, deleting, rescheduling, suspending, unsuspending, changing deck, or changing fields/tags), request confirmation from the user. Use the AskUserQuestion tool if available; otherwise ask via chat. Only request confirmation once per logical operation, even if it requires multiple API calls (e.g., search + update + verify). Group confirmation by intent and scope (e.g., “Update 125 notes matching query X”).
Treat the following as confirmation-required by default:
addNote, addNotes, updateNoteFields, updateNoteTags, updateNote, updateNoteModel, deleteNotes, removeEmptyNotes, replaceTags, replaceTagsInAllNotes, clearUnusedTags.setEaseFactors, setSpecificValueOfCard, suspend, unsuspend, forgetCards, relearnCards, answerCards, setDueDate, changeDeck.Every request is JSON with:
action: string action nameversion: API version (use 6 unless user specifies otherwise)params: object of parameters (optional)Every response is JSON with:
result: return valueerror: null on success or a string describing the errorAlways check error before using result.
requestPermission first when interacting from a non-trusted origin; it is the only action that accepts any origin.version to ensure compatibility; older versions may omit the error field in responses when version ≤ 4.Prefer jq to build JSON and parse responses. Keep requests explicit and structured.
jq -n --arg action "deckNames" --argjson version 6 '{action:$action, version:$version}' \
| curl -sS http://127.0.0.1:8765 -X POST -H 'Content-Type: application/json' -d @-jq -n \
--arg action "findNotes" \
--argjson version 6 \
--arg query "deck:French tag:verbs" \
'{action:$action, version:$version, params:{query:$query}}' \
| curl -sS http://127.0.0.1:8765 -X POST -H 'Content-Type: application/json' -d @-curl -sS http://127.0.0.1:8765 -X POST -H 'Content-Type: application/json' -d @- \
| jq -e 'if .error then halt_error(1) else .result end'Use multi to reduce round-trips and to group actions under a single confirmation when modifying data.
jq -n --argjson version 6 --arg query "deck:French" \
'{action:"multi", version:$version, params:{actions:[
{action:"findNotes", params:{query:$query}},
{action:"notesInfo", params:{notes:[]}}
]}}' \
| curl -sS http://127.0.0.1:8765 -X POST -H 'Content-Type: application/json' -d @-Replace the empty array with the result of the previous action when chaining; in CLI usage, split into two calls unless using a scripting language.
requestPermission (safe).version to confirm the API level and use version: 6 in requests.apiReflect with scopes: ["actions"] to list supported actions.findNotes/findCards + notesInfo/cardsInfo for previews before modification.error for each response.deckNamescreateDeckfindNotes, findCardsnotesInfo (note IDs)addNote, addNotescanAddNotes or canAddNotesWithErrorDetail for preflight checks.updateNoteFields, updateNoteTags, or combined updateNotedeleteNotessuspend, unsuspendchangeDecksetDueDatestoreMediaFile, retrieveMediaFile, getMediaFilesNames, getMediaDirPath, deleteMediaFiledata), file path (path), or URL (url) for upload.syncfindNotes/findCards)or, parentheses, and - for NOT logic.deck:Name, tag:tagname, note:ModelName, card:CardName.front:... or other field names to limit by field.re: for regex, w: for word-boundary searches, nc: to ignore accents.is:due, is:new, is:learn, is:review, is:suspended, is:buried to filter card states.prop: searches for properties like interval or due date.getEaseFactorssetEaseFactorssetSpecificValueOfCardsuspendunsuspendsuspendedareSuspendedareDuegetIntervalsfindCardscardsToNotescardsModTimecardsInfoforgetCardsrelearnCardsanswerCardssetDueDatedeckNamesdeckNamesAndIdsgetDeckscreateDeckchangeDeckdeleteDecksgetDeckConfigsaveDeckConfigsetDeckConfigIdcloneDeckConfigIdremoveDeckConfigIdgetDeckStatsguiBrowseguiSelectCardguiSelectedNotesguiAddCardsguiEditNoteguiAddNoteSetDataguiCurrentCardguiStartCardTimerguiShowQuestionguiShowAnswerguiAnswerCardguiUndoguiDeckOverviewguiDeckBrowserguiDeckReviewguiImportFileguiExitAnkiguiCheckDatabaseguiPlayAudiostoreMediaFileretrieveMediaFilegetMediaFilesNamesgetMediaDirPathdeleteMediaFilerequestPermissionversionapiReflectsyncgetProfilesgetActiveProfileloadProfilemultiexportPackageimportPackagereloadCollectionmodelNamesmodelNamesAndIdsfindModelsByIdfindModelsByNamemodelFieldNamesmodelFieldDescriptionsmodelFieldFontsmodelFieldsOnTemplatescreateModelmodelTemplatesmodelStylingupdateModelTemplatesupdateModelStylingfindAndReplaceInModelsmodelTemplateRenamemodelTemplateRepositionmodelTemplateAddmodelTemplateRemovemodelFieldRenamemodelFieldRepositionmodelFieldAddmodelFieldRemovemodelFieldSetFontmodelFieldSetFontSizemodelFieldSetDescriptionaddNoteaddNotescanAddNotescanAddNotesWithErrorDetailupdateNoteFieldsupdateNoteupdateNoteModelupdateNoteTagsgetNoteTagsaddTagsremoveTagsgetTagsclearUnusedTagsreplaceTagsreplaceTagsInAllNotesfindNotesnotesInfonotesModTimedeleteNotesremoveEmptyNotesgetNumCardsReviewedTodaygetNumCardsReviewedByDaygetCollectionStatsHTMLcardReviewsgetReviewsOfCardsgetLatestReviewIDinsertReviewsimportPackage paths are relative to the Anki collection.media folder, not the client.deleteDecks requires cardsToo: true to delete cards along with decks.No bundled scripts or assets are required for this skill.