# Skills & Instructions

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.

<figure><img src="/files/YY5M8ScJvIVmQ1BxoFvl" alt="AI Coding Guidelines"><figcaption></figcaption></figure>

#### 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&#x20;

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

<details>

<summary>Can I update the AI Coding Guidelines review prompts?</summary>

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.

</details>

<details>

<summary>How do I enable this reviewer?</summary>

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

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.baz.co/agents/skills-and-instructions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
