skills.rest
HalseyYang
HalseyYangCOMMUNITY
Explore all skills by this author →
GitHub

ima-skills

Manage Tencent IMA notes and knowledge bases via the IMA OpenAPI.

1|Updated Jul 13, 2026
Search Tags:#openapi#search#knowledge base#notes#upload#tencent#ima
One-click install
npx skills add https://github.com/HalseyYang/Skills-HY --skill ima-skills-halseyyang
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ima-skills
Source: https://github.com/HalseyYang/Skills-HY/tree/main/ima-skills
Command: npx skills add https://github.com/HalseyYang/Skills-HY --skill ima-skills-halseyyang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It lets you read, write, search, and organize Tencent IMA notes and knowledge bases directly from an AI agent, without manually switching to the IMA app for every operation. ## Core Features & Use Cases - Notes management: Search notebooks, create notes, append content, and retrieve note content through the IMA OpenAPI with mandatory UTF-8 validation to prevent garbled text. - Knowledge base management: Upload files, add web links, search knowledge base entries, and associate notes with knowledge bases. - Built-in safeguards: Credential checks, structured error codes, daily skill update checks, and PowerShell 5.1 encoding workarounds. - Use Case: Ask the agent to save a meeting summary as a new IMA note, or upload a PDF report into a specific IMA knowledge base and later search its contents. ## Quick Start Save this summary as a new note in my IMA notebook titled "Weekly Report".

Frequently Asked Questions about ima-skills

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create or append to an IMA note from an AI agent?▼

Use the notes module: search for the note to get its note_id, then call append_doc, or call import_doc to create a new note. All content and title strings must be validated as legal UTF-8 before writing to avoid irreversible garbled text.

How do I upload a file to an IMA knowledge base?▼

Use the knowledge-base module: create the media, upload the file to COS, then call add_knowledge. The title must exactly equal the original file name with extension, and binary files must be uploaded as-is without encoding conversion.

What credentials does the IMA OpenAPI skill need?▼

You need a Client ID and API Key from https://ima.qq.com/agent-interface. Store them in ~/.config/ima/client_id and ~/.config/ima/api_key, or set the IMA_OPENAPI_CLIENTID and IMA_OPENAPI_APIKEY environment variables.

Why does Chinese text become garbled when calling the IMA API from PowerShell?▼

PowerShell 5.1 silently converts the request body from UTF-8 to GBK even with charset=utf-8 set. Detect the version first and, on PS 5.1, convert the JSON body to a UTF-8 byte array before sending with Invoke-RestMethod.

What file types are not supported for IMA knowledge base upload?▼

Video files, Bilibili/YouTube URLs, and file:// URLs are not supported by the API. For those cases, users are directed to use the IMA desktop client instead.

Related Skills

Explore More Personal & Entrepreneur Skills→
liumeixinliumeixin
4

ima-skill

Manage notes and knowledge bases through the IMA OpenAPI.

Community
Advanced
MichaelYagiMichaelYagi

kb_search

Search knowledge entries by full-text content and tag filters.

Community
Basic
eninem123eninem123

ima-skill

Manage personal notes and knowledge-base content through IMA OpenAPI.

Community
Advanced
TugoukezhangTugoukezhang
8

ima-skills

Manage notes and knowledge bases via the IMA OpenAPI.

Community
Advanced