Linkly AI Skills
A skill that teaches an agent to search, browse and read local documents through Linkly AI: PDF, Markdown, Word, Excel and more.
- 67 ★ on the repository
- Last commit
- Apache-2.0
Extended access
Why this level
- The agent gets read access to every document you indexed in Linkly AI and can write notes.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/linkly-ai-skillsDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The agent gets read access to every document you indexed in Linkly AI and can write notes.
This is third-party code. Review the repository files before installing.
What it does
The skill connects an agent to Linkly AI, a desktop app that indexes documents on your computer and offers full-text search, structural outlines, reading and notes through a local MCP server. The agent searches by keyword with ranking, time and path filters, lists a folder or library completely without inventing a query, browses document outlines and greps for patterns with regex. Reading is paged by line, including OCR text from images. The skill can list local Markdown notes by tag and save new ones, link cloud libraries through Linkly Web and diagnose problems with `linkly doctor`. It picks the mode itself: CLI when the agent has a terminal, MCP tools otherwise. Supported formats include PDF, Markdown, Excel, CSV, DOCX, TXT, PPTX, EPUB, HTML, images, audio and video.
Who it is for. Linkly AI users who want to search and read their local documents and notes from Claude Code, Codex and other agents.
Good fit when
- You need to find a file by topic in the local document base and read a specific section.
- An agent must list the full contents of a known folder or library.
- You need text with image references and OCR from indexed documents.
- Markdown notes need listing by tag and a new one saved.
Not a fit when
- Linkly AI is not installed; the skill describes how to use it and guides setup.
- You need web search over the internet.
- Documents cannot be handed to a local indexer.
Example request
Find last year's supply agreement in my documents and show the payment terms section.Limitations
The skill works only together with the Linkly AI app for macOS, Linux or Windows, where documents are indexed. Cloud libraries need the `mcp.linkly.ai` gateway and sources linked through Linkly Web. The agent can reach whatever you indexed: all indexed files, including personal ones, become readable to it. The skill version is pinned by the release tag and in three files at once. Search results depend on index completeness: fresh files show up after the app indexes them.
How to disable. Remove the skill folder, for example `~/.claude/skills/linkly-ai`, and disable indexing in the Linkly AI app if needed.
FAQ
How do I install the skill?
Run `npx skills add LinklyAI/linkly-ai-skills`, with `-a claude-code`, `-a codex` or `-g` for global. Manually, clone the repository into `~/.claude/skills/linkly-ai`.
CLI or MCP?
The skill chooses itself: CLI is preferred when the agent has a terminal, otherwise MCP tools are used.
How do I install the skill in Claude.ai?
Download the zip from the repository Releases and upload it in Settings, Capabilities, Skills.
What if something fails?
Run `linkly doctor` to diagnose the connection with the app. A troubleshooting guide is in `references/troubleshooting.md`.
Can the skill write data?
Yes, it saves Markdown notes to the local notes folder. Other operations read the index.
Discussion
No questions or reviews yet.
Related
SkillsThe Linkly AI client: an agent searches local documents, reads and saves notes, with an MCP bridge for Claude Desktop
Skill linking an agent to the 得到大脑 notes service: saves links and images, searches by meaning, files notes in knowledge bases.
A skill that lets an agent read the LLM Wiki desktop app's knowledge base over its local HTTP API: search, pages and graph
A skill that analyzes materials and subtitles, checks facts against sources and keeps a personal library in a local folder.
A skill that reads local Claude Code and Codex logs and writes an evidence-based report with an LV0-LV5 level and usage breakdown.
Twenty-two standalone skills: Notion, Todoist, Tavily, Context7, image generation, converting documents to Markdown
README in short
The skill replaces command guesswork with ready strategies: references for the CLI, MCP tools, search techniques and troubleshooting. Installation works for Claude Code, Codex, ClawHub and any agent supporting the Agent Skills standard.