Add building with ai/skills pages and updated intro

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">
+    Install pre-built prompts that teach AI assistants 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/introduction.mdx

@@ -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/skills.mdx

@@ -0,0 +1,79 @@
+---
+title: "Skills"
+description: "Install Trigger.dev skills to teach any AI coding assistant best practices for writing tasks, agents, and workflows."
+---
+
+## What are agent skills?
+
+Skills are portable instruction sets that teach AI coding assistants how to use Trigger.dev effectively. Unlike vendor-specific config files (`.cursor/rules`, `CLAUDE.md`), skills use an open standard that works across all major AI assistants. For example, Cursor users and Claude Code users can get the same knowledge from a single install. 
+
+Skills install as `SKILL.md` files that AI assistants automatically discover and follow. Each skill contains YAML frontmatter (name, description) and markdown instructions with patterns, examples, and best practices.
+
+## Installation
+
+When you run `npx skills add triggerdotdev/skills`, the CLI detects your installed AI tools and copies the appropriate files to each tool's expected location. For example, `.claude/skills/`, `.cursor/skills/`, `.github/skills/`, etc.
+
+```bash
+npx skills add triggerdotdev/skills
+```
+
+<Note>`skills` is an open-source CLI by Vercel. Learn more at [skills.sh](https://skills.sh).</Note>
+
+The result: your AI assistant understands Trigger.dev's specific patterns for exports, schema validation, error handling, retries, and more.
+
+## Supported AI assistants
+
+Skills work with any AI coding assistant that supports the [Agent Skills standard](https://agentskills.io), including:
+
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code)
+- [Cursor](https://cursor.com)
+- [Windsurf](https://codeium.com/windsurf)
+- [GitHub Copilot](https://github.com/features/copilot)
+- [Cline](https://github.com/cline/cline)
+- [Codex CLI](https://github.com/openai/codex)
+- [Gemini CLI](https://github.com/google-gemini/gemini-cli)
+- [OpenCode](https://opencode.ai)
+- [View all →](https://skills.sh/docs/supported-agents)
+
+## Available skills
+
+Install all skills at once, or pick the ones relevant to your current work:
+
+```bash
+# Install all Trigger.dev skills
+npx skills add triggerdotdev/skills
+
+# Or install individual skills
+npx skills add triggerdotdev/skills --skill trigger-tasks
+npx skills add triggerdotdev/skills --skill trigger-agents
+npx skills add triggerdotdev/skills --skill trigger-config
+npx skills add triggerdotdev/skills --skill trigger-realtime
+npx skills add triggerdotdev/skills --skill trigger-setup
+```
+
+| Skill | Use for | Covers |
+|-------|---------|--------|
+| `trigger-setup` | First time setup, new projects | SDK install, `npx trigger init`, project structure |
+| `trigger-tasks` | Writing background tasks, async workflows, scheduled tasks | Triggering, waits, queues, retries, cron, metadata |
+| `trigger-agents` | LLM workflows, orchestration, multi-step AI agents | Prompt chaining, routing, parallelization, human-in-the-loop |
+| `trigger-realtime` | Live updates, progress indicators, streaming | React hooks, progress bars, streaming AI responses |
+| `trigger-config` | Project setup, build configuration | `trigger.config.ts`, extensions (Prisma, FFmpeg, Playwright) |
+
+Not sure which skill to install? Install `trigger-tasks`; it covers the most common patterns for writing Trigger.dev tasks.
+
+## Next steps
+
+<CardGroup cols={2}>
+  <Card title="MCP Server" icon="sparkles" href="/mcp-introduction">
+    Give your AI assistant direct access to Trigger.dev tools and APIs.
+  </Card>
+  <Card title="Writing tasks" icon="code" href="/tasks/overview">
+    Learn the task patterns that skills teach your AI assistant.
+  </Card>
+  <Card title="Building AI agents" icon="brain" href="/guides/ai-agents/overview">
+    Build durable AI workflows with prompt chaining and human-in-the-loop.
+  </Card>
+  <Card title="skills.sh" icon="box" href="https://skills.sh">
+    Browse the full Agent Skills ecosystem.
+  </Card>
+</CardGroup>