llm-optimization

Implement LocalBusiness, FAQPage, and Speakable schemas for AI citations.

4|1|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/Soborbo/claudeskills --skill llm-optimization
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: llm-optimization
Source: https://github.com/Soborbo/claudeskills/tree/main/llm-optimization
Command: npx skills add https://github.com/Soborbo/claudeskills --skill llm-optimization

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill helps websites become more discoverable and citable by AI assistants by aligning content with structured data and Speakable schemas.

Core Features & Use Cases

  • Structured Data Alignment: Implement and audit schema.org types (LocalBusiness, FAQPage, HowTo) to improve AI recognition.
  • Speakable & Visibility: Add Speakable annotations to key pages to facilitate voice-assisted results.
  • References & Validation: Provide clear references to source data and ensure freshness signals for AI indexing.

Quick Start

Run a quick audit of a sample page to identify where LocalBusiness, FAQPage, and Speakable annotations are missing.

  • Add a minimal LocalBusiness schema with name, address, and service area, plus an FAQPage with 3 common questions and answers.
  • Ensure lastModified is present on key pages and the content renders without JavaScript-only rendering.

Frequently Asked Questions about llm-optimization

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get my website content cited by AI assistants?

To get your website cited by AI assistants, implement schema.org structured data types like LocalBusiness, FAQPage, and HowTo, and add Speakable annotations to key pages so AI models can easily parse and recognize your factual content.

What is Speakable schema and when do I need it for LLM optimization?

Speakable schema is a structured data markup that identifies content sections suitable for voice-assisted results. You need it for LLM optimization when you want AI assistants to accurately locate and cite your page content during voice interactions.

How do I add structured data to a LocalBusiness page for AI visibility?

Add a minimal LocalBusiness schema to your service page including your business name, address, and service area. Ensure the HTML is crawlable without JavaScript rendering and include factual outbound references with proper lastModified dates for freshness.

Does structured data work with crawlable HTML for AI indexing?

Structured data works with crawlable HTML by providing explicit entity definitions that AI indexing models can parse. You must ensure your content renders without JavaScript-only rendering and enforce factual accuracy with outbound references to improve AI recognition.

Why are my FAQ pages not showing up in AI assistant responses?

FAQ pages may not show in AI assistant responses if they lack FAQPage schema, have missing lastModified freshness signals, or rely on JavaScript-only rendering. Implementing Speakable annotations and clear outbound references ensures AI models can validate and cite your content.

Can I use schema.org markup to improve voice assistant search results?

You can use schema.org markup to improve voice assistant search results by applying Speakable annotations to key pages. This specifically targets voice-assisted results by defining exactly which content sections AI assistants should extract and read aloud.