Guide · Agent skill
How to use the AI SEO agent skill (ai-seo)
Updated · written with AI from the project's own documentation and checked against our catalogue data
The ai-seo skill is a set of instructions and reference notes that helps an AI agent advise you on getting your content cited by AI assistants and AI search engines such as ChatGPT, Perplexity, Google AI Overviews, Claude and Gemini. It is written for marketing teams, content writers and site owners. After this guide you will know what the skill does, how to install it, how to ask for help in plain language, and what limits to keep in mind.
AI SEO Optimizationcoreyhaines31/marketingskills · MIT Download the skill Quick start
- 1Download the ZIP. Get the ai-seo skill ZIP from this page. It is MIT licensed.
- 2Unzip into a skills folder. Place the ai-seo folder in ~/.claude/skills/ for personal use or in .claude/skills/ inside a project.
- 3Or upload in the Claude apps. Open Settings, then Capabilities, then Skills, and upload the skill.
- 4Check the reference files. Confirm the references folder and SKILL.md are present, since some references may be missing from a copy.
- 5Ask a natural question. Describe your goal, such as getting a page cited in Perplexity or checking whether AI bots can read your site.
- 6Add your context. Answer the agent's questions about your content, goals and competitors, or point it to a product-marketing context file.
- 7Verify and test. Apply changes yourself, then check the same queries in the AI assistants over time.
What is the ai-seo skill and what does it make the agent do?
An agent skill is a folder of instructions and reference files that an AI agent loads when a task matches it. The ai-seo skill is focused on AI search optimization: making content discoverable, extractable and citable by AI systems.
Once installed, the agent approaches requests about AI citations with a structured playbook. It explains how each AI platform selects sources, then opens bundled reference guides on topics such as agent readiness, content structure, answer accuracy and tracking AI mentions to give tailored advice.
The skill does not change your website and does not check live AI results on its own. It is a set of instructions and reference notes.
Install the ai-seo skill from the ZIP download
Download the ZIP for the ai-seo skill from this page. The skill is licensed under MIT. Unzip it so that the skill folder, including its SKILL.md file and its references folder, ends up in one of these locations:
Choose the personal location if you want the skill available across your projects, or the project location if you want it only for one codebase or content repository. If you use the Claude apps instead, open Settings, then Capabilities, then Skills, and upload the skill there.
- Personal: ~/.claude/skills/ai-seo/
- Project: .claude/skills/ai-seo/ inside your project folder
- Claude apps: Settings → Capabilities → Skills, then upload
~/.claude/skills/ai-seo/SKILL.mdTrigger the skill with natural requests
You do not need a special command. Describe what you want in ordinary words. The skill is meant to load when you ask about getting content cited or surfaced by AI assistants and AI search engines. Its description includes many phrases people use, such as AI SEO, AEO, GEO, AI Overviews, optimize for Perplexity, llms.txt, and how do I show up in AI answers.
If the agent does not seem to use the skill, name it directly, for example by saying to use the ai-seo skill.
- How do I get my product pages cited by Perplexity?
- Is my site agent-ready? Can AI bots read our docs and llms.txt?
- Why is ChatGPT describing our pricing wrong, and how do we fix the source?
- Do listicles still work for AI answers, or should we change our comparison pages?
Give the agent context for better answers
The skill asks about your current AI visibility, content types, traditional SEO strength, existing structured data and competitors. You can answer these in the chat. If you have a product-marketing context file at .agents/product-marketing.md or .claude/product-marketing.md, the agent reads it first and asks only for what is missing.
Be specific about the queries that matter to your business and the pages you want cited. Advice on a product page differs from advice on a blog post or documentation.
Know what the skill needs and what it does not do
The skill needs its bundled reference files to be present in the installed folder. Some listed references may be missing in a given copy. If a file is missing, the agent should say which reference is unavailable and continue with the core workflow without claiming it read that file.
The skill runs no scripts and uses no network access, according to its listing. It is guidance, so you still make and check every change yourself. Traditional technical and on-page SEO audits belong to a separate seo-audit skill, and structured data implementation belongs to a separate schema skill.
No one can guarantee placement in AI answers. The guidance is probabilistic, platform behavior changes quickly, and some reference material is marked as volatile or observational.
- Runs scripts: no
- Uses network: no
- Read the skill's reference files before acting on platform-specific claims
- Check dates on any statistics the agent quotes
Tips for getting useful results
Ask for one outcome at a time, such as checking whether AI bots can reach your site or rewriting one comparison page into an answer-ready format. Ask the agent to explain its reasoning, and to say when evidence is observational rather than official documentation.
Test the advice yourself. Ask the same questions in the AI assistants you care about and record the answers over time, since results shift.
- Start with a single page or topic before changing a whole site
- Ask which claims come from official platform documentation and which come from studies or case reports
- Do not treat a vendor statistic as a forecast for your own market without matching the engine, industry and date
What people use it for
- Asking whether AI crawlers can reach your site and discovery files such as llms.txt
- Restructuring a comparison or FAQ page so an AI system can extract a clear answer block
- Investigating why an AI assistant states your pricing or features incorrectly
- Planning how to track AI mentions and referrals beyond simple referral clicks
- Deciding which content types to improve first for AI answer engines
Frequently asked questions
How do I install the ai-seo skill?
Download the ZIP from this page and unzip it so the ai-seo folder sits in ~/.claude/skills/ for personal use, or in .claude/skills/ inside a project. In the Claude apps, you can instead go to Settings, then Capabilities, then Skills, and upload it.
Is the ai-seo skill free?
The skill is licensed under MIT, as listed on this page. Check the license file in the download for the full terms.
What do I need to use the ai-seo skill?
You need the installed skill directory with its bundled reference files. An optional product-marketing context file at .agents/product-marketing.md or .claude/product-marketing.md makes answers more tailored.
Does the ai-seo skill run scripts or use the internet?
According to its listing, it runs no scripts and uses no network access. It provides instructions and reference notes rather than a tool that changes your site or checks live results.
Can this skill guarantee my brand appears in ChatGPT or Google AI Overviews?
No. The guidance is probabilistic and AI platform behavior changes quickly. Some reference material is marked as volatile or observational, so treat advice as something to test.
How does ai-seo compare with the seo-audit and schema skills?
The ai-seo skill focuses on AI citations and AI answer visibility. Traditional technical and on-page audits are covered by the separate seo-audit skill, and structured data implementation by the separate schema skill.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use the ai-seo skill if you are a marketing team, content writer or site owner who wants AI assistants to cite your content, or who wants to check whether AI bots can read your site. Pick a different tool or skill if you need a traditional technical SEO audit, structured data implementation, or a guarantee of placement in AI answers.
Download the skill