chore: add agent review skills#323
Conversation
Signed-off-by: Sertac Ozercan <sozercan@gmail.com>
Signed-off-by: Sertac Ozercan <sozercan@gmail.com>
There was a problem hiding this comment.
Pull request overview
This PR adds two repo-local agent skills copied from sozercan/kaset#286 into the .agents/skills/ directory. These provide reusable AI agent workflows: one for rendering redacted agent session transcripts into PR/issue bodies, and another for running structured code review closeout checks using various AI engines (Codex, Claude, etc.). The PR description explicitly states the intent to preserve the copied files as-is.
Changes:
- Add
agent-transcriptskill: a Node.js-based tool that discovers, redacts, and renders local agent session logs into safe Markdown sections for PR/issue bodies - Add
autoreviewskill: a Python-based structured code review helper supporting multiple engines (Codex, Claude, droid, copilot) with secret redaction, parallel test execution, and review panels - Include comprehensive test suites for both skills and shell/PowerShell wrapper scripts for the test harness
Show a summary per file
| File | Description |
|---|---|
.agents/skills/autoreview/SKILL.md |
Documentation/contract for the autoreview skill |
.agents/skills/autoreview/scripts/autoreview |
Main Python autoreview helper (1687 lines) |
.agents/skills/autoreview/scripts/autoreview.test.py |
Unit tests for autoreview helper |
.agents/skills/autoreview/scripts/test-review-harness.py |
Integration test harness creating fixture repos |
.agents/skills/autoreview/scripts/test-review-harness |
Bash wrapper for the test harness |
.agents/skills/autoreview/scripts/test-review-harness.ps1 |
PowerShell wrapper for the test harness |
.agents/skills/agent-transcript/SKILL.md |
Documentation/contract for the agent-transcript skill |
.agents/skills/agent-transcript/scripts/agent-transcript |
Main Node.js agent-transcript helper (1176 lines) |
.agents/skills/agent-transcript/scripts/agent-transcript.test.mjs |
Comprehensive tests for agent-transcript |
Copilot's findings
Tip
Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- Files reviewed: 10/10 changed files
- Comments generated: 5
Signed-off-by: Sertac Ozercan <sozercan@gmail.com>
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 77cef8ac5a
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
Signed-off-by: Sertac Ozercan <sozercan@gmail.com>
Signed-off-by: Sertac Ozercan <sozercan@gmail.com>
Signed-off-by: Sertac Ozercan <sozercan@gmail.com>
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 7feb0a0d4b
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
Signed-off-by: Sertac Ozercan <sozercan@gmail.com>
Signed-off-by: Sertac Ozercan <sozercan@gmail.com>
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: e026874024
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
Signed-off-by: Sertac Ozercan <sozercan@gmail.com>
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 166555d38f
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
Signed-off-by: Sertac Ozercan <sozercan@gmail.com>
Summary
agent-transcriptrepo-local skill from Add agent review and transcript guidance sozercan/kaset#286.autoreviewrepo-local skill from Add agent review and transcript guidance sozercan/kaset#286.agents.mdContinuous Review and GitHub PR transcript guidance from Add agent review and transcript guidance sozercan/kaset#286.ya29...access tokens in transcript rendering and autoreview bundleshf_...access tokens in transcript rendering and autoreview bundlesWhy
These skills and instructions provide reusable local agent workflows for safe transcript rendering and structured autoreview closeout checks.
Validation
4808bb4c535847e9a899c4eb452f74357cf26ee6) before review-driven edits.node .agents/skills/agent-transcript/scripts/agent-transcript.test.mjsPYTHONDONTWRITEBYTECODE=1 python3 .agents/skills/autoreview/scripts/autoreview.test.pygit diff --check