# Linkly Ai Skills > Agent Skills for Linkly AI — search, browse, and read your local documents from any AI coding agent. - **Type:** MCP server - **Install:** `agentstack add mcp-linklyai-linkly-ai-skills` - **Verified:** Pending review - **Seller:** [LinklyAI](https://agentstack.voostack.com/s/linklyai) - **Installs:** 0 - **Category:** [Search](https://agentstack.voostack.com/c/search) - **Latest version:** 0.1.0 - **License:** Apache-2.0 - **Upstream author:** [LinklyAI](https://github.com/LinklyAI) - **Source:** https://github.com/LinklyAI/linkly-ai-skills - **Website:** https://linkly.ai ## Install ```sh agentstack add mcp-linklyai-linkly-ai-skills ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # Linkly AI Skills [Agent Skills](https://agentskills.io) for [Linkly AI](https://linkly.ai) — search, browse, and read your local documents (and linked cloud libraries) from any AI coding agent. This skill teaches AI agents how to use Linkly AI's document search capabilities, enabling them to find and read your locally indexed documents (PDF, Markdown, DOCX, PPTX, EPUB, TXT, HTML, and more) as well as cloud libraries you've linked via Linkly Web. ## What is Linkly AI? [Linkly AI](https://linkly.ai) is a desktop application that indexes documents on your computer and provides full-text search, structural outlines, and content reading through a local MCP server. Through the `mcp.linkly.ai` cloud gateway it can also reach cloud libraries you've linked via Linkly Web. Think of it as a knowledge base — local and cloud — that AI agents can query. ## What Does This Skill Do? When installed, this skill enables AI agents to: - **Search** your local documents (and linked cloud libraries) by keywords with relevance ranking, time windows, and path filters - **Find paths** for fuzzy or cross-language container names ("in my WeChat", "在 Notion 笔记里") by matching against the indexed file paths - **Explore** the knowledge base for an overview of themes, document types, and recent activity - **List libraries** to discover and search within specific knowledge bases - **Browse** document outlines to understand structure before diving in - **Grep** for specific text patterns with regex matching - **Read** document content with line-based pagination - **Diagnose issues** with `linkly doctor` when things aren't working - **Auto-detect** whether to use CLI commands or MCP tools based on the environment - **Guide setup** if Linkly AI is not yet installed The skill supports two access modes: | Mode | When Used | How It Works | | ---- | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | CLI | Agent has Bash/terminal access | Runs `linkly` CLI commands (preferred when both are available) | | MCP | Agent has MCP tool access | Calls `search` / `find_paths` / `outline` / `grep` / `read` / `list_libraries` / `explore` MCP tools — via the local server or the `mcp.linkly.ai` cloud gateway (which also serves linked cloud libraries) | ## Prerequisites 1. **Linkly AI desktop app** — [download from linkly.ai](https://linkly.ai) 2. **Linkly AI CLI** (for CLI mode) — see [installation](#cli-installation) ### CLI Installation macOS / Linux: ```bash curl -sSL https://updater.linkly.ai/cli/install.sh | sh ``` Or via Homebrew: ```bash brew tap LinklyAI/tap brew install linkly ``` Windows (PowerShell): ```powershell irm https://updater.linkly.ai/cli/install.ps1 | iex ``` Cross-platform (requires Rust): ```bash cargo install linkly-ai-cli ``` ## Installing This Skill ### skills.sh (Recommended) Install to all supported agents with a single command: ```bash npx skills add LinklyAI/linkly-ai-skills ``` Or install to a specific agent: ```bash # Claude Code only npx skills add LinklyAI/linkly-ai-skills -a claude-code # Codex CLI only npx skills add LinklyAI/linkly-ai-skills -a codex # Global install (available across all projects) npx skills add LinklyAI/linkly-ai-skills -g ``` ### Claude Code (manual) Copy the skill to your personal skills directory: ```bash git clone https://github.com/LinklyAI/linkly-ai-skills.git ~/.claude/skills/linkly-ai ``` Or for a specific project: ```bash git clone https://github.com/LinklyAI/linkly-ai-skills.git .claude/skills/linkly-ai ``` ### Codex CLI (OpenAI) ```bash git clone https://github.com/LinklyAI/linkly-ai-skills.git ~/.agents/skills/linkly-ai ``` ### Claude.ai (web) Download the latest release's `.zip` asset from the [Releases](https://github.com/LinklyAI/linkly-ai-skills/releases) page, then upload it in Claude.ai → Settings → Capabilities → Skills. ### ClawHub (OpenClaw) ```bash clawhub install linkly-ai ``` ### Other AI Agents Any AI agent that supports the [Agent Skills](https://agentskills.io) open standard can use this skill. Copy the `SKILL.md` file and the `references/` directory to the appropriate skills location for your agent. ## Skill Contents ``` ├── SKILL.md # Core skill instructions ├── references/ │ ├── cli-reference.md # CLI commands and options │ ├── mcp-tools-reference.md # MCP tool schemas and responses │ ├── search-strategies.md # Advanced query crafting patterns │ └── troubleshooting.md # Diagnosing and resolving issues └── scripts/ └── package.sh # Build the release .zip for upload ``` | File | Purpose | | ----------------------------------- | ------------------------------------------------------------------ | | `SKILL.md` | Main instructions: environment detection, workflow, best practices | | `references/cli-reference.md` | CLI commands, options, JSON output format | | `references/mcp-tools-reference.md` | MCP tool parameters, response schemas, supported document types | | `references/search-strategies.md` | Advanced query crafting, multi-round search, library scoping | | `references/troubleshooting.md` | Connection issues, version mismatches, and diagnostic steps | ## Compatibility This skill follows the [Agent Skills](https://agentskills.io) open standard and works with: - [Claude Code](https://claude.ai/code) (Anthropic) - [OpenClaw](https://openclaw.ai) - [Codex CLI](https://github.com/openai/codex) (OpenAI) - Any agent supporting the Agent Skills specification ## Contributing Contributions are welcome! Please open an issue or submit a pull request on [GitHub](https://github.com/LinklyAI/linkly-ai-skills). ## License [Apache-2.0](LICENSE) ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [LinklyAI](https://github.com/LinklyAI) - **Source:** [LinklyAI/linkly-ai-skills](https://github.com/LinklyAI/linkly-ai-skills) - **License:** Apache-2.0 - **Homepage:** https://linkly.ai Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** yes - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: flagged — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-linklyai-linkly-ai-skills - Seller: https://agentstack.voostack.com/s/linklyai - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.