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.

AI Coding 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.

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.

FAQ

chevron-rightCan I update the AI Coding Guidelines review prompts?hashtag

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.

chevron-rightHow do I enable this reviewer?hashtag

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

Last updated