docs: streamline markdown access page

Rephrase skills tip, simplify copy-as-markdown description,
and remove verbose AI assistant usage examples.

Author: stefanjudis

ai/markdown-access.mdx

@@ -6,6 +6,10 @@ sidebarTitle: 'Markdown Access'
 
 Every page in the Checkly documentation is available as markdown. This makes it easy to feed specific documentation pages into AI assistants like Claude, ChatGPT, Cursor, or any other AI tool.
 
+<Tip>
+Use [Checkly Skills](/ai/skills) to automatically provide your agent with up-to-date, agent-optimized documentation.
+</Tip>
+
 ## .md endpoints
 
 Append `.md` to any documentation URL to get the markdown version of that page.
@@ -41,18 +45,10 @@ Modern coding agents set [these headers automatically when querying documentatio
 
 ## Copy as Markdown button
 
-Every documentation page includes a **Copy as Markdown** button at the top of the page sidebar. Click it to copy the full page content as markdown to your clipboard.
+Every documentation page includes a **Copy as Markdown** button at the top of the page. Click it to copy the full page content as markdown to your clipboard.
 
 This is the fastest way to grab documentation for a specific topic and paste it into your AI assistant's context.
 
-## Feeding documentation to AI assistants
-
-Here are some patterns for using Checkly documentation with AI tools:
-
-### Single page context
-
-When you need help with a specific feature, copy that page's markdown and include it in your prompt:
-
 ```text
 Here is the Checkly Browser Checks documentation:
 
@@ -61,25 +57,6 @@ Here is the Checkly Browser Checks documentation:
 Based on this, how do I set up a browser check with a custom user agent?
 ```
 
-### Multiple page context
-
-For complex tasks, combine multiple relevant pages:
-
-```text
-I need to set up monitoring for my API. Here is the relevant documentation:
-
-## API Checks
-[paste api-checks.md]
-
-## Alerting
-[paste alerting.md]
-
-Help me set this up step by step.
-```
-
-### Built-in agent documentation
-
-The [`checkly skills` command](/cli/checkly-skills) provides documentation optimized for your agent. Use it with [the Checkly Skills](/ai/skills) to see the best results.
 
 ## Additional resources