Agent Skill

One file that teaches any AI agent your entire platform.

Drop a SKILL.md into your project and your AI agent instantly knows how to create websites, manage clients, publish content, and run your agency on Lindo. Open standard. Works everywhere.

Claude Code
OpenAI Codex
Perplexity
Cursor
Windsurf
OpenClaw
OpenCode
Claude Code
Codex

The problem

AI agents have tools. They don't have context.

Give an AI agent 43 MCP tools and it can do anything. But it doesn't know how. Should it create the client before or after the website? What parameters does the page builder need? How do credits work?

The Agent Skill fills that gap. It's a structured document that teaches the agent your platform's mental model — the right tool for each job, the correct sequence for complex operations, and the gotchas to avoid. One file, loaded once, and the agent goes from “confused tool-caller” to “competent assistant.”

The difference

Without skill vs. with skill

Without skill

Agent tries random tools until something works

Creates website before creating client (wrong order)

Forgets to allocate credits, client can't use the site

Passes wrong parameters, gets errors, retries 3x

Takes 8 tool calls to do what should take 3

With skill

Agent picks the right tool on the first try

Follows correct sequence: client → website → credits

Knows to allocate credits and generate magic link

Passes correct parameters with proper formatting

Completes complex tasks in 3 clean tool calls

Install

One command. Any platform.

Install (all agents)

npx skills add lindoai/agent-skill

Manual (any platform)

mkdir -p .claude/skills/lindo-ai
curl -o .claude/skills/lindo-ai/SKILL.md \
  https://raw.githubusercontent.com/lindoai/agent-skill/main/SKILL.md

Works with Cursor (.cursor/skills/), Perplexity Spaces, Windsurf, and any tool that reads SKILL.md files.

Architecture

Skill + MCP = complete agent integration

MCP provides tools

43 functions the agent can call — create, read, update, delete across all resources.

Skill provides knowledge

Which tool to use, what parameters to pass, and how to chain operations together.

Agent provides intelligence

Reads context from the conversation, makes decisions, and executes the right sequence.

Example

What a skilled agent can do

“Onboard a new client: Sarah at sarah@brightsmile.com. Create a dental clinic website for her in Austin, give her 500 credits, and send me the magic link.”

→ create_client(email: "sarah@brightsmile.com", name: "Sarah")

→ create_website(name: "Bright Smile Dental", description: "Family dentistry in Austin, TX")

→ allocate_credits(client_id: "cli_...", amount: 500)

→ generate_magic_link(client_id: "cli_...")

✓ Done. Client created, website building (5 pages), 500 credits allocated. Magic link: https://app.lindo.ai/magic/...

Get started

Two steps to a smarter agent

Install the MCP server.

npx -y @lindoai/mcp-server — provides the 43 tools your agent can call.

Install the skill.

npx skills add lindoai/agent-skill — teaches the agent how to use those tools effectively.

Frequently Asked Questions

What's the difference between a skill and the MCP server?
The MCP server provides the tools (43 functions the AI can call). The skill teaches the AI how to use those tools effectively — which tool to pick for each task, what parameters to pass, and how to chain operations together. Think of MCP as the toolbox and the skill as the instruction manual.
Do I need both the skill and the MCP server?
The MCP server is required — it provides the actual capabilities. The skill is optional but highly recommended. Without the skill, the AI can still call tools, but it might not know the best approach for complex tasks like "onboard a new client with a starter website and 500 credits." The skill teaches it the optimal sequence.
What's the SKILL.md format?
It's an open standard created by Anthropic for teaching AI agents domain-specific knowledge. It's a markdown file that lives in your project and gets loaded into the agent's context. Any AI tool that supports the standard can read it — Claude Code, Codex, Perplexity, Cursor, Windsurf, and more.
Will the skill slow down my AI agent?
Minimally. The SKILL.md file is about 3KB — roughly 800 tokens. That's less than a single chat message. The context cost is negligible compared to the accuracy improvement. Agents with the skill make fewer errors and need fewer retries.
Can I customize the skill for my agency's workflow?
Absolutely. Fork the repo, edit the SKILL.md to include your specific conventions (naming patterns, default settings, preferred page structures), and point your agent at your custom version. The skill is just a markdown file — edit it like any other document.
Make your agent smarter

One file. 43 tools. Zero confusion.

Install the skill and watch your AI agent go from tool-caller to agency assistant.