# Analyze

> Semantic analysis of converted recordings. TRIGGERS - analyze cast, keyword extraction, find patterns.

- Skill: `terrylica/analyze` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add terrylica/analyze`
- Raw SKILL.md: https://api.skillmd.com/api/skills/terrylica/analyze/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: terrylica (https://skillmd.com/u/terrylica)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/terrylica/analyze

---


# /asciinema-tools:analyze

Run semantic analysis on converted .txt recordings.

> **Self-Evolving Skill**: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.

## Arguments

| Argument        | Description                                |
| --------------- | ------------------------------------------ |
| `file`          | Path to .txt file                          |
| `-d, --domains` | Domains: `trading,ml,dev,claude`           |
| `-t, --type`    | Type: `curated`, `auto`, `full`, `density` |
| `--json`        | Output in JSON format                      |
| `--md`          | Save as markdown report                    |
| `--density`     | Include density analysis                   |
| `--jump`        | Jump to peak section after analysis        |

## Execution

Invoke the `asciinema-analyzer` skill with user-selected options.

### Skip Logic

- If `file` provided -> skip Phase 1 (file selection)
- If `-t` provided -> skip Phase 2 (analysis type)
- If `-d` provided -> skip Phase 3 (domain selection)
- If `--json/--md` provided -> skip Phase 6 (report format)
- If `--jump` provided -> auto-execute jump after analysis

### Workflow

1. **Preflight**: Check for .txt file
2. **Discovery**: Find .txt files
3. **Selection**: AskUserQuestion for file
4. **Type**: AskUserQuestion for analysis type
5. **Domain**: AskUserQuestion for domains (multi-select)
6. **Curated**: Run ripgrep searches
7. **Auto**: Run YAKE if selected
8. **Density**: Calculate density windows if selected
9. **Format**: AskUserQuestion for report format
10. **Next**: AskUserQuestion for follow-up action

## Examples

```bash
# Quick curated analysis for trading domain
/asciinema-tools:analyze session.txt -d trading -t curated

# Full analysis with density and JSON output
/asciinema-tools:analyze session.txt -t full --density --json

# Auto keyword discovery with markdown report
/asciinema-tools:analyze session.txt -t auto --md
```

## Troubleshooting

| Issue              | Cause                          | Solution                    |
| ------------------ | ------------------------------ | --------------------------- |
| ripgrep not found  | Not installed                  | `brew install ripgrep`      |
| YAKE not available | Python package missing         | `uv pip install yake`       |
| No keywords found  | Wrong domain or sparse content | Try `-t auto` for discovery |


## Post-Execution Reflection

After this skill completes, check before closing:

1. **Did the command succeed?** — If not, fix the instruction or error table that caused the failure.
2. **Did parameters or output change?** — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
3. **Was a workaround needed?** — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.

Only update if the issue is real and reproducible — not speculative.