docs: skill sharing scopes, required-link deletes, and computed cell limits

docs.json

@@ -401,6 +401,7 @@
                   "en/basic/admin-panel/template-admin",
                   "en/basic/admin-panel/settings",
                   "en/basic/admin-panel/ai-setting",
+                  "en/basic/admin-panel/skills",
                   "en/basic/admin-panel/automation-management",
                   "en/basic/admin-panel/table-query-ops",
                   "en/basic/admin-panel/computed-outbox",
@@ -771,6 +772,7 @@
                   "zh/basic/admin-panel/template-admin",
                   "zh/basic/admin-panel/settings",
                   "zh/basic/admin-panel/ai-setting",
+                  "zh/basic/admin-panel/skills",
                   "zh/basic/admin-panel/automation-management",
                   "zh/basic/admin-panel/table-query-ops",
                   "zh/basic/admin-panel/computed-outbox",

en/basic/admin-panel/computed-outbox.mdx

@@ -59,6 +59,8 @@ After a group recovery, Teable reports how many tasks it restored, how many were
 
 A group marked **Base deleted** belongs to a Base that no longer exists. Recovering it would fail again immediately, so **Discard group** is the only action offered.
 
+Recovery is also unavailable when the data itself caused the failure, such as a value that exceeds a size limit or breaks a field constraint. Replaying the same task would fail the same way, so discard the group and fix the source data or the field definition instead; later writes recompute those fields automatically.
+
 ## Pause Computed Tasks for a Space
 
 When one space's computed tasks are making an incident worse, pause that space in **Computed task pauses** rather than stopping the whole instance.

en/basic/admin-panel/overview.mdx

@@ -22,6 +22,7 @@ The Admin Panel groups its pages by purpose:
 
 - **[Instance settings](/en/basic/admin-panel/settings)**: Configure system-wide settings, permissions, email, and system limits
 - **[AI settings](/en/basic/admin-panel/ai-setting)**: Configure AI features and models
+- **[Skills](/en/basic/admin-panel/skills)**: Publish skills that every AI agent in the instance can use
 - **[Template admin](/en/basic/admin-panel/template-admin)**: Configure template center and custom templates
 - **[Self-hosted license](/en/deploy/activate)**: Register, update, and view the current instance license
 

en/basic/admin-panel/skills.mdx

@@ -0,0 +1,37 @@
+---
+title: "Skills"
+description: "Publish skills that every AI agent in the instance can use."
+---
+
+<Tip>Available for self-hosted Business plan and above</Tip>
+
+Path: Admin Panel → Skills
+
+Use **Skills** to publish skills for the whole instance. A skill added here is available in every AI Chat, App Builder, and bot conversation, so use it for working methods your organization should share by default, such as a house writing style, a reporting convention, or a shared integration procedure.
+
+Skills added by users elsewhere stay in their own scope. See [AI Chat](/en/basic/ai/ai-chat) for personal, base, and space skills.
+
+## Add a Skill
+
+Click **Import Skill** and choose where the skill comes from:
+
+| Source | What to provide |
+| --- | --- |
+| **GitHub URL** | The link to the skill folder in a repository, for example `https://github.com/owner/repo/tree/main/skills/my-skill` |
+| **ZIP / Skill File** | A `.zip` or `.skill` file that contains `SKILL.md` |
+
+If a skill with the same name already exists in this scope, importing replaces it.
+
+## Manage Published Skills
+
+The list groups skills by scope and shows where each one came from. Built-in skills are listed at the bottom for reference and are not editable.
+
+- Use the switch on a row to enable or disable a skill without deleting it. A disabled skill stays in the list but is not offered to agents.
+- For a skill imported from GitHub, click the refresh button to pull the latest version from its source.
+- Click a row to read its `SKILL.md`, edit its name and description, download it, replace its files, or delete it.
+
+<Info>Only instance administrators can add, change, or remove skills on this page. Every signed-in user can use the published skills in their conversations.</Info>
+
+## When a Name Is Used Twice
+
+A skill published here is the instance default. If a base, space, personal, app, or bot skill uses the same name, the narrower one is in effect for that conversation, and the instance skill is ignored there.

en/basic/ai/ai-chat.mdx

@@ -34,7 +34,8 @@ When you paste a long block of plain text, Teable converts it to a Markdown atta
 - **Intelligence**: Choose the **Intelligence** level separately in the model menu. It controls thinking depth; higher levels produce more thorough reasoning.
 - **Secrets**: Open the **+** menu and choose **Secrets** to store API keys or other credentials for AI Chat. AI Chat can read these values as environment variables. Saved values are write-only; enter a new value to update a secret.
 - **Integrations**: When AI needs access to a third-party account, it can show a card such as **Connect Slack** in the conversation. Click **Connect** to authorize with OAuth. Click **Skip** to cancel this authorization; AI continues with the parts it can complete without that connection.
-- **Skills**: Open the **+** menu and choose **Skills** to import, enable, disable, or try skills in the current chat context. Personal skills are only available to you. Current base skills are shared with collaborators in the current base. Type `/` in the input box to choose an enabled skill. To connect or migrate an external system, see [Connect & Migrate Everything](/en/basic/ai/connect-everything).
+- **Skills**: Open the **+** menu and choose **Skills** to import, enable, disable, or try skills in the current chat. When you import one, choose who can use it: **Personal** keeps it to yourself, **Base** gives it to collaborators in this base, and **Space** gives it to everyone in this space. Type `/` in the input box to choose an enabled skill. To connect or migrate an external system, see [Connect & Migrate Everything](/en/basic/ai/connect-everything).
+- **Context usage**: The ring next to the input box shows how much of the model's context window the conversation currently uses. Click it for the percentage and token counts. When the context fills up, Teable compacts the conversation; start a new chat if you want a clean context instead.
 - **Manage files**: Open **+** → **More** → **Manage files** to view files in the current chat sandbox. You can preview supported files, download files, or delete files and folders you no longer need. A conversation must exist before its files can be managed.
 - **Queued messages**: If you send another message while AI is still working, the message is queued. Queued items show the same table, view, attachment, and selection chips as the chat input. Use **Edit** to move a queued item back into the input, **Send follow-up without interrupting** to add a text follow-up to the current run when that action is available, or **Remove** to delete it from the queue. Items that cannot be sent as follow-ups stay queued until the current run finishes.
 
@@ -119,6 +120,8 @@ After uploading files, AI can answer questions using both file content and table
 
 Files uploaded to the conversation and files generated during the conversation are saved in the current chat sandbox. Use **Manage files** to inspect them later.
 
+When a reply presents several files at once, use **Download all** below the file cards to save them as one zip.
+
 ### Memory
 
 Memory stores information you explicitly ask Cuppy to remember. Memory is scoped by user and Base: each user in each Base has an independent memory context, and memory saved in another Base will not automatically appear in the current one.
@@ -209,7 +212,17 @@ For long-running or repeatable work, use the feature that matches the workflow:
   </Accordion>
 
   <Accordion title="How do I use Skills in AI Chat?">
-    Open the **+** menu and choose **Skills** to import or manage skills, or type `/` in the input box to choose an enabled skill. Use personal skills for your own chats, and current base skills when collaborators in the same base should be able to use the skill. Users who can manage the base can add current base skills. If AI Chat presents a `.skill` file, use **Install** on the file card to add it.
+    Open the **+** menu and choose **Skills** to import or manage skills, or type `/` in the input box to choose an enabled skill. Choose who can use the skill when you import it: personal for your own chats, base when collaborators in the same base need it, and space when everyone in the space does. Users who can manage the base can add base skills, and space owners and creators can add space skills. If AI Chat presents a `.skill` file, use **Install** on the file card to add it.
+  </Accordion>
+
+  <Accordion title="Which skill applies when two of them share a name?">
+    Only one version is ever in effect, and the shared team version wins over a personal copy: a base skill beats a space skill, and a space skill beats a personal one. In an app or bot conversation, the skill added for that app or bot comes first. To move everyone to a new version, update the copy in the base or space.
+  </Accordion>
+
+  <Accordion title="Which files stay in Manage files?">
+    **Manage files** holds two folders: `uploads` for the files you added, and `outputs` for the files produced in the conversation. Both use their own storage, so they survive the sandbox being released or rebuilt and you can come back later to preview, download, or delete them.
+
+    Anything Cuppy writes outside those two folders is temporary, such as intermediate results from a script. It does not appear in **Manage files** and is gone after the sandbox restarts. For results you need to keep, ask Cuppy to write them into `outputs` or back into Teable, or download them while the conversation is open, using **Download all** when a reply produced several files.
   </Accordion>
 
   <Accordion title="What happens when I copy a message with chips?">

en/basic/ai/app-builder.mdx

@@ -37,7 +37,7 @@ The command center for your app.
 - **Natural Language Editing**: Describe changes like *"Make the header blue"* or *"Add a submission form for new records"*.
 - **Auto-Routing**: The AI understands which component or page you are referring to and modifies it directly.
 - **Integrations**: When the app task needs access to a third-party account, App Builder can show a card such as **Connect Slack** in the chat panel. Click **Connect** to authorize with OAuth. Click **Skip** to cancel this authorization; AI continues with the parts it can complete without that connection.
-- **Skills**: Open the **+** menu and choose **Skills** to manage skills for this app conversation. App skills are only available to the current app. Type `/` in the input box to choose an enabled skill.
+- **Skills**: Open the **+** menu and choose **Skills** to manage skills for this app conversation. A skill added here is only available to the current app, and the skills shared with the app's base and space can be used here as well. Type `/` in the input box to choose an enabled skill.
 - **Manage files**: Open **+** → **More** → **Manage files** to view files in the app sandbox. Use it to preview supported files, download generated files, or delete files and folders you no longer need.
 - **Clear Conversation**: If the current conversation has drifted, click **Clear Chat** in the bottom-right corner of the panel to start a new session. This clears the chat history for the current conversation but does not delete the app itself. The first use shows a confirmation, and you can choose not to show it again next time.
 

en/basic/record.mdx

@@ -49,6 +49,8 @@ Select one or more records, then right-click and choose **Delete record**. For b
 
 Deleted records go to the table trash, where you can review and restore them. If you want records out of the table but still available, archive them instead of deleting. See [Archive and Trash](/en/basic/record/archive-trash).
 
+<Info>If another table links to the record through a **Required** [Link](/en/basic/field/link) field, Teable refuses the deletion and names the table and field that would be left empty. Point that link at another record, clear the **Required** setting on the field, or delete the linking records together with this one.</Info>
+
 ## Record Details
 
 <img

en/basic/view/grid.mdx

@@ -111,6 +111,12 @@ When a computed field is waiting, calculating, or has failed, click the calculat
 | **Waiting** | Fields queued for calculation |
 | **Failed** | The latest calculation error |
 
+If a calculated value grows past the size a cell can hold, the field reports `Computed cell value is too large` with the attempted and maximum size. The limit is 256 KB per computed cell. The rest of the table keeps calculating and the cell keeps its previous value, so the field recalculates on the next write once the value fits.
+
+A single piece of text or a number rarely reaches 256 KB. The limit is usually hit when a record links to many other records and a Lookup or Rollup pulls all of their long text into one cell. For example, a customer with 500 follow-up records, each holding a few hundred words of notes, exceeds the limit once every note is looked up.
+
+The fix is to keep the details out of the cell: use a Rollup to count or sum the linked records, or look up a shorter field such as a status or a number. Open the linked table when you need to read the full content.
+
 ## Notes
 
 - Hidden fields, sorting, filtering, grouping, and similar settings apply only to the current view.

zh/basic/admin-panel/computed-outbox.mdx

@@ -59,6 +59,8 @@ description: "在管理面板中监控 BullMQ 投递和计算任务积压。"
 
 标记为 **Base 已删除** 的问题组，对应的 Base 已经不存在，恢复后会立即再次失败，因此只提供 **丢弃问题组**。
 
+由数据本身导致的失败同样不提供恢复，例如值超出体积上限或违反字段约束。重放同一个任务只会再次失败，应该直接丢弃该问题组，转而修改源数据或字段定义；后续写入会自动重新计算这些字段。
+
 ## 暂停某个空间的计算任务
 
 当某个空间的计算任务正在加剧故障时，可以在 **计算任务暂停** 中单独暂停这个空间，而不必停掉整个实例。

zh/basic/admin-panel/overview.mdx

@@ -22,6 +22,7 @@ description: "Teable 私有化部署的管理员后台，用于管理实例的
 
 - **[实例设置](/zh/basic/admin-panel/settings)**：配置系统级设置、权限、邮箱和系统限制
 - **[AI 配置](/zh/basic/admin-panel/ai-setting)**：配置 AI 功能和模型
+- **[技能管理](/zh/basic/admin-panel/skills)**：发布实例内所有 AI agent 都可使用的技能
 - **[模板管理](/zh/basic/admin-panel/template-admin)**：配置模板中心和自定义模板
 - **[自托管许可证](/zh/deploy/activate)**：注册、更新和查看当前实例许可证
 

zh/basic/admin-panel/skills.mdx

@@ -0,0 +1,37 @@
+---
+title: "技能管理"
+description: "发布实例内所有 AI agent 都可使用的技能。"
+---
+
+<Tip>私有化部署商业版及以上适用</Tip>
+
+路径：管理面板 → 技能管理
+
+通过 **技能管理**，可以为整个实例发布技能。在这里添加的技能，会出现在所有 AI 对话、App Builder 和 Bot 会话中，适合放置组织内需要统一遵循的做法，例如统一的写作风格、报表口径或对接流程。
+
+用户在其他位置添加的技能仍然只在各自作用域内生效。个人、数据库和空间技能请参阅 [AI 对话](/zh/basic/ai/ai-chat)。
+
+## 添加技能
+
+点击 **导入技能**，选择技能来源：
+
+| 来源 | 需要提供的内容 |
+| --- | --- |
+| **GitHub URL** | 仓库中技能目录的链接，例如 `https://github.com/owner/repo/tree/main/skills/my-skill` |
+| **ZIP / Skill 文件** | 包含 `SKILL.md` 的 `.zip` 或 `.skill` 文件 |
+
+如果当前作用域中已存在同名技能，导入会覆盖原有技能。
+
+## 管理已发布的技能
+
+列表按作用域分组，并标注每个技能的来源。内置技能列在最下方，仅供参考，不可编辑。
+
+- 用行末的开关启用或停用技能，不必删除。停用后技能仍留在列表中，但不会提供给 agent 使用。
+- 从 GitHub 导入的技能，可以点击刷新按钮从来源同步最新版本。
+- 点击某一行可以查看 `SKILL.md`，修改名称和描述，下载、替换文件或删除该技能。
+
+<Info>只有实例管理员可以在此页面添加、修改或删除技能。已发布的技能对所有已登录用户可用。</Info>
+
+## 出现同名技能时
+
+在这里发布的技能是实例默认值。如果数据库、空间、个人、App 或 Bot 中存在同名技能，则在对应会话中以范围更小的技能为准，实例技能不再生效。