# Agent Transcript > GitHub PR/issue agent transcripts: redact, preview, and insert safely. - **Type:** Skill - **Install:** `agentstack add skill-openclaw-agent-skills-agent-transcript` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [openclaw](https://agentstack.voostack.com/s/openclaw) - **Installs:** 0 - **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [openclaw](https://github.com/openclaw) - **Source:** https://github.com/openclaw/agent-skills/tree/main/skills/agent-transcript ## Install ```sh agentstack add skill-openclaw-agent-skills-agent-transcript ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # Agent Transcript Best-effort local-only provenance for OpenClaw PR/issue bodies. Use during agent-created GitHub PR or issue workflows before creating/updating the body. ## 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 details, or auth URLs. - Drop system/developer prompts, raw tool outputs, reasoning, env, cookies, tokens, and broad local paths. - Keep user prompts, assistant visible decisions, terse tool summaries, and test/proof outcomes. - Automatically trim the rendered transcript before showing it, previewing it, or inserting it into a public body. Never paste the raw full-session render into a PR/issue body just because `render` or `append-body` produced it. - Remove session turns unrelated to the PR/issue work. Use the PR/issue title, branch name, changed files, and stated goal as scope; omit earlier/later unrelated tasks even when they are in the same session log. - Best effort only: PR/issue creation must continue if no safe transcript is found. - Add the `## Agent Transcript` section only when inserting a real transcript. Never add a placeholder transcript heading or text such as "A sanitized local transcript preview was generated but not included." - Use a collapsed `` section and update existing markers instead of duplicating sections. ## Helper ```bash skills/agent-transcript/scripts/agent-transcript --help ``` Find a likely local session: ```bash skills/agent-transcript/scripts/agent-transcript find \ --query "$PR_TITLE $BRANCH_OR_PR_URL" \ --cwd "$PWD" \ --since-days 14 ``` `find` scans the newest 400 matching local JSONL logs by default across Codex, Claude, Pi, and OpenClaw agent sessions. Use `--max-files N` for a wider local search. In a downstream repo that syncs shared skills under `.agents/skills`, replace `skills/agent-transcript` with `.agents/skills/agent-transcript`. Render a PR/issue body section: ```bash skills/agent-transcript/scripts/agent-transcript render \ --session "$SESSION_JSONL" \ --out /tmp/agent-transcript.md ``` Preview one candidate session locally: ```bash skills/agent-transcript/scripts/agent-transcript preview \ --session "$SESSION_JSONL" \ --out /tmp/agent-transcript-preview.html open /tmp/agent-transcript-preview.html ``` Append/update a body file before `gh pr create --body-file` or connector PR creation: ```bash skills/agent-transcript/scripts/agent-transcript append-body \ --body /tmp/pr-body.md \ --session "$SESSION_JSONL" \ --out /tmp/pr-body.with-transcript.md ``` ## 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 user or inserting it publicly. Keep only turns that explain this PR/issue's goal, implementation choices, files, tests, proof, blockers, and final outcome. 6. Inspect the trimmed transcript text. If it still includes unrelated earlier/later work, trim again before proceeding. 7. If the user approves, use the enriched trimmed body file for creation/update. 8. If no safe session is found, say nothing and continue without transcript. If the user declines, continue without transcript and do not add any transcript placeholder section. ## Validate ```bash node --test skills/agent-transcript/scripts/agent-transcript.test.mjs ``` ## 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: ```bash skills/agent-transcript/scripts/agent-transcript html \ --prs /tmp/recent-prs.json \ --out /tmp/agent-transcript-preview.html ``` ## Source & license This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [openclaw](https://github.com/openclaw) - **Source:** [openclaw/agent-skills](https://github.com/openclaw/agent-skills) - **License:** MIT Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/skill-openclaw-agent-skills-agent-transcript - Seller: https://agentstack.voostack.com/s/openclaw - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.