Expand MatrixAgentSkills docs entry points

Author: 54895y

docs/intro.md

@@ -6,6 +6,7 @@ title: 插件 Wiki
 
 当前已经收录：
 
+- [MatrixAgentSkills](/docs/matrix-agent-skills/overview)
 - [MatrixAuth](/docs/matrixauth/overview)
 - [MatrixCook](/docs/matrixcook/overview)
 - [MatrixShop](/docs/matrixshop)
@@ -26,3 +27,8 @@ title: 插件 Wiki
 3. 配置结构
 4. 命令与权限
 5. 常见问题
+
+如果你想直接把 Matrix 系列配置能力交给 agent，也可以先看：
+
+- [MatrixAgentSkills 总览](/docs/matrix-agent-skills/overview)
+- [直接发给 Agent 的示例](/docs/matrix-agent-skills/direct-link-examples)

docs/matrix-agent-skills/direct-link-examples.mdx

@@ -0,0 +1,86 @@
+---
+title: 直接发给 Agent 的示例
+description: 如何把 MatrixAgentSkills 的 GitHub 链接或 raw 链接直接发给常见 agent。
+---
+
+# 直接发给 Agent 的示例
+
+这一页只解决一个问题：
+
+怎么把 `MatrixAgentSkills` 的链接直接发给 agent，让它立刻开始工作。
+
+## Codex / OpenAI Skills
+
+如果 agent 支持原生 skill 安装，直接发这个：
+
+```text
+Install and use this MatrixShop config skill:
+https://github.com/54895y/MatrixAgentSkills/tree/main/matrixshop-config
+```
+
+如果你想带上任务目标，一起发：
+
+```text
+Install and use this MatrixShop config skill:
+https://github.com/54895y/MatrixAgentSkills/tree/main/matrixshop-config
+
+Then generate a MatrixShop config pack for a survival server with:
+- vault as default currency
+- one SystemShop weapon category
+- one GlobalMarket entry
+- ChestShop enabled
+```
+
+## Claude / Gemini / Cline / Roo / Continue
+
+这类 agent 更适合直接吃 raw prompt。
+
+直接发这个：
+
+```text
+Use this MatrixShop config prompt pack:
+https://raw.githubusercontent.com/54895y/MatrixAgentSkills/main/portable/matrixshop-config.md
+```
+
+如果你想连需求一起发：
+
+```text
+Use this MatrixShop config prompt pack:
+https://raw.githubusercontent.com/54895y/MatrixAgentSkills/main/portable/matrixshop-config.md
+
+Generate:
+- module.yml
+- Economy/currency.yml
+- SystemShop/settings.yml
+- SystemShop/shops/weapon.yml
+```
+
+## AIChat
+
+AIChat 不建议直接投 skill，建议导入知识库。
+
+知识库链接：
+
+- [matrixshop-config-kb.md](https://raw.githubusercontent.com/54895y/MatrixAgentSkills/main/aichat/matrixshop-config-kb.md)
+
+导入后，直接问：
+
+```text
+根据我的生存服需求生成 MatrixShop 配置：
+- 默认使用 vault
+- Auction 使用点券
+- PlayerShop 开启
+- Cart 和 Record 使用默认结构
+```
+
+## 推荐做法
+
+如果你只是想让 agent 快速开始，不要解释太多背景。
+
+最有效的做法是：
+
+1. 发链接
+2. 发目标文件清单
+3. 发你的服设要求
+
+这样 agent 最容易直接产出可落地 YAML。

docs/matrix-agent-skills/overview.mdx

@@ -53,5 +53,6 @@ description: Matrix 系列插件的公开 skill、prompt pack 与知识库仓库
 ## 推荐阅读
 
 1. [按 Agent 安装](./install-by-agent)
-2. [MatrixShop Config Skill](./matrixshop-config)
-3. [AIChat 知识库入口](./aichat-knowledge-base)
+2. [直接发给 Agent 的示例](./direct-link-examples)
+3. [MatrixShop Config Skill](./matrixshop-config)
+4. [AIChat 知识库入口](./aichat-knowledge-base)

docs/plugins.mdx

@@ -22,6 +22,10 @@ MatrixAgentSkills 是 Matrix 系列插件的公开 skill、prompt pack 与知识
 
 [进入 MatrixAgentSkills 文档](/docs/matrix-agent-skills/overview)
 
+如果你只是想直接复制一段提示发给 agent，请看：
+
+- [直接发给 Agent 的示例](/docs/matrix-agent-skills/direct-link-examples)
+
 ## MatrixAuth
 
 MatrixAuth 是混合登录与账号档案管理插件，围绕 `PREMIUM`、`OFFLINE`、`BEDROCK` 三种身份模式工作，支持：

sidebars.ts

@@ -13,6 +13,7 @@ const sidebars: SidebarsConfig = {
       },
       items: [
         'matrix-agent-skills/install-by-agent',
+        'matrix-agent-skills/direct-link-examples',
         'matrix-agent-skills/matrixshop-config',
         'matrix-agent-skills/aichat-knowledge-base',
       ],