Files
gh-animalzinc-claude-plugin…/commands/extract-quotes.md
2025-11-29 17:55:08 +08:00

169 lines
3.5 KiB
Markdown

---
description: Find representative quotes on specific topics from interview transcripts
argument-hint: [topic] [transcripts-directory] [--max-quotes]
---
# Extract Quotes by Topic
Find the most representative and compelling quotes about a specific topic from interview transcripts.
## Step 1: Scan Transcripts
**Search directory $2 for transcripts:**
- Identify all transcript files
- Count total transcripts available
**Report to user:**
```markdown
## 📁 Transcripts Found
**Directory:** $2
**Transcripts:** [number] files
**Topic to search:** "$1"
Proceeding to extract relevant quotes...
```
---
## Step 2: Extract Relevant Quotes
Use the **quote-selector** agent to:
**For each transcript:**
1. Search for mentions of topic "$1" (and related terms)
2. Extract full quote with context
3. Rate quote quality (clarity, insight value, brevity)
4. Include speaker/participant attribution if available
**Quote selection criteria:**
- **Relevant** - Directly addresses the topic
- **Insightful** - Reveals something meaningful
- **Clear** - Standalone understandable
- **Concise** - Not overly long (prefer 1-3 sentences)
- **Authentic** - Conversational tone preserved
---
## Step 3: Rank and Present Quotes
**Default: Show top 10 quotes**
**If --max-quotes specified: Show that many**
**Present to user:**
```markdown
## 💬 Quotes About: "$1"
Found [total number] relevant quotes across [number] transcripts.
Showing top [$3 or 10] by quality score.
---
### Quote 1 (Score: [X]/10)
> "[Full quote text]"
**Source:** [Transcript name / Participant ID]
**Context:** [Brief context if helpful - when/why this was said]
---
### Quote 2 (Score: [X]/10)
[Same format...]
---
## Quote Categories
**By theme:**
- [Sub-theme 1]: [count] quotes
- [Sub-theme 2]: [count] quotes
**By sentiment:**
- Positive: [count]
- Negative/Pain point: [count]
- Neutral: [count]
---
## Usage Tips
**To find more quotes:**
```bash
/extract-quotes "[topic]" [directory] --max-quotes 20
```
**To search related terms:**
```bash
/extract-quotes "pricing or cost or budget" [directory]
```
```
---
## Step 4: Optional - Export Quotes
**Ask user:**
```
Would you like to:
1. Save these quotes to a file (quotes/$1-quotes.md)
2. Copy to clipboard for pasting elsewhere
3. Just view them here
```
**If user chooses save:**
- Create `quotes/` directory if needed
- Save as `quotes/$1-quotes.md` with all quotes in markdown format
---
## Error Handling
**If topic not found in any transcript:**
```
⚠️ No quotes found for topic: "$1"
Suggestions:
- Try broader search terms
- Check transcript file names to ensure they're included
- Try related terms: /extract-quotes "[alternative terms]"
```
**If no transcripts in directory:**
```
❌ No transcripts found in: $2
Please ensure:
- Directory path is correct
- Transcripts are in .txt or .md format
```
---
## Usage Examples
```bash
# Find quotes about pricing
/extract-quotes pricing ./interviews/
# Find more quotes with custom limit
/extract-quotes "product feedback" ./interviews/ --max-quotes 20
# Search multiple related terms
/extract-quotes "onboarding or getting started" ./customer-calls/
```
---
## Tips
**Effective search terms:**
- Single concepts: `pricing`, `features`, `support`
- Multi-word phrases: `"user experience"`, `"biggest challenge"`
- Related terms with OR: `"price or cost or budget"`
**Quote quality:**
- Scores 8-10: Exceptional quotes (use in presentations)
- Scores 6-7: Good quotes (use in reports)
- Scores 4-5: Useful context (reference material)