Improve automated code review quality #953

Activity

1. allenporter commented on Sep 12, 2026

   

   allenporter

   on Sep 12, 2026

   Last edited by allenporter

   ContributorAuthor

   More actions

   Proposal: Unified Agent Instructions & Skills Configuration

   To ensure high-quality contributions and automated reviews across all major coding agents (Google Antigravity, OpenAI Codex, Anthropic Claude Code, and GitHub Copilot for both VS Code and PR Code Review), we can adopt a unified layout that relies on a single source of truth with zero content duplication.

   Proposed Minimal File Structure

   .
   ├── AGENTS.md                                   # Single source of truth for guidelines, standards & commands
   ├── CLAUDE.md -> AGENTS.md                      # Symlink for Claude Code instructions
   ├── .agents/
   │   └── skills/                                 # Canonical Agent Skills directory (open specification)
   │       └── <skill-name>/
   │           └── SKILL.md                        # Portable Agent Skills spec (progressive disclosure)
   └── .claude/
       └── skills -> ../.agents/skills             # Symlink so Claude Code natively discovers all skills
   
2. allenporter commented on Sep 12, 2026

   

   allenporter

   on Sep 12, 2026

   Last edited by allenporter

   ContributorAuthor

   More actions

   We do not need copilot-instructions.md anymore since the only thing that only reads it is VSCode built in review, but normal chat works.

   Tool / Surface	Instructions Ingested	Skills Discovery	Notes
   OpenAI Codex	AGENTS.md	.agents/skills/	Standard native discovery.
   Google Antigravity	AGENTS.md	.agents/skills/	Natively discovers AGENTS.md (no GEMINI.md required) and supports progressive disclosure for skills.
   GitHub Copilot PR Review	AGENTS.md & copilot-instructions.md	.agents/skills/	Natively reads both instruction files and skills from the PR head branch on GitHub.com.
   GitHub Copilot (VS Code)	AGENTS.md (Chat/Agent) & copilot-instructions.md (Review)	.agents/skills/	VS Code Copilot natively implements the Agent Skills specification and loads .agents/skills/.
   Claude Code	CLAUDE.md (resolves to AGENTS.md)	.claude/skills/ (resolves to .agents/skills/)	Follows the Agent Skills specification. Natively supports symlinked skill folders for auto-triggering and /<skill-name> slash commands.
3. allenporter

   added a commit that references this issue on Sep 12, 2026

   docs: add repository engineering guidelines, review skill, and contri…

   ...

   7d65d27