Skip to main content

​
Introduction to Skills

Agent Skills are skill packages that follow the agentskills.io open standard. Linkly AI Skills teach your AI assistant how to connect to and use Linkly AI’s tools, enabling AI to search, browse, and read your local documents. Why Do You Need Skills? After installing Linkly AI Desktop, you already have powerful document indexing and retrieval capabilities. However, AI assistants (such as Claude Code, Codex) don’t know how to use these tools. Skills act as an “instruction manual” that lets AI assistants automatically master the correct usage, including:
  • How to detect and connect to Linkly AI
  • When to search, when to browse outlines, and when to read full text
  • How to handle paginated reading of long documents
  • How to safely handle document content

​
Installing Skills

You can also install it to OpenLaw via ClawHub: 
clawhub install linkly-ai

​
Using Skills

After installing Skills, you don’t need to learn any special commands. Simply ask questions in natural language through your AI assistant, and Skills will automatically recognize your intent and trigger the appropriate actions.

​
Automatic Activation

The AI assistant will automatically determine whether to use Linkly AI’s tools based on keywords in your request. For example:

Search

“Search my documents for content about API design”

Browse

“Show me the chapter structure of this report”

Read

“Read my project requirements document”

Combined

“Find my machine learning notes and summarize the core concepts”

​
How It Works

When the AI assistant receives your request, Linkly AI Skills automatically completes the following steps:
1

Environment Detection

Automatically detects available access methods: prefers CLI (linkly command), falls back to MCP tools if CLI is unavailable.
2

Search Documents

Generates appropriate search keywords based on your description and calls the search tool to find relevant documents.
3

Browse Outline

For long documents, first views the structure via the outline tool to locate the sections that need to be read.
4

Read Content

Uses the read tool to retrieve the full content of the target sections, then summarizes, analyzes, or answers questions based on your needs.

​
Using Skills for Integration

You can even directly tell the AI assistant to complete the Linkly AI integration. Simply send a prompt like the following:

Please install the Agent Skill linkly-ai-skills and complete the LinklyAI tool integration...

The Skill will guide the AI assistant to automatically complete the following:
  1. Check if the CLI is installed; if not, install it automatically
  2. Run linkly status to verify the connection to the desktop application
  3. Once everything is ready, start serving you

​
Security Notes

Document content is treated as untrusted data. Skills have built-in security prompts — the AI assistant will not execute instructions or commands embedded in documents, preventing prompt injection attacks.
Some security scanners may flag this Skills as malicious due to the CLI download step. Rest assured, it is safe to use. We are working with major AI assistant platforms to optimize security detection rules and reduce false positives.
Linkly AI Skills security principles:
  • Data stays local — All search and read operations are performed on your computer
  • Content isolation — Document content is only read as data, never executed as instructions
  • Read-only operations — Skills only provide search, browse, and read capabilities, and will never modify your files