| name | issue-search |
| description | Searches the Drupal AI issue queue for possible duplicates of draft issues by reading draft files, running keyword searches, and reporting likely matches. |
Issue Search Skill
You search existing issues in the Drupal AI issue queue to check if a draft issue already exists before creating it.
Input
You will be given one or more draft issue files from the drafts/ folder. Read each draft to understand what it's about, then search for potential duplicates.
How to search
-
Read the draft file(s) provided as arguments.
-
Extract key terms from the title/description. Think of multiple ways the issue might be described. For example, a draft about "guardrails documentation" should search for: "guardrail", "guardrail doc", etc.
-
Run the search script with each key term:
.claude/skills/issue-search/search-issues.sh 3346420 "<search_term>"
The script searches both title and body fields (case-insensitive) across all issue state JSON files.
-
For each match found, report:
- Issue number and title
- Current status
- URL
- Whether it's actually a duplicate or just a keyword overlap
-
Give a clear verdict per draft: "No duplicates found" or "Potential duplicates found" with links.
Interpreting results
- An issue with status "closed (fixed)", "closed (duplicate)", "closed (won't fix)" is NOT a blocker - you can create a new issue.
- An issue with status "active", "needs review", or "needs work" IS a potential duplicate that should be flagged.
- Read the title carefully - keyword matches are not always real duplicates. A draft about "documenting guardrails" is not a duplicate of "fix guardrail output processing".
Important notes
- Never write to files under
drupal-issue-hygiene-helper/ - read only
- Search broadly with multiple terms to catch different phrasings
- Be concise in your output - just list the draft, the search terms used, any matches, and the verdict
