Agent skill

Transcript Grep

by hoangsonww in hoangsonww/Claude-Code-Agent-Monitor

Search a Claude Code session transcript for a string or regex pattern and show every matching message with surrounding context.

MITAuto-check passed

Install Transcript Grep

skills CLI
$ npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill transcript-grep -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hoangsonww/Claude-Code-Agent-Monitor transcript-grep --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hoangsonww/Claude-Code-Agent-Monitor.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/ccam-devtools/skills/transcript-grep .claude/skills/transcript-grep && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
transcript-grep
GitHub stars
1.1k
Used in
1 other repo
Token cost
~706 tokens
SKILL.md length
321 words
Files
2
Skills in repo
78
Repo updated
First seen
Licence
MIT

At a glance

Search a Claude Code session transcript for a string or regex pattern and show every matching message with surrounding context.

  • Works in 4 steps: Resolve the session → Fetch and search → Matches with context → …
  • Hunting for a specific message
  • SKILL.md covers Input, Data Sources, Report Sections and Output
  • Calls npm

What it does

Transcript Grep is an agent skill from hoangsonww/Claude-Code-Agent-Monitor. Search a Claude Code session transcript for a string or regex pattern and show every matching message with surrounding context. Reads /api/sessions/:id/transcript and resolves sessions via /api/sessions?limit= from the Agent Monitor dashboard. Use when hunting for a specific message, prompt, tool call, or error inside a session's conversation.

Its SKILL.md is about 710 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

The repository describes itself as: 🚀 A real-time monitoring dashboard for Claude Code & Codex, built with SQLite3, Node.js, Express, React, Vite, TailwindCSS, & WebSockets. It tracks sessions, agent activity… The licence is MIT.

When your agent uses it

  • Hunting for a specific message
  • Error inside a sessions conversation

Example prompts

  • “/transcript-grep”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Resolve the session
  2. Fetch and search
  3. Matches with context
  4. Summary

What it can do on your machine

Read from SKILL.md and the folder at commit e0f4a1a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Transcript Grep loads about 706 tokens when it runs. Until then it costs about 90 tokens; SKILL.md has 321 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~90
When it runs · the whole SKILL.md, loaded when a task matches
~706

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from hoangsonww/Claude-Code-Agent-Monitor at commit e0f4a1a, republished under its MIT licence (© hoangsonww). 321 words, ~706 tokens.

Download SKILL.mdSave it as .claude/skills/transcript-grep/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
transcript-grep
description
Search a Claude Code session transcript for a string or regex pattern and show every matching message with surrounding context. Reads /api/sessions/:id/transcript and resolves sessions via /api/sessions?limit= from the Agent Monitor dashboard. Use when hunting for a specific message, prompt, tool call, or error inside a session's conversation.

Transcript Grep

Find where a pattern appears in a session transcript and show the matches in context.

Input

The user provides: $ARGUMENTS

Interpreted as a session reference plus a search pattern, e.g. <session-id> "rate limit" or latest TypeError. Parsing rules:

  • The session reference is the first token if it looks like an id, or the words latest/last (most recently updated session).
  • The remainder is the search pattern (string or regex, quoted if it contains spaces).
  • If no session is given, default to the most recent session.

Data Sources

EndpointReturns
GET /api/sessions?limit=Nsession list to resolve latest/last and to confirm the id exists
GET /api/sessions/:id/transcriptthe ordered transcript messages (role, content, tool calls/results, timestamps) for the session

Report Sections

1. Resolve the session

If latest/last (or no id), call GET /api/sessions?limit=1. Otherwise verify the id with GET /api/sessions?limit=1000 (or GET /api/sessions/:id). Report the resolved id, status, and model before searching.

Call GET /api/sessions/:id/transcript. Walk the messages in order and match the pattern against message text, tool_name, and tool input/output content. Case-insensitive by default; treat the pattern as a regex if it contains regex metacharacters, otherwise as a literal substring.

3. Matches with context

For each match show:

[#N  HH:MM:SS  role(:tool_name)]
  … preceding line of context …
> matching line with the **pattern** emphasized
  … following line of context …

Number matches sequentially. Include ±1–2 messages (or lines) of context so the match is interpretable. If a tool call matches, show the tool_name and a trimmed view of its arguments/result.

4. Summary

Report: total matches, how many distinct messages matched, the roles involved (user / assistant / tool), and the timestamp span of the matches. If there are zero matches, say so plainly and suggest a looser pattern.

Output

  • Lead with the match count and session header, then the contextual snippets.
  • Keep snippets trimmed — truncate long tool payloads with … rather than dumping them.
  • Cite only transcript content returned by the API — never fabricate messages.
  • If the dashboard is unreachable, tell the user to start it with npm start from the repo root.

© hoangsonww, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in plugins/ccam-devtools/skills/transcript-grep of hoangsonww/Claude-Code-Agent-Monitor.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit e0f4a1a

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in hoangsonww/Claude-Code-Agent-Monitor, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Transcript Grep next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Transcript Grep compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Transcript Grep this skillhoangsonww/Claude-Code-Agent-Monitor1.1k1 repos~706Automated safety check: PassMIT
Baoyu Youtube TranscriptJimLiu/baoyu-skills26k1 repos~2.4kAutomated safety check: PassMIT
Youtube Transcriptbrowser-act/skills6.1k—~2.1kAutomated safety check: PassMIT
Transcription0xsline/OpenChatCut2.2k1 repos~1.1kAutomated safety check: PassAGPL-3.0
Youtube Transcript Skillssickn33/agentic-awesome-skills47k1 repos~1.2kAutomated safety check: PassMIT
Video Transcriptsudecode/plate17k—~1.5kAutomated safety check: PassCustom licence

Similar skills

  • Baoyu Youtube Transcript

    JimLiu/baoyu-skills

    Downloads YouTube video transcripts/subtitles and cover images by URL or video ID.

    26k GitHub starsUsed in 1 repo~2.4k tokens
    Media & CreativeAuto-check passed
  • Youtube Transcript

    browser-act/skills

    YouTube transcript extraction and content reformatting: given a YouTube video URL, opens the video's transcript panel, extracts all timestamped segments, and transforms the raw transcript into…

    6.1k GitHub stars~2.1k tokensUpdated 1 mo ago
    Knowledge ManagementAuto-check passed
  • Transcription

    0xsline/OpenChatCut

    A skill your agent uses when a video/audio task needs OpenChatCut transcription, captions, subtitles, subtitle styling, transcript search, transcript readiness checks, or enabling captions…

    2.2k GitHub starsUsed in 1 repo~1.1k tokens
    Media & CreativeAuto-check passed
  • Youtube Transcript Skills

    sickn33/agentic-awesome-skills

    Fetch YouTube video transcripts, search videos/channels, browse channels, and extract playlists via the getyoutubetranscript.com API - free tier, no card required.

    47k GitHub starsUsed in 1 repo~1.2k tokens
    Knowledge ManagementAuto-check passed
  • Video Transcripts

    udecode/plate

    Generate structured video transcripts from local files or video URLs using Gemini Files API.

    17k GitHub stars~1.5k tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Video Transcript Downloader

    steipete/agent-scripts

    yt-dlp downloads: video, audio, subtitles, transcripts, clips, playlists.

    7.3k GitHub stars~558 tokensUpdated 3 days ago
    Media & CreativeAuto-check passed

More from hoangsonww/Claude-Code-Agent-Monitor

All 78 skills in this repo
  • Budget Set

    hoangsonww/Claude-Code-Agent-Monitor

    Define a spend budget for Claude Code and, optionally, create a cost alert rule that fires when usage crosses the limit, via POST /api/alerts/rules on the Agent Monitor dashboard.

    1.1k GitHub starsUsed in 1 repo~1k tokens
    Auto-check passed
  • Version Release

    hoangsonww/Claude-Code-Agent-Monitor

    Choose and apply the correct semantic version bump for this repository.

    1.1k GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed
  • Cost Breakdown

    hoangsonww/Claude-Code-Agent-Monitor

    Break down Claude Code costs using the Agent Monitor pricing engine.

    1.1k GitHub starsUsed in 1 repo~845 tokens
    Auto-check passed
  • File Headers

    hoangsonww/Claude-Code-Agent-Monitor

    MANDATORY for every coding agent (Claude Code, Codex, or any other) on every change-set — every applicable source file the agent creates or updates MUST start with the project's copyright/authorship…

    1.1k GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • Hook Diagnostics

    hoangsonww/Claude-Code-Agent-Monitor

    Diagnose Claude Code hook installation, delivery, and ingestion issues.

    1.1k GitHub starsUsed in 1 repo~676 tokens
    Auto-check passed
  • Memory Review

    hoangsonww/Claude-Code-Agent-Monitor

    Review the file-based memory store via the Agent Monitor Config Explorer API: the user and project CLAUDE.md plus per-project auto-memory files under ~/.claude/projects/<slug/memory/.md.

    1.1k GitHub starsUsed in 1 repo~970 tokens
    Auto-check passed

Questions about Transcript Grep

What does Transcript Grep do?

Search a Claude Code session transcript for a string or regex pattern and show every matching message with surrounding context. Transcript Grep is an agent skill from hoangsonww/Claude-Code-Agent-Monitor. Search a Claude Code session transcript for a string or regex pattern and show every matching message with surrounding context.

When should I use Transcript Grep?

Transcript Grep fits situations like: hunting for a specific message; error inside a sessions conversation.

How do I install Transcript Grep in Claude Code?

Run `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill transcript-grep -a claude-code`. Or copy the skill folder (plugins/ccam-devtools/skills/transcript-grep in hoangsonww/Claude-Code-Agent-Monitor) into .claude/skills/transcript-grep in your project. Claude Code loads it when a task matches its description.

How do I install Transcript Grep in Codex?

Run `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill transcript-grep -a codex`. Or copy the skill folder (plugins/ccam-devtools/skills/transcript-grep in hoangsonww/Claude-Code-Agent-Monitor) into .agents/skills/transcript-grep in your project. Codex loads it when a task matches its description.

Can I use Transcript Grep in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill transcript-grep -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/transcript-grep, .gemini/skills/transcript-grep, .github/skills/transcript-grep and .opencode/skills/transcript-grep in your project.

What does Transcript Grep need to run?

Going by SKILL.md and its folder, Transcript Grep needs the command-line tools its instructions call (npm).

Does Transcript Grep access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Transcript Grep safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Transcript Grep use?

Transcript Grep is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Transcript Grep use?

About 706 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Transcript Grep?

Skills that share tags, products or a category with Transcript Grep: Baoyu Youtube Transcript (JimLiu/baoyu-skills, 26k stars), Youtube Transcript (browser-act/skills, 6.1k stars), Transcription (0xsline/OpenChatCut, 2.2k stars) and Youtube Transcript Skills (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Transcript Grep?

hoangsonww (a GitHub user) maintains it in hoangsonww/Claude-Code-Agent-Monitor, which has 1,052 GitHub stars. The repository holds 78 skills in this directory. The repository was last updated on October 6, 2026.

Source: hoangsonww/Claude-Code-Agent-Monitor on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.