self-audit

Audit a PR branch for dead code, comment rot, and scope issues.

2|1|Updated Oct 3, 2025
One-click install
npx skills add https://github.com/jamestexas/agents --skill self-audit-jamestexas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: self-audit
Source: https://github.com/jamestexas/agents/tree/main/skills/self-audit
Command: npx skills add https://github.com/jamestexas/agents --skill self-audit-jamestexas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Self-audit of a PR branch to catch issues that the compiler and linters miss, such as dead struct fields, rotting comments, duplicate types, test-only exports, and scope drift, before a human review.

Core Features & Use Cases

  • Structured checks that verify PR scope, dead code, comment quality, duplicate types, and export hygiene.
  • Enforces adherence to project conventions and surfaces design flaws via adversarial analysis.
  • Use case: apply this before pushing a PR to ensure you haven’t left obvious or subtle defects for a reviewer.

Quick Start

Run the self-audit on your current PR branch to surface issues automatically before requesting review.

Frequently Asked Questions about self-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I catch code quality issues in a pull request before human review?

Run a structured self-audit on your PR branch to surface dead struct fields, comment rot, duplicate types, and scope drift that compilers and linters miss before requesting human review.

What is static analysis for design flaws and scope drift in Golang?

Static analysis for design flaws in Golang emulates a veteran reviewer by coordinating multi-step checks on scopes, code smells, and export hygiene, plus an adversarial agent pass to identify subtle defects.

How do I check for dead struct fields and test-only exports before pushing a branch?

Check for dead struct fields and test-only exports by applying a pre-review self-audit to your current branch, which verifies export hygiene and identifies unused code automatically before pushing.

Does this code review audit enforce project conventions and check PR scope?

Yes, the code review audit enforces project conventions by verifying PR scope sanity, checking for scope drift, and ensuring adherence to established project standards during its structured analysis.

What is the best way to find duplicate types and comment rot in a PR branch?

The best way to find duplicate types and comment rot is to run a structured self-audit that emulates a veteran reviewer, coordinating multi-step checks to deliver guidance before human review.

When should I use an adversarial agent pass for quality assurance?

Use an adversarial agent pass for quality assurance when you need to surface subtle design flaws and code smells before pushing a PR, ensuring obvious and complex defects are caught early.