mindos-zh

mindos-zh is a skill for Claude Code from GeminiLight/MindOS. It costs 490 tokens per session (4,571 once invoked), scanned A, original, MIT.

A local knowledge-base assistant for storing and finding decisions, meeting notes, procedures, troubleshooting lessons, and preferences across conversations and coding agents. It works only with the MindOS knowledge base.

In plain words
What is it for?
Use it to list, read, create, edit, append, move, delete, search, and review the history or backlinks of knowledge-base files.
Why use it?
It removes the need to remember where shared project knowledge was stored or repeat the same context to different agents.

Skill for Claude Code

Written for Claude Code: disable-model-invocation in frontmatter.

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/geminilight/mindos/mindos-zh
Any agent
npx skills add GeminiLight/MindOS --skill mindos-zh
Clone the repo
git clone --depth 1 https://github.com/GeminiLight/MindOS

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for mindos-zh

README.md
[![agentmods](https://agentmods.dev/badge/skills/geminilight/mindos/mindos-zh.svg)](https://agentmods.dev/skills/geminilight/mindos/mindos-zh)
Your own site
<a href="https://agentmods.dev/skills/geminilight/mindos/mindos-zh"><img src="https://agentmods.dev/badge/skills/geminilight/mindos/mindos-zh.svg" alt="Measured on agentmods" height="20"></a>
Per session 490 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 4,571 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00490 $0.04571
Opus 5 $0.00245 $0.02286
Sonnet 5 $0.00098 $0.00914
Haiku 4.5 $0.00049 $0.00457

Measured 6d ago against content hash c8da4fcccf3d, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

mindos-zh scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

Copies of this mod

1 near-identical copy found in the catalogue:

packages/web/data/skills/mindos-zh/SKILL.md · 294 lines

How it starts

The opening of the file, as written. The whole thing — 294 lines — stays where its author put it; the contents beside it link to each section on GitHub.

MindOS 技能

CLI 命令

使用 mindos file <子命令> 完成所有知识库操作。加 --json 获取结构化输出。

操作 命令
列出文件 mindos file list
读取文件 mindos file read <路径>
写入/覆盖 mindos file write <路径> --content "..."
创建新文件 mindos file create <路径> --content "..."
追加内容 mindos file append <路径> --content "..."
编辑段落 mindos file edit-section <路径> -H "## 标题" --content "..."
标题后插入 mindos file insert-heading <路径> -H "## 标题" --content "..."
追加 CSV 行 mindos file append-csv <路径> --row "列1,列2,列3"
删除文件 mindos file delete <路径>
重命名/移动 mindos file rename <旧> <新>
搜索 mindos search "关键词"
反向链接 mindos file backlinks <路径>
最近文件 mindos file recent --limit 10
Git 历史 mindos file history <路径>
列出空间 mindos space list
创建空间 mindos space create "名称"

MCP 用户: 如果只有 MCP 工具(mindos_*),直接使用——工具的 schema 已自带说明。有 CLI 时优先用 CLI(更省 token)。

CLI 安装

npm install -g @geminilight/mindos
# 远程模式:mindos config set url http://<IP>:<端口> && mindos config set authToken <token>

规则

  1. 先了解结构 — 列出知识库目录树,再搜索或写入。
  2. 默认只读。 只有用户明确要求保存、记录、整理、编辑时才写入。
  3. 规则优先级(从高到低):用户当前指令 → .mindos/user-preferences.md → 最近目录 INSTRUCTION.md → 根 INSTRUCTION.md → 本技能默认。
  4. 多文件编辑先出方案。 展示完整变更列表,获批后再执行。
  5. 创建/删除/移动/重命名后 → 自动同步相关 README
  6. 写入前先读取。 不基于假设写入。
  7. 自然收口。 回复只完成用户这一轮要求;完整查阅或写入后,不追加无必要的追问。
  8. 尊重源码边界。 本技能只处理 MindOS 知识库。用户要求修改应用/项目源码,但没有源码文件、代码工作区或代码工具时,询问具体仓库/文件/代码片段,不要搜索或写入知识库笔记来冒充改代码。对于裸代码请求,不要用 KB 的 list/search/read 工具去找源码文件。

回答收口

任务结束前按这个契约输出:

  • 查找 / 总结 / 引用: 先给结论,附稳定文件路径,并保持只读。用户点名具体本地文件路径时,最终回答必须包含这个原始路径。用户明确说不要修改或要求只读处理时,最后用用户语言短句说明没有修改(中文用「未做任何修改。」;英文用 "No changes were made.")。除非用户要求下一步或证据不足,不要用“要不要我保存/记录/更新?”结尾。
  • 保存 / 更新 / 追加: 只有写入工具成功后,才报告真实路径和操作。用稳定措辞:已保存到 <路径>已更新 <路径>已追加到 <路径>。再补一句极短摘要即可。
  • 上传内容写入: 用户要求把上传内容整理成笔记,且目标类型明确时,直接使用上传内容;最多做一次轻量结构/README 检查,然后写入笔记。不要停在目录列表。
  • 需要澄清: 只有当缺失信息会改变目标位置、范围、成本、安全或可逆性时才问。一次只问一个具体问题;必要时给 2-3 个可选方向。
  • 没有证据或工具失败: 明确说明没找到什么、哪个动作失败,以及下一步怎么恢复。缺少证据的查找任务不要主动提出保存、记录、创建或补充该想法,除非用户要求沉淀。不要空回复。
  • 语言保真: 保留用户语言和原笔记中的关键术语。中文笔记里的术语优先照原文说,不要随手翻译成英文;英文解释只在有帮助时放括号里。
  • 只读收口: 用户只要总结、会议上下文或下一步时,答完即止。不要额外追问"要不要我保存/记录/起草/写入/补充/调整/导出/继续执行?"。最后一句应是陈述句,不要用问题结尾。按 SOP 或 workflow 回答时,必须引用所依据的 SOP/workflow 路径。用户只问下一步时,不要反问是否执行。

Read the full file on GitHub · 294 lines

Files

What ships with it

5 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago First seen · 294 lines · 490 tokens per session scan A c8da4fcccf3d

Subscribe to this mod's changes

mindos-zh is a skill published in the GitHub repository GeminiLight/MindOS (666 stars, last pushed 2d ago), licensed MIT. It adds 490 tokens to every session and 4,571 once invoked, about $0.0024 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.