seo: improve page titles, descriptions, og:image, and H1 alignment

stephanj · claude · stephanj · commit f637c2147d35 · 2026-02-18T16:41:26.000+01:00
- Enrich generic page titles with keywords (Agent Mode, CLI Runners,
  Chat Interface, Project Scanner, etc.) for better SERP visibility
- Shorten agent-mode.md description from 323 chars to SERP-safe 183
- Shorten cli-runners.md description from 219 chars to 190
- Add og:image frontmatter to 8 high-value pages missing social cards
  (agent-mode, rag, mcp_expanded, skills, inline-completion,
  appearance, local-models, cloud-models)
- Align H1 tags with page title tags on introduction.md and overview.md
- Add Related Features section with internal links to skills.md

Co-Authored-By: Claude Sonnet 4.6 &lt;noreply@anthropic.com&gt;
diff --git a/docusaurus/docs/configuration/appearance.md b/docusaurus/docs/configuration/appearance.md
@@ -3,6 +3,7 @@ sidebar_position: 3
 title: Appearance Settings
 description: Customize the look and feel of the DevoxxGenie chat interface — colors, spacing, and font sizes.
 keywords: [devoxxgenie, appearance, theme, colors, fonts, customization, intellij plugin]
+image: /img/devoxxgenie-social-card.jpg
 ---
 
 # Appearance Settings
diff --git a/docusaurus/docs/features/acp-runners.md b/docusaurus/docs/features/acp-runners.md
@@ -1,6 +1,6 @@
 ---
 sidebar_position: 4
-title: ACP Runners
+title: ACP Runners - Agent Communication Protocol in IntelliJ IDEA
 description: Execute spec tasks via external ACP (Agent Communication Protocol) tools. DevoxxGenie communicates with ACP-compatible CLIs using JSON-RPC 2.0 over stdin/stdout for structured agent interactions.
 keywords: [devoxxgenie, acp runners, agent communication protocol, json-rpc, claude, kimi, gemini, kilocode, agent loop, spec-driven development]
 image: /img/devoxxgenie-social-card.jpg
diff --git a/docusaurus/docs/features/agent-mode.md b/docusaurus/docs/features/agent-mode.md
@@ -1,7 +1,8 @@
 ---
 sidebar_position: 2
-title: Agent Mode
-description: Enable agent mode to let the LLM autonomously explore and modify your codebase using built-in tools. Fetch web pages for documentation. Run tests automatically after code changes. Use PSI tools for semantic code intelligence. Use parallel sub-agents for concurrent read-only exploration. Enable or disable individual tools.
+title: Agent Mode - Autonomous AI Coding in IntelliJ IDEA
+description: DevoxxGenie Agent Mode lets your LLM autonomously explore, edit, and test your codebase using built-in tools, PSI code intelligence, and parallel sub-agents — in IntelliJ IDEA.
+image: /img/devoxxgenie-social-card.jpg
 keywords: [devoxxgenie, agent mode, sub-agents, parallel explore, codebase exploration, multi-agent, tools, run tests, test execution, fetch page, tool control, PSI, code intelligence, find references, find definition, find implementations]
 ---
 
diff --git a/docusaurus/docs/features/chat-interface.md b/docusaurus/docs/features/chat-interface.md
@@ -1,6 +1,6 @@
 ---
 sidebar_position: 2
-title: Chat Interface
+title: Chat Interface - AI Code Assistant in IntelliJ IDEA
 description: Use the DevoxxGenie chat interface to have code-related conversations with LLMs, add files to context, stream responses, and manage conversation history.
 keywords: [devoxxgenie, chat interface, conversation, code assistant, streaming, context files, intellij plugin]
 image: /img/devoxxgenie-social-card.jpg
diff --git a/docusaurus/docs/features/chat-memory.md b/docusaurus/docs/features/chat-memory.md
@@ -1,6 +1,6 @@
 ---
 sidebar_position: 8
-title: Chat Memory
+title: Chat Memory & Conversation Context - DevoxxGenie
 description: Configure DevoxxGenie's chat memory to control how much conversation context is sent to the LLM, balancing response quality with token usage.
 keywords: [devoxxgenie, chat memory, conversation context, memory size, token usage, llm context, chat history]
 image: /img/devoxxgenie-social-card.jpg
diff --git a/docusaurus/docs/features/cli-runners.md b/docusaurus/docs/features/cli-runners.md
@@ -1,7 +1,7 @@
 ---
 sidebar_position: 5
-title: CLI Runners
-description: Execute spec tasks via external CLI tools like Claude Code, GitHub Copilot CLI, OpenAI Codex CLI, Google Gemini CLI, or Kimi CLI. DevoxxGenie manages the task lifecycle while your preferred tool does the implementation.
+title: CLI Runners - Use Claude Code & Copilot in IntelliJ IDEA
+description: Use Claude Code, GitHub Copilot CLI, Codex, Gemini CLI, or Kimi CLI directly inside IntelliJ IDEA. DevoxxGenie CLI Runners manage spec task execution via your existing AI subscriptions.
 keywords: [devoxxgenie, cli runners, claude code, copilot, codex, gemini, kimi, cli tools, spec-driven development, sdd, agent loop]
 image: /img/devoxxgenie-social-card.jpg
 ---
diff --git a/docusaurus/docs/features/dnd-images.md b/docusaurus/docs/features/dnd-images.md
@@ -1,6 +1,6 @@
 ---
 sidebar_position: 6
-title: Drag & Drop Images
+title: Multimodal AI - Drag & Drop Images in IntelliJ IDEA
 description: Drag and drop images into DevoxxGenie to use multimodal LLMs like Gemini, Claude, and GPT-4V for visual code analysis, UI review, and diagram interpretation.
 keywords: [devoxxgenie, drag and drop, images, multimodal, vision, gemini, claude, gpt-4v, llava, screenshot]
 image: /img/devoxxgenie-social-card.jpg
diff --git a/docusaurus/docs/features/inline-completion.md b/docusaurus/docs/features/inline-completion.md
@@ -3,6 +3,7 @@ sidebar_position: 10
 title: Inline Code Completion
 description: Setup and configuration guide for DevoxxGenie's inline code completion feature using Fill-in-the-Middle (FIM) models via Ollama or LM Studio.
 keywords: [inline completion, code completion, intellij, fim, fill-in-the-middle, ollama, lmstudio, starcoder, qwen, deepseek-coder]
+image: /img/devoxxgenie-social-card.jpg
 ---
 
 import Tabs from '@theme/Tabs';
diff --git a/docusaurus/docs/features/mcp_expanded.md b/docusaurus/docs/features/mcp_expanded.md
@@ -3,6 +3,7 @@ sidebar_position: 3
 title: MCP Support - Model Context Protocol
 description: Learn how DevoxxGenie integrates with MCP servers to give your LLM access to external tools, files, databases, and APIs. Enable or disable individual tools per server.
 keywords: [devoxxgenie, mcp, model context protocol, tools, agents, intellij plugin, marketplace, tool control]
+image: /img/devoxxgenie-social-card.jpg
 ---
 
 # MCP Support
diff --git a/docusaurus/docs/features/overview.md b/docusaurus/docs/features/overview.md
@@ -6,7 +6,7 @@ keywords: [devoxxgenie, intellij plugin, ai features, llm, code assistance, rag,
 image: /img/devoxxgenie-social-card.jpg
 ---
 
-# Features Overview
+# Features Overview - DevoxxGenie Documentation
 
 DevoxxGenie offers a comprehensive set of features designed to enhance your development workflow with AI assistance. This page provides an overview of the key features available in the plugin.
 
diff --git a/docusaurus/docs/features/project-scanner.md b/docusaurus/docs/features/project-scanner.md
@@ -1,6 +1,6 @@
 ---
 sidebar_position: 7
-title: Project Scanner
+title: Project Scanner - Add Codebase Context to AI Prompts
 description: Add your project source code to the prompt context with DevoxxGenie's Project Scanner, including full project, directory, or individual file scanning with AST analysis.
 keywords: [devoxxgenie, project scanner, source code context, ast analysis, code analysis, project context, intellij plugin]
 image: /img/devoxxgenie-social-card.jpg
diff --git a/docusaurus/docs/features/rag.md b/docusaurus/docs/features/rag.md
@@ -3,6 +3,7 @@ sidebar_position: 6
 title: RAG Support - Retrieval-Augmented Generation
 description: Learn how DevoxxGenie uses Retrieval-Augmented Generation (RAG) to improve AI assistance by automatically finding and incorporating relevant code from your project.
 keywords: [rag, retrieval augmented generation, chromadb, ollama, code search, intellij, ai coding]
+image: /img/devoxxgenie-social-card.jpg
 slug: /features/rag
 ---
 
diff --git a/docusaurus/docs/features/skills.md b/docusaurus/docs/features/skills.md
@@ -3,6 +3,7 @@ sidebar_position: 4
 title: Skills - Custom Slash Commands
 description: Learn how to use and create Skills in DevoxxGenie — reusable slash commands that let you trigger common prompts with a simple /command.
 keywords: [devoxxgenie, skills, slash commands, custom prompts, intellij plugin, ai assistant]
+image: /img/devoxxgenie-social-card.jpg
 ---
 
 # Skills
@@ -100,3 +101,9 @@ Skills and the system prompt serve different purposes:
 - Use `$ARGUMENT` to make skills flexible — the same skill can handle different inputs
 - Create project-specific skills for patterns you use frequently (e.g., `/service` to generate a service class following your project's conventions)
 - Combine skills with file context — select code in the editor before running a skill to include it in the prompt
+
+## Related Features
+
+- [Agent Mode](agent-mode.md) — let the LLM use skills autonomously via tool calls
+- [MCP Support](mcp_expanded.md) — extend capabilities with external tool servers
+- [Chat Interface](chat-interface.md) — use skills directly in the chat panel
diff --git a/docusaurus/docs/features/web-search.md b/docusaurus/docs/features/web-search.md
@@ -1,6 +1,6 @@
 ---
 sidebar_position: 5
-title: Web Search
+title: Web Search Integration - DevoxxGenie for IntelliJ IDEA
 description: Augment LLM responses with real-time web search results using Google Custom Search or Tavily integration in DevoxxGenie.
 keywords: [devoxxgenie, web search, google custom search, tavily, search augmented, real-time search, llm web access]
 image: /img/devoxxgenie-social-card.jpg
diff --git a/docusaurus/docs/getting-started/introduction.md b/docusaurus/docs/getting-started/introduction.md
@@ -7,7 +7,7 @@ image: /img/devoxxgenie-social-card.jpg
 slug: /getting-started/introduction
 ---
 
-# Introduction to DevoxxGenie
+# Introduction to DevoxxGenie - AI Code Assistant for IntelliJ IDEA
 
 ![DevoxxGenie Logo](../../static/img/genie.svg)
 
diff --git a/docusaurus/docs/llm-providers/cloud-models.md b/docusaurus/docs/llm-providers/cloud-models.md
@@ -3,6 +3,7 @@ sidebar_position: 3
 title: Cloud LLM Providers
 description: Guide to all cloud-based LLM providers supported by DevoxxGenie, including setup instructions and configuration.
 keywords: [devoxxgenie, openai, anthropic, google, gemini, grok, mistral, groq, deepseek, kimi, moonshot, glm, zhipu, cloud llm]
+image: /img/devoxxgenie-social-card.jpg
 ---
 
 # Cloud LLM Providers
diff --git a/docusaurus/docs/llm-providers/custom-providers.md b/docusaurus/docs/llm-providers/custom-providers.md
@@ -1,6 +1,6 @@
 ---
 sidebar_position: 4
-title: Custom Providers
+title: Custom OpenAI-Compatible LLM Providers - DevoxxGenie
 description: Connect DevoxxGenie to any OpenAI-compatible LLM service including self-hosted models, DeepSeek R1, Grok, JLama, and enterprise AI platforms.
 keywords: [devoxxgenie, custom providers, openai compatible, self-hosted llm, deepseek, grok, jlama, enterprise ai, custom endpoint]
 image: /img/devoxxgenie-social-card.jpg
diff --git a/docusaurus/docs/llm-providers/local-models.md b/docusaurus/docs/llm-providers/local-models.md
@@ -3,6 +3,7 @@ sidebar_position: 2
 title: Local LLM Providers
 description: Guide to all local LLM providers supported by DevoxxGenie, including setup instructions and configuration.
 keywords: [devoxxgenie, ollama, lmstudio, gpt4all, llama.cpp, jan, local llm, privacy]
+image: /img/devoxxgenie-social-card.jpg
 ---
 
 # Local LLM Providers
