Skills & Instructions

Let a Baz agent code review based on your instruction files (AGENTS.md, SKILL.md, Claude.md, RULE.md and more)

Review from Guidelines lets Baz convert agent rule files, Skills, and Cursor rules into scoped coding guidelines and run an AI code reviewer against pull requests based on those guidelines.

How it works

Baz automatically discovers and analyzes existing instructions files in markdown format, including AGENTS.md and Skill folders containing SKILL.md.

When new instructions are found Baz will convert each into a normalized guideline object. The converted guideline are then persisted to the as custom agent prompts.

The “AI Coding Guidelines” agent loads all specific & relevant instructions for a given PR, based on the modified directory paths and module mapping. The agent will perform a review with the matched guidelines and emit findings as comments.

Skills

Unlike other instruction files, Skills are reusable packages of instructions (following the open Agent Skills standard) that extend an agent’s capabilities for specific tasks. Baz supports Skills by detecting SKILL.md files and encapsulating folders in repositories and merging them with your other instructions.

• Skills provide additional context and capabilities the reviewer can use to make more accurate and context-aware comments.

• Skills are particularly useful for capturing domain-specific best practices, workflows, or project conventions beyond what is defined in AGENTS.md alone.

Coding Guidelines Update

Baz evolves your coding standards by identifying when rules in files like AGENTS.md and SKILL.md are no longer aligned with current team preferences. This ensures your instructions remain consistent and reflect actual engineering practices through a direct feedback loop within your pull requests.

When AI Coding Guidelines reviewer identifies a potential misalignment, it offers to update your coding guidelines directly in your .md files. To do so, just use this comment - 'apply pr to [branch name]'.

By executing this command, you trigger an agent that analyzes the interaction and drafts a PR to incorporate the new logic into your repository's instruction files. This allows your standards to evolve dynamically as you review code, transforming individual feedback into permanent organizational guidelines.

Configuration

• The “AI Coding Guidelines” Reviewer runs automatically for repos that have converted guidelines and where the reviewer has been enabled.

• The reviewer will not run if there are no applicable guidelines for the PR.

• Guidelines selection: only guidelines matching the PR paths or module scope are loaded.

• Coding Guidelines Update requires integrating Baz Fixer, more information can be found here.

FAQ

Can I update the AI Coding Guidelines review prompts?

No. The prompts for the reviewer are only controlled by instructions files found in your codebase. To mofify them simply update the files on your repo and Baz will sync those changes automatically.

How do I enable this reviewer?

Activate the “AI Coding Guidelines” reviewer on your repo from the Baz Agents section.