# Ticket Duplicate Detection

> Detects similar/duplicate tickets before creating new ones.

- **Type:** Skill
- **Install:** `agentstack add skill-bradtaylorsf-alphaagent-team-ticket-duplicate-detection`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [bradtaylorsf](https://agentstack.voostack.com/s/bradtaylorsf)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [bradtaylorsf](https://github.com/bradtaylorsf)
- **Source:** https://github.com/bradtaylorsf/alphaagent-team/tree/main/plugins/aai-pm-linear/skills/ticket-duplicate-detection

## Install

```sh
agentstack add skill-bradtaylorsf-alphaagent-team-ticket-duplicate-detection
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Ticket Duplicate Detection Skill

Patterns for checking Linear for similar/duplicate tickets before creating new ones.

## Purpose

Avoid creating duplicate tickets by:
- Searching Linear with multiple query patterns
- Presenting potential duplicates to user
- Offering options: link, sub-issue, or proceed

## Detection Methodology

### Step 1: Extract Search Keywords

From the user's issue description, extract:
1. **Primary keywords**: Main noun/verb (e.g., "drawer", "modal", "z-index")
2. **Technical terms**: Component names, error messages, file names
3. **Synonyms**: Related terms (e.g., "sidebar" for "drawer", "dialog" for "modal")

### Step 2: Search Linear

Use `mcp__linear__list_issues` with multiple queries:

```
# Search 1: Primary keywords
mcp__linear__list_issues with query="drawer z-index", updatedAt="-P30D", limit=20

# Search 2: Error messages (if applicable)
mcp__linear__list_issues with query="handleTabChange undefined", limit=10

# Search 3: Component/file names
mcp__linear__list_issues with query="AppDrawer", limit=10
```

**Time range**: Search issues updated in last 30 days (`updatedAt: "-P30D"`)

### Step 3: Filter Results

Check results for:
- Open issues (active work)
- Recently closed (might be reopened)
- Same component/area
- Similar symptoms

### Step 4: Present to User

If potential duplicates found:

```markdown
## Potential Duplicate Tickets Found

I found these similar tickets before creating a new one:

1. **PROJ-123**: "Fix drawer z-index issue" (Open)
   - Similar: Both about drawer layering

2. **PROJ-100**: "Modal appears behind sidebar" (Done - 2 weeks ago)
   - Similar: Same UI area

**Options:**
A) Link to existing ticket (add as related)
B) Create as sub-issue of existing ticket
C) Proceed with new ticket (different issue)

Which option?
```

### Step 5: Take Action

Based on user choice:
- **Option A**: Add link/comment to existing ticket
- **Option B**: Create with parentId set
- **Option C**: Create new ticket as planned

## Search Patterns Reference

| Issue Type | Primary Search | Secondary Search |
|------------|---------------|------------------|
| UI Bug | Component name + symptom | "modal", "dialog", "overlay" |
| Error | Error message | Function/file name |
| Feature | Feature name | Related features |
| Performance | "slow", "performance" | Component name |
| Styling | "z-index", "css", "style" | Component name |

## Common Synonym Mappings

| Term | Also search for |
|------|-----------------|
| drawer | sidebar, nav, navigation |
| modal | dialog, popup, overlay |
| button | btn, click, action |
| form | input, field, validation |
| error | bug, crash, fail |

## Integration

Used by:
- `linear-ticket-creator` agent (required first step)
- `/ticket-create` command (via agent)

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [bradtaylorsf](https://github.com/bradtaylorsf)
- **Source:** [bradtaylorsf/alphaagent-team](https://github.com/bradtaylorsf/alphaagent-team)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-bradtaylorsf-alphaagent-team-ticket-duplicate-detection
- Seller: https://agentstack.voostack.com/s/bradtaylorsf
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.