你用 Claude Code 写代码，用 Cursor 做开发，用 Codex CLI 调试问题。它们都很强大——但它们不知道你电脑上有哪些文档。
Linkly AI Skills 解决这个问题。它是一个技能包，安装后你的 AI 助理就学会了搜索和阅读你本地文档的能力。
什么是 Agent Skills
Agent Skills 是一种开放标准，用于为 AI Agent 扩展新能力。最初由 Anthropic 开发并开源。
核心概念很简单：一个 Skill 就是一个文件夹，里面有一个 SKILL.md 文件，用自然语言告诉 AI “你能做什么、怎么做”。
AI 启动时只加载 Skill 的名称和描述（约 100 tokens），判断任务相关时才加载完整指令。这种渐进式披露机制让 Agent 可以装载几十个 Skill 而不会撑爆上下文窗口。
目前已有 30+ AI 平台支持此标准，包括 Claude Code、Codex CLI、Gemini CLI、Cursor、GitHub Copilot 等。
Linkly AI Skills 做了什么
安装后，你的 AI 助理获得三个能力：
- search — 搜索本地已索引的文档
- outline — 查看文档的结构大纲
- read — 阅读文档的指定部分
这就是 Outlines Index 的三步渐进式工作流。
比如你在 Claude Code 里说：“帮我找下之前写的技术方案里关于数据库选型的部分。”
Claude Code 会：
- 调用
linkly search "数据库选型 技术方案"找到相关文档 - 用
linkly outline看文档结构，定位到”数据库选型”章节 - 用
linkly read精准读取那个章节的内容 - 基于读到的内容回答你的问题
整个过程你只需要用自然语言提问，不需要记任何命令。
安装
最简单的方式，一行命令：
npx skills add LinklyAI/linkly-ai-skills这会自动检测你安装了哪些 AI 工具，把 Skill 安装到对应的位置。
也可以指定安装到某个平台：
# Claude Code
npx skills add LinklyAI/linkly-ai-skills -a claude-code
# Codex CLI
npx skills add LinklyAI/linkly-ai-skills -a codex
# 全局安装（所有支持的 AI 工具）
npx skills add LinklyAI/linkly-ai-skills -g它怎么工作的
Skills 内部会自动检测环境，选择最佳的通信方式：
- 优先 CLI：检查
linkly命令是否可用，如果在就用 CLI 执行搜索 - 备选 MCP：如果 MCP 工具（search/outline/read）已配置，直接调用
- 自动安装：都没有？引导你安装 CLI
两种方式对用户完全透明——你只管用自然语言提问。
安全设计
- 只读操作：Skills 只提供搜索和阅读能力，不会修改你的文件
- 数据不离开本地：所有搜索和阅读操作在你的电脑上完成
- 内容隔离：文档内容作为数据读取，不作为指令执行，防止 prompt injection
前置条件
- 安装并运行 Linkly AI Desktop
- 在桌面应用中选择你的文档目录，等待索引完成
索引完成后，你的 AI 助理就能”看到”你的文档了。