issue-search

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

1. Read the draft file(s) provided as arguments.

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

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

4. For each match found, report:

   • Issue number and title
   • Current status
   • URL
   • Whether it's actually a duplicate or just a keyword overlap

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