glebis/transcript-analyzer

Transcript Analyzer

Overview

Analyze meeting transcripts using AI to automatically extract and categorize:

• Decisions - Explicit agreements or choices made
• Action Items - Tasks assigned to people
• Opinions - Viewpoints expressed but not agreed upon
• Questions - Unresolved questions raised
• Terms - Domain-specific terminology for glossary

Prerequisites

Before first use, install dependencies:

cd ~/.claude/skills/transcript-analyzer/scripts && npm install

Usage

To analyze a transcript:

cd ~/.claude/skills/transcript-analyzer/scripts && npm run cli -- <transcript-file> -o <output.md> [options]

Options

| Option | Description | |--------|-------------| | <file> | Transcript file to analyze (first positional arg) | | -o, --output <path> | Write markdown to file instead of stdout | | --include-transcript | Include full transcript in output [default: off] | | --no-extractions | Exclude extractions section | | --no-glossary | Exclude glossary section | | --glossary <path> | Custom glossary JSON path | | --skip-glossary | Don't preload glossary terms | | --max-terms <num> | Limit glossary suggestions | | --chunk-size <num> | Override chunk size (default: 3000) |

Examples

Basic Analysis

cd ~/.claude/skills/transcript-analyzer/scripts && npm run cli -- /path/to/meeting.md -o /path/to/analysis.md

Include Original Transcript

cd ~/.claude/skills/transcript-analyzer/scripts && npm run cli -- /path/to/meeting.md -o /path/to/analysis.md --include-transcript

Extractions Only (No Glossary)

cd ~/.claude/skills/transcript-analyzer/scripts && npm run cli -- /path/to/meeting.md -o /path/to/analysis.md --no-glossary

Analyze Specific Section

To analyze only part of a transcript, extract the section first:

sed -n '50,100p' /path/to/meeting.md > /tmp/section.md
cd ~/.claude/skills/transcript-analyzer/scripts && npm run cli -- /tmp/section.md -o /path/to/section-analysis.md

Output Format

The tool generates markdown with:

1. YAML Frontmatter - Processing metadata:

   • chunks processed
   • extractions count by type
   • new terms discovered
   • model used (llama-3.3-70b via Cerebras)
   • token usage (input/output/total)

2. Extractions - Categorized findings with confidence scores:

   • Each extraction includes speaker (if identified), source snippet, and related terms

3. Glossary - Approved terms from existing glossary + suggested new terms with definitions

Configuration

The skill uses Cerebras API with the key stored in scripts/.env:

CEREBRAS_API_KEY=<your-key>

Scripts

• scripts/cli.ts - Main CLI entry point
• scripts/src/lib/extract-service.ts - AI processing logic using Cerebras
• scripts/src/lib/markdown.ts - Markdown output generation
• scripts/src/lib/term-utils.ts - Term deduplication utilities
• scripts/src/lib/mockExtractor.ts - Mock mode for testing
• scripts/src/types/index.ts - TypeScript type definitions
• scripts/data/glossary.json - Default glossary storage