Refine MCP skills: align search-assets/sdk-reference with assets.list overload; drop webhooks#3
Refine MCP skills: align search-assets/sdk-reference with assets.list overload; drop webhooks#3imagekitio wants to merge 11 commits into
Conversation
… and imagekit-plugin chore(mcp): fix API URL in mcp configuration docs(README): add imagekit-sdk-reference skill to documentation chore(skills): include imagekit-sdk-reference in skills list
…e type gotchas - Add search-assets skill: searchQuery filter syntax, operators, and field reference for client.assets.list() - Add imagekit-integrations skill: index of ImageKit SDKs, plugins, and integrations - Register both new skills under the General grouping in skills.sh.json - imagekit-sdk-reference: add TypeScript Gotchas section explaining why .filter() with `item is File` fails in MCP/Deno (global File shadows SDK File); recommend for...of + if narrowing; document nullable props, .find() undefined, and webhook discrimination - mcp-preflight: clarify execute tool description and upload routing wording
…ebhooks from MCP skill
…atch only to branch + re-throw)
…archQuery), not 'always searchQuery'
|
One issue that i running with custom metadata is agent tries to use custom metadata tag as per user request. And because users dont exactly use custom meta data tag name correctly this usually search files to get the name. Correct path is to first get list of custom metadata tag and then proceed. Below image shows using some cheaper model agent confuses metadata name. Also sometimes it uses list assets instead of first listing custom metadata. I am adding a section to guide llm to list metadata first 
|
|
Task: in my imagekit DAM, use AI task to add tag in these images
Rest of things are working fine! One issue that I faced in terms of UX, is that when working with long running tasks, code written is sequential sometimes. 
I had to prompt to write code in parallel. 
We should tell agent to write code to use APIs in batches like we do for IK Agent now |
…and disambiguation" This reverts commit 1ffc9ce.
3 participants
Summary
Builds on #2 and refines the two skills that interact most with TypeScript typing, so the agent gets correct results even when a skill isn't loaded. Pairs with companion SDK changes in
imagekit-nodejs(an honestassets.listoverload + an expandedexecutetool prompt).search-assetsassets.listoverload behavior:searchQuery→ pass{ type: 'file' }/{ type: 'folder' }for a typedFile[]/Folder[](no narrowing).searchQuery→ the API ignores thetype/tags/nameparams, so the result stays(File | Folder)[]; puttype = "file"inside the query and narrow withfor...of+if.client.customMetadataFields.list()to get valid field names/types before building"customMetadata.<field>"queries (operators depend on the field type).searchQueryoverrides the top-leveltype/tags/nameparams.imagekit-sdk-referenceassets.listnarrowing guidance to reflect the overload (narrowing only required for the union /searchQuerycases).executecode; when branching on failure, duck-type the error instead ofinstanceof ImageKit.APIError(a value import of the SDK crashes at runtime in the Deno sandbox).executesandbox.Companion SDK changes (separate
imagekit-nodejsPR)Companion PR - imagekit-developer/imagekit-nodejs#163
assets.listoverloads gated onsearchQuery?: undefinedso the typedFile[]/Folder[]return is only produced when there's nosearchQuery(no more type lie).executetool prompt expanded with list/search + pagination + nullable-field + custom-metadata-discovery guidance.