Agent skill

Ima Skills

by Pinvou in Pinvou/pinvou-agent

Tencent IMA OpenAPI skill for notes and knowledge-base operations.

MITAuto-check passedBackend & APIs

Install Ima Skills

skills CLI
$ npx skills add Pinvou/pinvou-agent --skill ima-skills -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Pinvou/pinvou-agent ima-skills --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Pinvou/pinvou-agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/pinvou3-app/src-tauri/resources/common/skill-marketplace/ima-skills .claude/skills/ima-skills && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ima-skills
GitHub stars
2.4k
Token cost
~718 tokens
SKILL.md length
380 words
Files
2
Skills in repo
30
Repo updated
First seen
Licence
MIT

At a glance

Tencent IMA OpenAPI skill for notes and knowledge-base operations.

  • Tasks that involve OpenAPI specifications
  • SKILL.md covers Credential Rules, Module Routing, Native Tool and Safety
  • Reaches ima.qq.com
  • Tasks that involve Knowledge bases

What it does

Ima Skills is an agent skill from Pinvou/pinvou-agent. Tencent IMA OpenAPI skill for notes and knowledge-base operations. Use after the user connects IMA in Pinvou Plugin Center.

Its SKILL.md is about 720 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `meta.json`).

It sits in Backend & APIs, covering OpenAPI specifications and Knowledge bases. It works with OpenAPI. The repository describes itself as: Open-source desktop AI agent for tools, files, knowledge, workflows, and real deliverables. The licence is MIT.

When your agent uses it

  • Tasks that involve OpenAPI specifications
  • Tasks that involve Knowledge bases

Example prompts

  • “/ima-skills”

What it can do on your machine

Read from SKILL.md and the folder at commit b93341c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • ima.qq.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ima Skills loads about 718 tokens when it runs. Until then it costs about 34 tokens; SKILL.md has 380 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~34
When it runs · the whole SKILL.md, loaded when a task matches
~718

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Pinvou/pinvou-agent at commit b93341c, republished under its MIT licence (© Pinvou). 380 words, ~718 tokens.

Download SKILL.mdSave it as .claude/skills/ima-skills/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
ima-skills
description
Tencent IMA OpenAPI skill for notes and knowledge-base operations. Use after the user connects IMA in Pinvou Plugin Center.
version
1.1.8-pinvou2
display_name
腾讯 ima

腾讯 ima OpenAPI

Use this skill when the user asks to search, read, create, append, import (web page import), or organize content in Tencent IMA notes or IMA knowledge bases.

Credential Rules

Pinvou stores IMA credentials in the local system credential store. The native ima_openapi tool reads them only when it sends a request to the fixed official endpoint.

Do not ask the user to paste credentials into the chat. Do not write credentials to ~/.config/ima, repository files, logs, notes, or artifacts.

Do not probe credentials with shell commands, environment inspection, local files, or ad-hoc network requests. Never pass a host, URL, Client ID, API Key, or HTTP header as tool input.

To verify access or perform any IMA operation, call ima_openapi. The tool is deferred by default: if ima_openapi is not in your tool list, activate it with tool_search first; if tool_search cannot surface it, the ima backend is unavailable this round — say so instead of improvising. If the call reports missing credentials, tell the user to connect "腾讯 ima" from the Pinvou Plugin Center.

Module Routing

Read the relevant child instruction before operating:

  • Notes: read notes/SKILL.md for note search, list, read, create, or append.
  • Knowledge base: read knowledge-base/SKILL.md for knowledge-base search, browsing, URL import, add note to knowledge base, or get media info.
  • Cross-module tasks: read both child instructions before acting.
Show full SKILL.md (157 more words)Show less

Native Tool

All calls go through Pinvou's native ima_openapi tool. Pass only an allowlisted api_path and a JSON object in body:

json
{
  "api_path": "openapi/wiki/v1/search_knowledge_base",
  "body": {"query": "", "cursor": "", "limit": 20}
}

The tool sends POST JSON requests only to https://ima.qq.com, applies a response-size limit, and does not expose credentials to the model or subprocesses.

Always parse the response JSON. IMA business success uses code: 0; for any non-zero business code, show the returned msg to the user without exposing credentials or internal headers.

Safety

  • Never expose knowledge_base_id, media_id, folder_id, note_id, Client ID, API Key, or HTTP headers unless the user explicitly needs a technical debug artifact and credentials are redacted.
  • Ask before irreversible writes when the target note or knowledge base is ambiguous.
  • For note writes, validate UTF-8 text and filter local image references.
  • Local file upload is not an ima_openapi capability: only web page import via import_urls and collecting existing notes via add_knowledge are supported. Do not promise the user that local files can be uploaded.

© Pinvou, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in pinvou3-app/src-tauri/resources/common/skill-marketplace/ima-skills of Pinvou/pinvou-agent.

  • SKILL.md
  • meta.json

Open the folder on GitHubat commit b93341c

Compare with similar skills

Ima Skills next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ima Skills compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ima Skills this skillPinvou/pinvou-agent2.4k—~718Automated safety check: PassMIT
Ima Knowledge Basecountbot-ai/CountBot784—~506Automated safety check: PassMIT
Migrateguhcostan/claude-mega-brain126—~975Automated safety check: PassMIT
ToolJet Marketplace Plugin BuilderToolJet/ToolJet41k—~2.1kAutomated safety check: PassAGPL-3.0
Step Partsearthtojake/text-to-cad19k1 repos~1.5kAutomated safety check: PassMIT
OpenAPI to MCP Servermcp-use/mcp-use11k—~5.2kAutomated safety check: PassApache-2.0

Similar skills

  • Ima Knowledge Base

    countbot-ai/CountBot

    通过 IMA OpenAPI 处理知识库任务。支持知识库内容搜索、命中详情查看、条目浏览、列出知识库、上传文件、导入网页。用户提到知识库、资料库、上传到知识库、导入网页、搜知识库时使用。

    784 GitHub stars~506 tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Migrate

    guhcostan/claude-mega-brain

    Scan the project and migrate existing documentation into OKF format.

    126 GitHub stars~975 tokensUpdated 2 mo ago
    Knowledge ManagementAuto-check passed
  • Turns an API description, such as an OpenAPI file or a Postman collection, into a connector plugin for ToolJet's marketplace and checks it with the repo's validator.

    41k GitHub stars~2.1k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Step Parts

    earthtojake/text-to-cad

    Find, evaluate, and download common purchasable CAD parts from step.parts, including named off-the-shelf actuators, servos, motors, electronics boards, connectors, screws, bolts, nuts, washers…

    19k GitHub starsUsed in 1 repo~1.5k tokens
    Backend & APIsAuto-check passed
  • OpenAPI to MCP Server

    mcp-use/mcp-use

    Turns an OpenAPI or Swagger spec into an MCP server with the mcp-use TypeScript SDK, mapping each operation to a tool, wiring auth, testing and deploying.

    11k GitHub stars~5.2k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Use Yaak

    mountain-loop/yaak

    A skill your agent uses when the user mentions Yaak, a Yaak workspace, or the yaak command, or asks to call, hit, or smoke test HTTP/REST endpoints, save or organize API requests for reuse or manual…

    19k GitHub stars~1.9k tokensUpdated today
    Backend & APIsAuto-check passed

More from Pinvou/pinvou-agent

All 30 skills in this repo
  • Tmeet Skill

    Pinvou/pinvou-agent

    何时用:用户明确要通过命令行操作腾讯会议(tmeet),或 Agent 遇到工具缺失/调用失败/能力不足想反馈平台时。OAuth 登录/登出/状态、会议管理(创建/更新/取消/查询/搜索/受邀者)、录制管理(列表/播放地址/智能纪要/转写/权限申请)、元宝纪要(按关键词/时间搜索、稳态/瞬态详情)、会议报告(参会人/等候室/导出明细/异步任务)、通讯录(仅限会议邀请/呼叫入会前置解析,严禁单独查…

    2.4k GitHub stars~4.8k tokensUpdated yesterday
    Auto-check passed
  • Wecomcli Doc

    Pinvou/pinvou-agent

    何时用:仅当用户明确指定 doc/docx/word/在线文档/office文档或提供 doc.weixin.qq.com/doc/ 链接时使用;泛指「做个文档/写文档/整理成文档」默认走 wecomcli-smartpage 或本地工具,本技能不得抢占。doc 内容操作:新建、导入(.doc/.docx/.txt)、读取、追加、覆盖写入;结构化数据需求改用智能文档/智能表格;公共管理走…

    2.4k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Dws

    Pinvou/pinvou-agent

    【何时用:仅当用户明确指向钉钉/DingTalk(钉钉文档、钉钉日程等)时使用;泛指做文档/表格/待办/审批默认走本地工具,不要误用钉钉】用 dws CLI 管理钉钉:AI表格/AI搜问(找人首选)/目标管理(Agoal)/组织大脑/日历/通讯录/群聊与机器人消息/待办/审批/考勤/日志(日报周报)/DING消息/钉钉文档/云盘/Markdown文件/AI听记/邮箱/在线电子表格(axls)/知…

    2.4k GitHub stars~5.3k tokensUpdated yesterday
    Auto-check passed
  • Lark Im

    Pinvou/pinvou-agent

    【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书即时通讯:收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片(Interactive…

    2.4k GitHub stars~5.9k tokensUpdated yesterday
    Auto-check passed
  • Lark Sheets

    Pinvou/pinvou-agent

    【何时用:仅当用户明确指向飞书/Lark 电子表格;泛指做表格默认走本地工具】创建/操作飞书电子表格:工作表与行列结构、读写单元格(值/公式/样式/批注/图片)、查找替换、批量更新、图表/透视表/条件格式/筛选/迷你图/浮动图片。按名称搜索云空间表格文件改用 lark-drive 的 drive +search。doubao.com 的 /sheets/ URL 也走本 skill。不适用本地…

    2.4k GitHub stars~6.5k tokensUpdated yesterday
    Auto-check passed
  • Lark Base

    Pinvou/pinvou-agent

    【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书多维表格(Base)操作:建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、BaseApp 应用模式(页面与组件)、Workspace 目录、workflow、角色权限、模板中心(模板分类/列表/搜索);遇到…

    2.4k GitHub stars~4k tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Ima Skills

What does Ima Skills do?

Tencent IMA OpenAPI skill for notes and knowledge-base operations. Ima Skills is an agent skill from Pinvou/pinvou-agent. Tencent IMA OpenAPI skill for notes and knowledge-base operations.

When should I use Ima Skills?

Ima Skills fits situations like: tasks that involve OpenAPI specifications; tasks that involve Knowledge bases.

How do I install Ima Skills in Claude Code?

Run `npx skills add Pinvou/pinvou-agent --skill ima-skills -a claude-code`. Or copy the skill folder (pinvou3-app/src-tauri/resources/common/skill-marketplace/ima-skills in Pinvou/pinvou-agent) into .claude/skills/ima-skills in your project. Claude Code loads it when a task matches its description.

How do I install Ima Skills in Codex?

Run `npx skills add Pinvou/pinvou-agent --skill ima-skills -a codex`. Or copy the skill folder (pinvou3-app/src-tauri/resources/common/skill-marketplace/ima-skills in Pinvou/pinvou-agent) into .agents/skills/ima-skills in your project. Codex loads it when a task matches its description.

Can I use Ima Skills in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Pinvou/pinvou-agent --skill ima-skills -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ima-skills, .gemini/skills/ima-skills, .github/skills/ima-skills and .opencode/skills/ima-skills in your project.

What does Ima Skills need to run?

SKILL.md names no scripts, command-line tools or credentials: Ima Skills is instructions for the agent only.

Does Ima Skills access the network?

SKILL.md names 1 domain. In commands or code: ima.qq.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Ima Skills safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Ima Skills use?

Ima Skills is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ima Skills use?

About 718 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Ima Skills?

Skills that share tags, products or a category with Ima Skills: Ima Knowledge Base (countbot-ai/CountBot, 784 stars), Migrate (guhcostan/claude-mega-brain, 126 stars), ToolJet Marketplace Plugin Builder (ToolJet/ToolJet, 41k stars) and Step Parts (earthtojake/text-to-cad, 19k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ima Skills?

Pinvou (a GitHub organization) maintains it in Pinvou/pinvou-agent, which has 2,416 GitHub stars. The repository holds 30 skills in this directory. The repository was last updated on October 10, 2026.

Source: Pinvou/pinvou-agent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.