Skip to content

Improve prompt-lookup skill and add skill review workflow #1072

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
fernandezbaptiste wants to merge 2 commits into
base: main
Choose a base branch
from
+35 −51
Open

Improve prompt-lookup skill and add skill review workflow #1072

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
d719d10
Improve prompt-lookup skill and add skill review workflow
fernandezbaptiste Mar 11, 2026
05a5a89
Fix: handle fork PR comment failures gracefully
fernandezbaptiste Mar 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions .github/workflows/skill-review.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
72 changes: 21 additions & 51 deletions plugins/claude/prompts.chat/skills/prompt-lookup/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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.
Copy link
Copy Markdown

@coderabbitai coderabbitai bot Mar 11, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Incorrect placeholder syntax documented.

The actual get_prompt tool implementation uses {{variable}} template syntax (per the tool description: "If the prompt contains template variables (like {{variable}})"), but this documentation shows ${variable} and ${variable:default}. This mismatch will confuse agents trying to identify placeholders.

Proposed fix 
-If the prompt contains `${variable}` or `${variable:default}` placeholders, ask the user to fill required values (no default) before using.
+If the prompt contains `{{variable}}` placeholders, ask the user to fill in values before using.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
If the prompt contains `${variable}` or `${variable:default}` placeholders, ask the user to fill required values (no default) before using.
If the prompt contains `{{variable}}` placeholders, ask the user to fill in values before using.
🤖 Prompt for AI Agents 
Verify each finding against the current code and only fix it if needed.

In `@plugins/claude/prompts.chat/skills/prompt-lookup/SKILL.md` at line 28, The
documentation in SKILL.md incorrectly shows `${variable}` syntax; update the
sentence to reference the actual template syntax used by the get_prompt tool
(use `{{variable}}` for placeholders) and adjust the example/phrase about
defaults to match the tool behavior (ask user to fill required `{{variable}}`
placeholders and note that defaults are not used if the tool requires explicit
values). Locate references to `${variable}`/`${variable:default}` and replace
them with `{{variable}}` (and update any mention of default handling to reflect
get_prompt's behavior).


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.
Loading