diff --git a/docs/advanced/api-reference.mdx b/docs/advanced/api-reference.mdx
index ef8cc1a..9869270 100644
--- a/docs/advanced/api-reference.mdx
+++ b/docs/advanced/api-reference.mdx
@@ -1,6 +1,6 @@
 ---
 title: "API reference"
-description: "Complete class and method reference for Deck by PromptPHP."
+description: "Class and method reference for PromptManager, PromptTemplate, the Deck facade, the HasPromptTemplate trait, TrackPromptMiddleware, and the Deck models."
 ---
 
 ## PromptManager
diff --git a/docs/changelog.mdx b/docs/changelog.mdx
index 0af3718..371f8f5 100644
--- a/docs/changelog.mdx
+++ b/docs/changelog.mdx
@@ -1,6 +1,6 @@
 ---
 title: "Changelog"
-description: "New features, fixes, and breaking changes in Deck by PromptPHP."
+description: "Release notes for each Deck by PromptPHP version, listing added features, fixes, and changes. Deck follows Semantic Versioning and publishes an RSS feed."
 rss: true
 ---
 
diff --git a/docs/getting-started/configuration.mdx b/docs/getting-started/configuration.mdx
index 571b647..5cdd71a 100644
--- a/docs/getting-started/configuration.mdx
+++ b/docs/getting-started/configuration.mdx
@@ -1,6 +1,6 @@
 ---
 title: "Configuration"
-description: "All available configuration options for Deck by PromptPHP."
+description: "Set the Deck prompts path, file extension, versioning strategy, cache, database tracking, and AI SDK options in config/deck.php or environment variables."
 ---
 
 ## Introduction
diff --git a/docs/getting-started/introduction.mdx b/docs/getting-started/introduction.mdx
index b79cb38..ec83599 100644
--- a/docs/getting-started/introduction.mdx
+++ b/docs/getting-started/introduction.mdx
@@ -1,6 +1,6 @@
 ---
 title: "Introduction"
-description: "Deck by PromptPHP helps you organise your AI agent instructions as structured, version-controlled files, making it easy to iterate, compare, and activate prompt versions across your Laravel / PHP application."
+description: "Deck organises your AI agent instructions as version-controlled files, so you can iterate, compare, and activate prompt versions in your Laravel app."
 ---
 
 It provides variable interpolation, performance tracking, A/B testing, and optional seamless integration with the [Laravel AI SDK](https://laravel.com/docs/ai-sdk).