diff --git a/docs/client-implementation/adding-skills-support.mdx b/docs/client-implementation/adding-skills-support.mdx
index 0a27d0a..6c78430 100644
--- a/docs/client-implementation/adding-skills-support.mdx
+++ b/docs/client-implementation/adding-skills-support.mdx
@@ -168,7 +168,7 @@ For each discovered skill, include `name`, `description`, and optionally `locati
 <available_skills>
   <skill>
     <name>pdf-processing</name>
-    <description>Extract text and tables from PDF files, fill forms, merge documents.</description>
+    <description>Extract PDF text, fill forms, merge files. Use when handling PDFs.</description>
     <location>/home/user/.agents/skills/pdf-processing/SKILL.md</location>
   </skill>
   <skill>
diff --git a/docs/specification.mdx b/docs/specification.mdx
index 8fe6577..34d3a9a 100644
--- a/docs/specification.mdx
+++ b/docs/specification.mdx
@@ -36,7 +36,7 @@ With optional fields:
 ```yaml
 ---
 name: pdf-processing
-description: Extract text and tables from PDF files, fill forms, merge documents.
+description: Extract PDF text, fill forms, merge files. Use when handling PDFs.
 license: Apache-2.0
 metadata:
   author: example-org
diff --git a/docs/what-are-skills.mdx b/docs/what-are-skills.mdx
index 11c65d7..0f80ba0 100644
--- a/docs/what-are-skills.mdx
+++ b/docs/what-are-skills.mdx
@@ -32,7 +32,7 @@ Every skill starts with a `SKILL.md` file containing YAML frontmatter and Markdo
 ```mdx
 ---
 name: pdf-processing
-description: Extract text and tables from PDF files, fill forms, merge documents.
+description: Extract PDF text, fill forms, merge files. Use when handling PDFs.
 ---
 
 # PDF Processing