Add building with ai/skills pages and updated intro (#2962)

Closes #<issue>

## ✅ Checklist

- [ ] I have followed every step in the [contributing
guide](https://github.com/triggerdotdev/trigger.dev/blob/main/CONTRIBUTING.md)
- [ ] The PR title follows the convention.
- [ ] I ran and tested the code works

---

## Testing

_[Describe the steps you took to test this change]_

---

## Changelog

_[Short description of what has changed]_

---

## Screenshots

_[Screenshots]_

💯

<!-- devin-review-badge-begin -->

---

<a
href="https://app.devin.ai/review/triggerdotdev/trigger.dev/pull/2962">
  <picture>
<source media="(prefers-color-scheme: dark)"
srcset="https://static.devin.ai/assets/gh-open-in-devin-review-dark.svg?v=1">
<img
src="https://static.devin.ai/assets/gh-open-in-devin-review-light.svg?v=1"
alt="Open with Devin">
  </picture>
</a>
<!-- devin-review-badge-end -->

Author: D-K-P

docs/building-with-ai.mdx

@@ -0,0 +1,24 @@
+---
+title: "Overview"
+sidebarTitle: "Overview"
+description: "Tools and resources for building Trigger.dev projects with AI coding assistants."
+---
+
+We provide tools to help you build Trigger.dev projects with AI coding assistants. We recommend using them for the best developer experience.
+
+<CardGroup cols={1}>
+  <Card title="MCP Server" icon="sparkles" href="/mcp-introduction">
+    Give your AI assistant direct access to Trigger.dev tools - search docs, trigger tasks, deploy projects, and monitor runs.
+
+    ```bash
+    npx trigger.dev@latest install-mcp
+    ```
+  </Card>
+  <Card title="Skills" icon="wand-magic-sparkles" href="/skills">
+    Portable instruction sets that teach any AI coding assistant Trigger.dev best practices for writing tasks, configs, and more.
+
+    ```bash
+    npx skills add triggerdotdev/skills
+    ```
+  </Card>
+</CardGroup>

docs/docs.json

@@ -43,6 +43,17 @@
               "apikeys"
             ]
           },
+          {
+            "group": "Building with AI",
+            "pages": [
+              "building-with-ai",
+              {
+                "group": "MCP Server",
+                "pages": ["mcp-introduction", "mcp-tools", "mcp-agent-rules"]
+              },
+              "skills"
+            ]
+          },
           {
             "group": "Writing tasks",
             "pages": [
@@ -166,10 +177,6 @@
               }
             ]
           },
-          {
-            "group": "MCP Server",
-            "pages": ["mcp-introduction", "mcp-tools", "mcp-agent-rules"]
-          },
           {
             "group": "Using the Dashboard",
             "pages": ["run-tests", "troubleshooting-alerts", "replaying", "bulk-actions"]

docs/images/intro-ai.jpg

@@ -16,8 +16,8 @@ mode: "center"
   >
     Browse our wide range of guides, frameworks and example projects
   </Card>
-  <Card title="MCP Server" img="/images/intro-mcp.jpg" href="/mcp-introduction">
-    Learn how to install and configure the Trigger.dev MCP Server
+  <Card title="Building with AI" img="/images/intro-ai.jpg" href="/building-with-ai">
+    Learn how to build Trigger.dev projects using AI coding assistants
   </Card>
   <Card title="Video walkthrough" img="/images/intro-video.jpg" href="/video-walkthrough">
     Watch an end-to-end demo of Trigger.dev in 10 minutes

docs/introduction.mdx

@@ -2,7 +2,6 @@
 title: "Agent rules"
 sidebarTitle: "Agent rules"
 description: "Learn how to use the Trigger.dev agent rules with the MCP server"
-tag: "new"
 ---
 
 ## What are Trigger.dev agent rules?