Commit adb1f9b1e3 for woocommerce

commit adb1f9b1e3c6f272d226e506f6ab33014393bc3f
Author: Brian Coords <bacoords@gmail.com>
Date:   Wed Feb 11 11:42:44 2026 -0800

    Docs: Updated AI resources (#63176)

    * adds note about serving docs as markdown

    * updates language around skills and rules

    * adds missing newline for markdownlint

    * fixes grammar

diff --git a/docs/getting-started/ai.md b/docs/getting-started/ai.md
index 99da3a7432..b11454ba40 100644
--- a/docs/getting-started/ai.md
+++ b/docs/getting-started/ai.md
@@ -25,22 +25,34 @@ If you are using an IDE like Cursor or Windsurf, we recommend adding these links

 **Note** that these do not include the contents of the [WC REST API documentation](https://woocommerce.github.io/woocommerce-rest-api-docs/#introduction) or the [WooCommerce Code Reference](https://woocommerce.github.io/code-reference/).

+### Serve as Markdown
+
+If you want to view the documentation as Markdown files, you can use append `.md` to the end of any documentation URL. For example, to view this page as Markdown, you can visit:
+
+```plain
+https://developer.woocommerce.com/docs/getting-started/ai.md
+```
+
 ### Copy to Markdown

-On every page of the Developer Docs, you'll see a Clipboard icon in the upper-right hand corner. Selecting this icon will copy the current doc in Markdown formatting, which you can paste into your LLM's chat interface.
+On every page of the Developer Docs, you'll see a Clipboard icon in the upper-right-hand corner. Selecting this icon will copy the current doc in Markdown formatting, which you can paste into your LLM's chat interface.

 ## AI Development Tools

-### Cursor Rules files for contributors
+### Agent Skills for Contributors

-The `.cursor/rules/` directory contains configuration files that provide AI assistants with specific guidance for working with the WooCommerce codebase. These files help ensure consistent development practices and workflows:
+The WooCommerce monorepo includes agent skills that provide AI assistants with procedural guidance for common development tasks. These skills are located in the `.ai/skills/` directory at the root of the repository.

--   **`generate-pr-description.mdc`** - Provides guidelines for creating pull request descriptions using the repository's PR template. It ensures proper markdown structure, changelog formatting, and automation compatibility.
+Each skill contains a `SKILL.md` file with step-by-step instructions for tasks like:

--   **`git.mdc`** - Defines branching conventions and commit message standards for the WooCommerce repository, including naming patterns for different types of changes (fixes, features, refactors, etc.).
+- Backend PHP development and testing conventions
+- Code review standards and best practices
+- Git workflows and commit conventions
+- Build and linting processes
+- UI copy and documentation guidelines

--   **`woo-build.mdc`** - Contains instructions for building the WooCommerce plugin, including dependency installation commands and development build processes using pnpm and nvm.
+Skills are designed to be tool-agnostic and can be used with various AI coding assistants. To explore available skills, browse the [`.ai/skills/` directory](https://github.com/woocommerce/woocommerce/tree/trunk/.ai/skills) in the repository.

--   **`woo-phpunit.mdc`** - Provides guidance for running PHPUnit tests in the WooCommerce codebase, including the specific command structure and directory requirements.
+### Cursor Rules files for contributors

-These rules files help AI assistants understand the project's development workflow and maintain consistency with WooCommerce's coding standards and practices.
+The `.cursor/rules/` directory contains configuration files that provide AI assistants with specific guidance for working with the WooCommerce codebase. These files help ensure consistent development practices and workflows.