agent-transcript

---
name: agent-transcript
description: Use when an agent needs to add a redacted agent transcript section to GitHub PR or issue bodies during OpenClaw agent-created PR/issue workflows from steipete/agent-scripts.
source: https://github.com/steipete/agent-scripts/tree/main/skills/agent-transcript
generated: 2026-05-27T20:55:15.352Z
category: tool
audience: engineers
---

## When to use

- Using the agent-transcript skill's upstream workflow, guardrails, and local-tool assumptions.
- Auditing commands or operational steps before changing agent transcript behavior.
- Needing a compact agent reference for add a redacted agent transcript section to GitHub PR or issue bodies during OpenClaw agent-created PR/issue workflows.

## Key concepts

### Contract

Never use network. Session discovery reads local agent logs only. Never upload raw logs. Render sanitized Markdown first. Always ask the user before adding transcript logs to a GitHub PR/issue body. Tell the user sanitized session logs help reviewers and can make PRs easier to prioritize. Offer a local HTML preview before insertion. If the user wants preview, open it and wait for confirmation before adding the section. Fail closed on unresolved secrets, private keys, browser/session/cookie...

### PR/Issue Workflow

1. Draft the normal PR/issue body first. 2. Run find with title, branch, PR URL/number if known, and cwd. 3. If a high-confidence session is found, ask: Include a redacted agent transcript? It helps reviewers and can make the PR easier to prioritize. I can open a local preview first. 4. If the user wants preview, run preview, open the HTML with open, and wait for confirmation. 5. Render or append to a temp body, then automatically trim the ## Agent Transcript section before showing it to the...

### Review Artifacts

For manual audits across many PR/session candidates, create a local HTML preview from a local JSON file. This is for maintainers only and is not part of the PR/issue workflow:.

## API reference

```
npx skills add steipete/agent-scripts --skill agent-transcript
```

Install the agent-transcript skill from steipete/agent-scripts.

```
npx skills add steipete/agent-scripts --skill agent-transcript
```

```
skills/agent-transcript/scripts/agent-transcript --help.
```

Command or snippet documented by the upstream agent-transcript skill.

```
skills/agent-transcript/scripts/agent-transcript --help
```

```
skills/agent-transcript/scripts/agent-transcript find \.
```

Command or snippet documented by the upstream agent-transcript skill.

```
skills/agent-transcript/scripts/agent-transcript find \
  --query "$PR_TITLE $BRANCH_OR_PR_URL" \
  --cwd "$PWD" \
  --since-days 14
```

```
skills/agent-transcript/scripts/agent-transcript render \.
```

Command or snippet documented by the upstream agent-transcript skill.

```
skills/agent-transcript/scripts/agent-transcript render \
  --session "$SESSION_JSONL" \
  --out /tmp/agent-transcript.md
```

```
skills/agent-transcript/scripts/agent-transcript preview \.
```

Command or snippet documented by the upstream agent-transcript skill.

```
skills/agent-transcript/scripts/agent-transcript preview \
  --session "$SESSION_JSONL" \
  --out /tmp/agent-transcript-preview.html
open /tmp/agent-transcript-preview.html
```

```
skills/agent-transcript/scripts/agent-transcript append-body \.
```

Command or snippet documented by the upstream agent-transcript skill.

```
skills/agent-transcript/scripts/agent-transcript append-body \
  --body /tmp/pr-body.md \
  --session "$SESSION_JSONL" \
  --out /tmp/pr-body.with-transcript.md
```

```
skills/agent-transcript/scripts/agent-transcript html \.
```

Command or snippet documented by the upstream agent-transcript skill.

```
skills/agent-transcript/scripts/agent-transcript html \
  --prs /tmp/recent-prs.json \
  --out /tmp/agent-transcript-preview.html
```

## Gotchas

- Never use network. Session discovery reads local agent logs only.
- Never upload raw logs. Render sanitized Markdown first.
- Always ask the user before adding transcript logs to a GitHub PR/issue body.
- Fail closed on unresolved secrets, private keys, browser/session/cookie details, or auth URLs.

---
Generated by SkillMake from https://github.com/steipete/agent-scripts/tree/main/skills/agent-transcript on 2026-05-27T20:55:15.352Z.
Verify against source before relying on details.

File: ~/.claude/skills/agent-transcript/SKILL.md