OverviewHistoryStatsSecurity
npx skills add ...
Documentation
SKILL.md
npx skills add intellectronica/agent-skills --skill anki-connect
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.
npx skills add intellectronica/agent-skills --skill anki-connect
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.
Use multi to reduce round-trips and to group actions under a single confirmation when modifying data.
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.
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'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 @-