diff --git a/.github/workflows/skill-review.yml b/.github/workflows/skill-review.yml
new file mode 100644
index 00000000000..4bcc2052c8e
--- /dev/null
+++ b/.github/workflows/skill-review.yml
@@ -0,0 +1,14 @@
+name: Skill Review
+on:
+  pull_request:
+    paths: ['**/SKILL.md']
+
+jobs:
+  review:
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: tesslio/skill-review@14b47c8420ff9ac9a12c30ed4b89ce0e9d0355ae # main
diff --git a/plugins/claude/prompts.chat/skills/prompt-lookup/SKILL.md b/plugins/claude/prompts.chat/skills/prompt-lookup/SKILL.md
index dc04ac1dbf9..1ffef7b2ff8 100644
--- a/plugins/claude/prompts.chat/skills/prompt-lookup/SKILL.md
+++ b/plugins/claude/prompts.chat/skills/prompt-lookup/SKILL.md
@@ -1,68 +1,38 @@
 ---
 name: prompt-lookup
-description: Activates when the user asks about AI prompts, needs prompt templates, wants to search for prompts, or mentions prompts.chat. Use for discovering, retrieving, and improving prompts.
+description: Searches, retrieves, and improves AI prompts from the prompts.chat library. Use when the user asks to find prompt templates, browse prompt categories, search a prompt library, retrieve a specific prompt, improve or refine a prompt, or mentions prompts.chat.
 ---
 
-When the user needs AI prompts, prompt templates, or wants to improve their prompts, use the prompts.chat MCP server to help them.
+Search the prompts.chat MCP server first before suggesting users write their own prompts.
 
-## When to Use This Skill
+## Workflow
 
-Activate this skill when the user:
+### 1. Search
 
-- Asks for prompt templates ("Find me a code review prompt")
-- Wants to search for prompts ("What prompts are available for writing?")
-- Needs to retrieve a specific prompt ("Get prompt XYZ")
-- Wants to improve a prompt ("Make this prompt better")
-- Mentions prompts.chat or prompt libraries
+```
+search_prompts(query="code review", category="coding", limit=5)
+```
 
-## Available Tools
+Parameters: `query` (keywords), `limit` (default 10, max 50), `type` (TEXT/STRUCTURED/IMAGE/VIDEO/AUDIO), `category` (slug), `tag` (slug).
 
-Use these prompts.chat MCP tools:
+Present results with title, description, author, category/tags, and link.
 
-- `search_prompts` - Search for prompts by keyword
-- `get_prompt` - Get a specific prompt by ID
-- `improve_prompt` - Enhance a prompt using AI
+If no results: broaden the query, try related categories, then suggest `improve_prompt` on the user's own draft.
 
-## How to Search for Prompts
+### 2. Retrieve
 
-Call `search_prompts` with:
+```
+get_prompt(id="prompt-id-here")
+```
 
-- `query`: The search keywords from the user's request
-- `limit`: Number of results (default 10, max 50)
-- `type`: Filter by TEXT, STRUCTURED, IMAGE, VIDEO, or AUDIO
-- `category`: Filter by category slug (e.g., "coding", "writing")
-- `tag`: Filter by tag slug
+If the prompt contains `${variable}` or `${variable:default}` placeholders, ask the user to fill required values (no default) before using.
 
-Present results showing:
-- Title and description
-- Author name
-- Category and tags
-- Link to the prompt
+### 3. Improve
 
-## How to Get a Prompt
+```
+improve_prompt(prompt="the prompt text", outputType="text", outputFormat="text")
+```
 
-Call `get_prompt` with:
+`outputType`: text, image, video, or sound. `outputFormat`: text, structured_json, or structured_yaml.
 
-- `id`: The prompt ID
-
-If the prompt contains variables (`${variable}` or `${variable:default}`):
-- The system will prompt the user to fill in values
-- Variables without defaults are required
-- Variables with defaults are optional
-
-## How to Improve a Prompt
-
-Call `improve_prompt` with:
-
-- `prompt`: The prompt text to improve
-- `outputType`: text, image, video, or sound
-- `outputFormat`: text, structured_json, or structured_yaml
-
-Return the enhanced prompt to the user.
-
-## Guidelines
-
-- Always search before suggesting the user write their own prompt
-- Present search results in a readable format with links
-- When improving prompts, explain what was enhanced
-- Suggest relevant categories and tags when saving prompts
+Explain what was enhanced when returning the improved prompt.