feat: one skill (#4592)

Author: 2heal1

apps/website-new/docs/en/_nav.json

@@ -1,4 +1,9 @@
 [
+  {
+    "text": "AI",
+    "link": "/ai/",
+    "activeMatch": "/ai/"
+  },
   {
     "text": "Guide",
     "link": "/guide/start/",

apps/website-new/docs/en/ai/index.mdx

@@ -0,0 +1,90 @@
+---
+pageType: doc-wide
+sidebar: false
+---
+
+# AI Quick Start
+
+:::tip Prefer to read the docs yourself?
+If you want to go through Module Federation concepts, configuration, and integration in order, head to the [Getting Started guide](../guide/start/index).
+:::
+
+## A Better Way To Start
+
+If you are already using an AI coding tool, the better starting point is not to read all of the docs yourself first.
+
+The faster approach is: **give the latest Module Federation docs to your agent first, then let it answer questions, debug problems, update config, and write code.**
+
+Many models still have incomplete or outdated knowledge of Module Federation 2.0. So the point of this page is not to make you study first. It is to help your agent get the right source material first.
+
+## Recommended Setup
+
+If you use Claude Code, Cursor, Windsurf, or another editor with Skills support, install:
+
+```bash
+npx skills add module-federation/core --skill mf -y
+```
+
+Then ask the agent to read the docs before answering:
+
+```text
+/mf docs What's the difference between singleton and requiredVersion in shared?
+```
+
+The idea is simple:
+
+- you do not need to hunt through the docs first
+- your agent reads the latest docs before it answers
+- the result is much more likely to be accurate
+
+## If You Want Your Agent To Do More
+
+The `mf` skill does more than answer questions. It can also help your agent:
+
+- add Module Federation to an existing project
+- inspect config problems
+- analyze type issues
+- check shared dependency conflicts
+- inspect remote module information
+
+👉 [View Agent Skills documentation](./skill)
+
+## You Can Still Use This Without Installing Anything
+
+If you just want a lightweight version first, send this directly to your agent:
+
+```text
+Before answering, please read https://module-federation.io/llms.txt to learn about the latest Module Federation 2.0 documentation, then answer my question.
+```
+
+This is the easiest way to stop the model from guessing when you have not installed the skill yet.
+
+## Docs You Can Hand To Your Agent
+
+### llms.txt
+
+[module-federation.io](https://module-federation.io) supports the [llms.txt](https://llmstxt.org) standard, which is a good entry point for AI systems:
+
+```text
+https://module-federation.io/llms.txt
+```
+
+### Markdown Docs
+
+Every page on the docs site is also available in Markdown. Replace `.html` at the end of a docs URL with `.md`:
+
+```text
+# HTML version
+https://module-federation.io/guide/basic/runtime.html
+
+# Markdown version
+https://module-federation.io/guide/basic/runtime.md
+```
+
+## Next
+
+If you want to start using this workflow right away:
+
+1. Install `mf`
+2. Ask the question you care about most
+3. Open [Skills documentation](./skill) to see which sub-commands it supports

apps/website-new/docs/en/ai/skill.mdx

@@ -0,0 +1,107 @@
+---
+pageType: doc-wide
+sidebar: false
+---
+
+# Skills
+
+Module Federation now exposes one unified **`mf` skill**.
+
+You do not need to pick from a long list of separate skills, and you do not need to read the docs first and then translate them back to your agent. The simpler approach is to install this one skill and let the agent decide whether it should read docs, inspect config, or troubleshoot a problem.
+
+If you have not read it yet, start with [AI Quick Start](./index).
+
+## Installation
+
+```bash
+npx skills add module-federation/core --skill mf -y
+```
+
+After that, the main entry is:
+
+```text
+/mf <sub-command or question>
+```
+
+If you cannot use the CLI, you can also copy the directory manually from GitHub:
+
+```text
+https://github.com/module-federation/core/tree/main/skills/mf
+```
+
+## How to use it
+
+`mf` has one entry point, but it contains multiple capabilities. You can either provide an explicit sub-command or just ask in plain language.
+
+With explicit sub-commands:
+
+```text
+/mf docs How do I use Module Federation in Modern.js?
+/mf integrate
+/mf type-check
+/mf runtime-error RUNTIME-008
+```
+
+With natural language:
+
+```text
+/mf What's the difference between singleton and requiredVersion in shared?
+/mf Help me figure out why this project is not pulling remote types
+/mf Add Module Federation to the current project
+```
+
+## What `mf` supports
+
+| Sub-command | Use it for |
+|---|---|
+| `docs` | Read the latest docs first, then answer configuration, API, and concept questions |
+| `context` | Inspect the current project's MF configuration |
+| `module-info` | Inspect remote module URLs, exposed modules, and related metadata |
+| `integrate` | Add Module Federation to an existing project |
+| `type-check` | Troubleshoot type-related issues |
+| `shared-deps` | Troubleshoot shared dependency conflicts and duplicate bundling |
+| `perf` | Troubleshoot slow local development and slow HMR |
+| `config-check` | Troubleshoot config mistakes, missing files, and plugin mismatches |
+| `bridge-check` | Troubleshoot Bridge integration issues |
+| `runtime-error` | Troubleshoot explicit runtime error codes, especially `RUNTIME-001` and `RUNTIME-008` |
+
+## The most common workflows
+
+### 1. Read the docs before answering
+
+This is the most common use case, and the best place to start:
+
+```text
+/mf docs What's the difference between singleton and requiredVersion in shared?
+```
+
+That makes the agent read the latest docs first instead of guessing from outdated memory.
+
+### 2. Let the agent integrate it for you
+
+If you want to add Module Federation to an existing project:
+
+```text
+/mf integrate
+```
+
+The agent will inspect your current project and decide what to do next.
+
+### 3. Let the agent troubleshoot directly
+
+If you already have a concrete problem:
+
+```text
+/mf type-check
+/mf shared-deps
+/mf config-check
+/mf runtime-error RUNTIME-008
+```
+
+At that point, the goal is not for you to manually investigate first. The goal is to let the agent start diagnosing immediately.
+
+## The one thing you really need to remember
+
+You do not need to read the docs first and then tell the agent what to do.
+
+Install `mf`, then let the agent read, inspect, decide, and act.

apps/website-new/docs/en/guide/start/_meta.json

@@ -1 +1 @@
-["index", "setting-up-env", "quick-start", "features", "glossary", "npm-packages","ai"]
+["index", "setting-up-env", "quick-start", "features", "glossary", "npm-packages"]