diff --git a/docs.json b/docs.json
index 9e944edcf..f45acf01c 100644
--- a/docs.json
+++ b/docs.json
@@ -828,6 +828,7 @@
                         ],
                         "expanded": false
                       },
+                      "en/self-host/use-dify/build/skills",
                       {
                         "group": "Basic Apps",
                         "pages": [
@@ -2220,6 +2221,7 @@
                         ],
                         "expanded": false
                       },
+                      "zh/self-host/use-dify/build/skills",
                       {
                         "group": "基础应用",
                         "pages": [
@@ -3612,6 +3614,7 @@
                         ],
                         "expanded": false
                       },
+                      "ja/self-host/use-dify/build/skills",
                       {
                         "group": "基本アプリ",
                         "pages": [
diff --git a/en/self-host/deploy/configuration/environments.mdx b/en/self-host/deploy/configuration/environments.mdx
index b2b25939d..722b78f59 100644
--- a/en/self-host/deploy/configuration/environments.mdx
+++ b/en/self-host/deploy/configuration/environments.mdx
@@ -1399,6 +1399,14 @@ Shows the New Agent in the web UI: the **Agents** item in the main navigation an
 
 Set to `false` to hide it and fall back to the classic Agent node. Replaces `ENABLE_AGENT_V2`, which still works as a fallback.
 
+### UPLOAD_SKILL_FILE_SIZE_LIMIT
+
+Default: `50`
+
+Maximum size in MB for a skill package (`.zip` or `.skill`), whether uploaded to an agent as an embedded skill or imported into the skill library. Larger packages are rejected with a size error.
+
+A skill's unpacked content is separately capped at 200 MB and 5000 files. For library imports, folders also count toward the 5000 limit. This variable doesn't change either limit. If you raise it above 100, also raise `NGINX_CLIENT_MAX_BODY_SIZE` to match; otherwise Nginx rejects the upload with a 413 error.
+
 ### AGENT_BACKEND_BASE_URL
 
 Default: `http://agent_backend:5050`
diff --git a/en/self-host/use-dify/build/new-agent/build.mdx b/en/self-host/use-dify/build/new-agent/build.mdx
index 5bce3ebd2..75ab600e1 100644
--- a/en/self-host/use-dify/build/new-agent/build.mdx
+++ b/en/self-host/use-dify/build/new-agent/build.mdx
@@ -49,21 +49,27 @@ A few things worth covering:
 - **Tool and file use**: when to reach for each, named explicitly.
 - **Output**: the format, length, or tone you want back.
 
-You can point the agent at a specific skill, file, tool, or knowledge source, or leave the choice to the agent:
+You can point the agent at a specific skill, file, tool, or knowledge base, or leave the choice to the agent:
 
 - **Reference it in the prompt** with `/` to send the agent straight to it, right where you want it used. Best when a step depends on a specific one.
-
 - **Just add it to its section** and let the agent decide on its own when to use it. Best when you'd rather trust the agent's judgment than script every move.
 
 ### Skills
 
-A *skill* is a self-contained procedure you package for the agent: instructions, reference materials, and any scripts for one specialized task, bundled together so you define it once and reuse it.
+A skill is a procedure the agent follows for one specific task. Unlike the prompt, which sets the agent's overall role, a skill covers just that task.
+
+For example, a support agent's prompt might set its role as a customer helper that handles any issue, while its `refund-requests` skill covers only refunds: look up the order, refund only within 30 days, and end with a help-center link.
+
+Click **Add** and choose where the skill comes from:
 
-Where the prompt sets the agent's overall role, a skill is a job aid it pulls in only when a particular task calls for it—an SOP you hand a capable hire. The agent brings the general ability; the skill gives it your exact steps, materials, and tools for that job, so the work comes out the way you expect.
+- Choose **Add from library** to add a [*library skill*](/en/self-host/use-dify/build/skills) shared workspace-wide. You can add up to 20 library skills to an agent, and it follows the latest published version of each.
+- Choose **Upload skill.zip** to add a `.zip` or `.skill` package as an *embedded skill*, one the agent keeps to itself. The package can be up to 50 MB by default; you can change this limit with the [`UPLOAD_SKILL_FILE_SIZE_LIMIT`](/en/self-host/deploy/configuration/environments#upload_skill_file_size_limit) environment variable. To share it with other agents, [make it a library skill](/en/self-host/use-dify/build/skills#import-a-skill).
 
-For instance, a `marketing-copy` skill might bundle your style guide, brand assets, and a checklist, so you don't re-explain them every time.
+You can also have the agent create embedded skills for you in [Build mode](#build-by-chatting).
 
-A skill package needs to be a `.zip` or `.skill` file no larger than 50 MB, with a `SKILL.md` inside. To learn more about the format and how to build one, see [Agent Skills](https://agentskills.io/home). You can also have the agent create skills for you in [Build mode](#build-by-chatting).
+<Note>
+To use a Dify tool, file, or knowledge base, add it directly to the agent rather than referencing it in a skill.
+</Note>
 
 ### Files
 
diff --git a/en/self-host/use-dify/build/skills.mdx b/en/self-host/use-dify/build/skills.mdx
new file mode 100644
index 000000000..289e45f7f
--- /dev/null
+++ b/en/self-host/use-dify/build/skills.mdx
@@ -0,0 +1,79 @@
+---
+title: Skills
+sidebarTitle: Skills
+description: Package a task and its supporting files into a reusable skill, then share it workspace-wide
+---
+
+A *skill* is a self-contained package you build once and reuse. It includes a `SKILL.md` that holds the instructions for one task and tells the agent when to use it, plus any reference materials and scripts the task needs. For the full format, see [Agent Skills](https://agentskills.io/home).
+
+You can keep up to 500 skills in the library and share them workspace-wide. When you publish an update to a skill, every agent that uses it picks up the latest version.
+
+Use a skill in:
+
+- a [New Agent](/en/self-host/use-dify/build/new-agent/build#skills) app
+- a [New Agent node](/en/self-host/use-dify/nodes/agent) in a [Workflow app](/en/self-host/use-dify/build/workflow-chatflow)
+
+Create, import, and manage your library skills on the **Skills** page.
+
+<Info>
+Creating and managing skills requires the Editor role or above.
+</Info>
+
+## Create a Skill
+
+From **Skills**, click **Create**. To start from a copy instead, choose **Duplicate** from an existing skill's **⋯** menu; published skills are copied without draft changes. Either way you land in the editor, where you write the skill yourself or draft it with the [Skill Builder](#draft-with-the-skill-builder).
+
+In the body of `SKILL.md`, lay out the procedure for the agent to follow. In the frontmatter, set:
+
+- **Display name**: the name shown at the top of the sidebar and anywhere the skill appears. Make it easy to recognize.
+- **Name**: the unique name agents use to reference the skill, like `refund-requests`.
+- **Description**: what the agent reads to decide whether to use the skill. Make it specific.
+- **Metadata**: custom fields for your own reference details, like `owner: payments-team` or `source: https://wiki.example.com/refund-policy`.
+
+Add any scripts, references, and other supporting files through the file tree. What you can do with each depends on its type:
+
+- **Text and code** (Markdown, scripts, JSON, YAML, CSV, and the like): edit in place.
+- **Images and PDFs**: preview in place.
+- **Other files**: download to view.
+
+### Draft with the Skill Builder
+
+Chat with the Skill Builder and it drafts the skill for you. Describe the scenario or attach existing process docs, and it writes the `SKILL.md` and creates supporting files to review and refine.
+
+It accepts the following file types:
+
+| Type | Examples |
+|:-----|:---------|
+| PDF | `.pdf` |
+| Word | `.doc`, `.docx` |
+| Excel | `.xls`, `.xlsx` |
+| PowerPoint | `.ppt`, `.pptx` |
+| RTF | `.rtf` |
+| Image | `.png`, `.jpg`, `.jpeg`, `.gif`, `.webp`, `.svg` |
+| Text and data | `.txt`, `.md`, `.csv`, `.json`, `.yaml` |
+
+Attach up to 10 files per message: images up to 10 MB and other files up to 15 MB. They are context for the Skill Builder, not part of the skill. To include a file, add it through the file tree.
+
+## Import a Skill
+
+To bring in a skill built elsewhere as a library skill, click **Import** and choose a `.zip` or `.skill` package that contains a `SKILL.md` file. The package can be up to 50 MB by default; you can change this limit with the [`UPLOAD_SKILL_FILE_SIZE_LIMIT`](/en/self-host/deploy/configuration/environments#upload_skill_file_size_limit) environment variable. Once imported, it arrives as a draft for you to review and publish.
+
+## Tag a Skill
+
+Add tags to a skill on its card or in the editor, then filter skills by tags.
+
+## Publish and Versions
+
+Your edits autosave as a draft. Publish the draft so you can add it to agents. Each publish is saved as a version you can revisit or restore later. To record what a version changed, give it a title and note with **Edit version info** in its **⋯** menu.
+
+<Note>
+Restoring a version replaces your current draft. Publish the draft to make it the newest version.
+</Note>
+
+## Export a Skill
+
+To take a skill beyond this workspace, choose **Export** from the **⋯** menu on its card. You get the skill's latest published version as a `.zip`.
+
+## Delete a Skill
+
+Deleting a skill removes it from the workspace and from every agent that uses it, along with all of its versions. A deleted skill can't be recovered; export a copy first if you may need it again.
diff --git a/ja/self-host/deploy/configuration/environments.mdx b/ja/self-host/deploy/configuration/environments.mdx
index 2c7cabff6..d9eb14deb 100644
--- a/ja/self-host/deploy/configuration/environments.mdx
+++ b/ja/self-host/deploy/configuration/environments.mdx
@@ -1391,6 +1391,14 @@ Dify API が Agent バックエンドの実行 API を呼び出す際に提示
 
 新しい Agent を Web UI に表示します。メインナビゲーションの **Agents** 項目と、ワークフローのノード一覧の新しい Agent ノードです。`false` にすると非表示になり、クラシック Agent ノードにフォールバックします。`ENABLE_AGENT_V2` を置き換えるもので、こちらは引き続きフォールバックとして機能します。
 
+### UPLOAD_SKILL_FILE_SIZE_LIMIT
+
+デフォルト値：`50`
+
+スキルパッケージ（`.zip` または `.skill`）の最大サイズを MB 単位で指定します。Agent に埋め込みスキルとしてアップロードする場合と、スキルライブラリへインポートする場合の両方に適用されます。上限を超えるパッケージはサイズエラーで拒否されます。
+
+展開後の内容には、200 MB と 5000 ファイルという別の上限があります。スキルライブラリへインポートする場合、フォルダーも 5000 件の上限に含まれます。この環境変数では、どちらの上限も変更できません。100 より大きくする場合は、`NGINX_CLIENT_MAX_BODY_SIZE` も同じ値以上に設定してください。設定しないと、Nginx が 413 エラーでアップロードを拒否します。
+
 ### AGENT_BACKEND_BASE_URL
 
 デフォルト値：`http://agent_backend:5050`
@@ -1493,7 +1501,7 @@ HTTPS を有効化した後、 [共通変数](#共通変数) の URL 変数（
 
 | 変数 | デフォルト値 | 説明 |
 |---|---|---|
-| `COMPOSE_PROFILES` | `${VECTOR_STORE:-weaviate},${DB_TYPE:-postgresql},collaboration` | 起動するサービスコンテナを選択します。デフォルトでは、対応するベクトルストアとデータベース（`DB_TYPE=mysql` を設定すれば PostgreSQL の代わりに MySQL が起動）、および専用の `api_websocket` コンテナを起動する `collaboration` プロファイルが含まれます。`collaboration` を削除すると、独立した WebSocket サービスを起動しません。 |
+| `COMPOSE_PROFILES` | `${VECTOR_STORE:-weaviate},${DB_TYPE:-postgresql},collaboration` | 起動するサービスコンテナを選びます。デフォルトでは、ベクトルストア、データベース、`collaboration` プロファイルを起動します。`DB_TYPE=mysql` なら MySQL を使います。`collaboration` を削除すると、`api_websocket` コンテナを起動しません。 |
 | `EXPOSE_NGINX_PORT` | `80` | Nginx HTTP にマッピングされるホストポート。 |
 | `EXPOSE_NGINX_SSL_PORT` | `443` | Nginx HTTPS にマッピングされるホストポート。 |
 
@@ -1821,4 +1829,4 @@ API と Celery ワーカー間の Redis ベースのイベント転送です。
 | `PLUGIN_VOLCENGINE_TOS_REGION` | （空） | Volcengine TOS リージョン。 |
 
 </Accordion>
-</AccordionGroup>
\ No newline at end of file
+</AccordionGroup>
diff --git a/ja/self-host/use-dify/build/new-agent/build.mdx b/ja/self-host/use-dify/build/new-agent/build.mdx
index 162e9c51c..05e47fcef 100644
--- a/ja/self-host/use-dify/build/new-agent/build.mdx
+++ b/ja/self-host/use-dify/build/new-agent/build.mdx
@@ -51,21 +51,29 @@ Agent の出来はモデルしだいで大きく変わります。できるだ
 - **ツールとファイルの使い方**：それぞれを使う場面（名前を挙げて明示）。
 - **出力**：望む形式、長さ、トーン。
 
-特定のスキル、ファイル、ツール、ナレッジソースを Agent に指定することも、どれを使うかを Agent に任せることもできます：
+特定のスキル、ファイル、ツール、ナレッジベースを Agent に指定することも、どれを使うかを Agent に任せることもできます：
 
 - **プロンプト内で参照する**：`/` で参照を挿入すると、使ってほしいまさにその箇所で、Agent をその対象へ直接導けます。特定のステップが特定の対象に依存する場合に向いています。
-
 - **セクションに追加するだけ**：いつ使うかは Agent 自身に判断させます。一手一手を指示するより、Agent の判断を信頼したい場合に向いています。
 
 ### スキル
 
-「スキル」は、Agent 向けにパッケージ化する自己完結型の手順書です。1 つの専門タスクのための指示、参考資料、スクリプトをひとまとめにし、一度定義すれば繰り返し使えます。
+スキルは、Agent が特定のタスクで従う手順です。プロンプトが Agent の全体的なロールを定めるのに対し、スキルはそのタスクだけを扱います。
+
+たとえば、サポート担当の Agent では、プロンプトであらゆる問い合わせに対応する役割を設定できます。`refund-requests` スキルでは、返金だけを扱います。注文を確認し、30 日以内に限って返金し、最後にヘルプセンターへのリンクを案内します。
+
+**追加** をクリックし、スキルの追加元を選択します：
 
-プロンプトが Agent の全体的なロールを定めるのに対し、スキルは特定のタスクで必要になったときだけ取り出す作業手順、いわば有能な人材に渡す SOP です。Agent 側は汎用的な能力を、スキル側はその仕事専用の手順、資料、ツールを持ち寄ることで、期待どおりの成果につながります。
+- **From skill library** を選択すると、ワークスペース全体で共有する [スキルライブラリのスキル](/ja/self-host/use-dify/build/skills) を追加できます。1 つの Agent に最大 20 個追加でき、それぞれの最新公開バージョンが反映されます。
+- **Upload package** を選択すると、`.zip` または `.skill` パッケージを埋め込みスキルとして追加できます。埋め込みスキルは、その Agent だけが使用します。パッケージの上限はデフォルトで 50 MB です。
+  [`UPLOAD_SKILL_FILE_SIZE_LIMIT`][upload-skill-file-size-limit] 環境変数で変更できます。
+  ほかの Agent と共有するには、[スキルライブラリに追加](/ja/self-host/use-dify/build/skills#スキルのインポート) してください。
 
-たとえば `marketing-copy` というスキルにスタイルガイド、ブランド素材、チェックリストをまとめておけば、毎回説明し直す必要がなくなります。
+[ビルドモード](#チャットによるビルド) では、Agent に埋め込みスキルを作成させることもできます。
 
-スキルパッケージは、50 MB 以内の `.zip` または `.skill` ファイルで、`SKILL.md` が入っている必要があります。フォーマットの詳細や作成方法は、[Agent Skills](https://agentskills.io/home) を参照してください。[ビルドモード](#チャットによるビルド) で Agent にスキルを作成させることもできます。
+<Note>
+ツール、ファイル、ナレッジベースを使うには、スキル内で参照するのではなく、Agent に直接追加してください。
+</Note>
 
 ### ファイル
 
@@ -90,10 +98,10 @@ Agent の出来はモデルしだいで大きく変わります。できるだ
 
 ### ツール
 
-[Dify ツール](/ja/self-host/use-dify/workspace/tools) を持たせると、Agent はチャットの外でも行動できるようになります。ワークスペースにあるプラグイン、カスタム API、ワークフロー、MCP サーバーを利用できます。一部のツールは使用前に認証が必要です。
+[ツール](/ja/self-host/use-dify/workspace/tools) を持たせると、Agent はチャットの外でも行動できるようになります。ワークスペースにあるプラグイン、カスタム API、ワークフロー、MCP サーバーを利用できます。一部のツールは使用前に認証が必要です。
 
 <Tip>
-ここで追加する Dify ツールのほかにも、Agent は必要になれば、サンドボックス内で自らコマンドラインプログラムをインストールして実行できます。
+ここで追加するツールのほかにも、Agent は必要になれば、サンドボックス内で自らコマンドラインプログラムをインストールして実行できます。
 
 こうしたプログラムは「ツール」のリストに表示されません。また、作業ディレクトリ内のファイルと異なり、一度インストールすれば以後のタスクでも使えます。
 </Tip>
@@ -182,7 +190,7 @@ Agent は作業しながら、設定した内容を「ビルドノート」（`b
 
 - 記録をいちからやり直したい場合は、**ファイル** でノートを削除します。
 
-ビルドチャットをまたいで、このノートは Agent の記憶のような役割も果たします。たとえば、あるチャットで議事録 Agent の形式を決めておけば、後日アクションアイテムの担当者を追加するチャットは、決めた形式や方針を引き継いだ状態から始まります。
+このノートは、ビルドチャットをまたいで Agent の記憶のように機能します。たとえば、あるチャットで議事録 Agent の形式を決めたとします。後日、アクションアイテムの担当者を追加するチャットを始めると、決めた形式や方針が引き継がれます。
 
 ## 公開
 
@@ -192,7 +200,7 @@ Agent は作業しながら、設定した内容を「ビルドノート」（`b
 バージョンを復元しても、巻き戻るのは Agent の設定だけです。サンドボックス環境にはバージョン管理がなく、インストールしたツールなどの環境への変更はそのまま残ります。
 </Note>
 
-**アクセスポイント** タブでは、共有可能なリンクで Web アプリとして公開したり、自分のサイトに埋め込んだり、サービス API 経由でコードから呼び出したりできます。
+**アクセスポイント** タブでは、共有リンクを使って Web アプリとして公開できます。自分のサイトへの埋め込みや、サービス API 経由でのコードからの呼び出しもできます。
 
 <Warning>
 **データセキュリティに関する注意**
@@ -211,3 +219,5 @@ Agent の API はストリーミングにのみ対応しています。API ア
 公開後は、**ログ** で会話を、**モニタリング** で使用状況、品質、速度、コストを確認できます。
 
 Agent をワークスペース間で共有するには、DSL ファイルとしてエクスポートします。エクスポートされるファイルにスキルとファイルは含まれません。
+
+[upload-skill-file-size-limit]: /ja/self-host/deploy/configuration/environments#upload_skill_file_size_limit
diff --git a/ja/self-host/use-dify/build/skills.mdx b/ja/self-host/use-dify/build/skills.mdx
new file mode 100644
index 000000000..b36b0c9ca
--- /dev/null
+++ b/ja/self-host/use-dify/build/skills.mdx
@@ -0,0 +1,87 @@
+---
+title: Skills
+sidebarTitle: Skills
+description: 1 つのタスクと関連ファイルを再利用可能なスキルにまとめ、ワークスペース全体で共有
+---
+
+> このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、[英語版](/en/self-host/use-dify/build/skills) を参照してください。
+
+スキルは一度作成すれば繰り返し使える、自己完結型のパッケージです。`SKILL.md` には、1 つのタスクの手順と Agent がそのスキルを使うタイミングを記述します。タスクに必要な参考資料やスクリプトも含められます。完全な形式は [Agent Skills](https://agentskills.io/home) を参照してください。
+
+スキルライブラリには最大 500 個のスキルを保存し、ワークスペース全体で共有できます。スキルの更新を公開すると、そのスキルを利用するすべての Agent に最新バージョンが反映されます。
+
+スキルは次の場所で利用できます：
+
+- [新しい Agent アプリ](/ja/self-host/use-dify/build/new-agent/build#スキル)
+- [Workflow アプリ](/ja/self-host/use-dify/build/workflow-chatflow) 内の [新しい Agent ノード](/ja/self-host/use-dify/nodes/agent)
+
+**Skills** ページで、スキルライブラリのスキルを作成、インポート、管理します。
+
+<Info>
+スキルの作成と管理には、エディター以上のロールが必要です。
+</Info>
+
+## スキルの作成
+
+**Skills** で **Create** をクリックします。既存のスキルを複製して始めるには、そのスキルの **⋯** メニューから **複製** を選択します。公開済みのスキルを複製しても、ドラフトの変更は含まれません。どちらの方法でもエディターが開きます。自分で書くことも、[Skill Builder](#skill-builder-による下書き) で下書きを作ることもできます。
+
+`SKILL.md` の本文には、Agent が従う手順を書きます。frontmatter では次の項目を設定します：
+
+- **表示名**：スキルがサイドバー上部や各所に表示されるときの名前です。見分けやすい名前にします。
+- **名前**：Agent がスキルを参照するための一意の名前です。例：`refund-requests`。
+- **説明**：Agent がそのスキルを使うか判断するために読みます。具体的に記述します。
+- **メタデータ**：参考情報を記録するためのカスタムフィールドです。例：`owner: payments-team`、`source: https://wiki.example.com/refund-policy`。
+
+ファイルツリーから、スクリプト、参考資料、その他の関連ファイルを追加します。ファイルの種類によって操作が異なります：
+
+- **テキストとコード**（Markdown、スクリプト、JSON、YAML、CSV など）：その場で編集できます。
+- **画像と PDF**：その場でプレビューできます。
+- **その他のファイル**：ダウンロードして確認します。
+
+### Skill Builder による下書き
+
+Skill Builder とチャットすると、スキルの下書きを作成できます。シナリオを説明するか、既存の手順書を添付してください。Skill Builder が `SKILL.md` を記述し、確認や修正に使える関連ファイルも作成します。
+
+次のファイル形式に対応しています：
+
+| 種類 | 例 |
+|:-----|:---|
+| PDF | `.pdf` |
+| Word | `.doc`、`.docx` |
+| Excel | `.xls`、`.xlsx` |
+| PowerPoint | `.ppt`、`.pptx` |
+| RTF | `.rtf` |
+| 画像 | `.png`、`.jpg`、`.jpeg`、`.gif`、`.webp`、`.svg` |
+| テキストとデータ | `.txt`、`.md`、`.csv`、`.json`、`.yaml` |
+
+1 回のメッセージに最大 10 個のファイルを添付できます。画像は 10 MB、その他のファイルは 15 MB までです。添付ファイルは Skill Builder のコンテキストとして使われ、スキルには含まれません。スキルに含めるファイルは、ファイルツリーから追加します。
+
+## スキルのインポート
+
+ほかで作成したスキルをスキルライブラリに取り込むには、**Import** をクリックします。`SKILL.md` を含む `.zip` または `.skill` パッケージを選択してください。
+
+パッケージの上限はデフォルトで 50 MB です。
+[`UPLOAD_SKILL_FILE_SIZE_LIMIT`][upload-skill-file-size-limit] 環境変数で変更できます。
+インポートすると、確認して公開できるドラフトとして追加されます。
+
+## スキルへのタグ付け
+
+スキルのカードまたはエディターでタグを追加し、タグでスキルを絞り込みます。
+
+## 公開とバージョン
+
+編集内容はドラフトとして自動保存されます。Agent に追加するには、ドラフトを公開してください。公開するたびにバージョンが保存され、後から確認したり復元したりできます。変更内容を記録するには、**⋯** メニューの **Edit version info** でタイトルとメモを入力します。
+
+<Note>
+バージョンを復元すると、現在のドラフトが置き換わります。そのドラフトを公開すると、最新バージョンになります。
+</Note>
+
+## スキルのエクスポート
+
+ワークスペース外でスキルを使うには、カードの **⋯** メニューから **エクスポート** を選択します。最新の公開バージョンが `.zip` ファイルとして出力されます。
+
+## スキルの削除
+
+スキルを削除すると、すべてのバージョンとともにワークスペースから削除されます。そのスキルを使うすべての Agent からも削除されます。削除したスキルは復元できません。後で必要になる可能性があれば、先にコピーをエクスポートしてください。
+
+[upload-skill-file-size-limit]: /ja/self-host/deploy/configuration/environments#upload_skill_file_size_limit
diff --git a/tools/translate/termbase_i18n.md b/tools/translate/termbase_i18n.md
index c529cddba..343a5e3b9 100644
--- a/tools/translate/termbase_i18n.md
+++ b/tools/translate/termbase_i18n.md
@@ -130,6 +130,15 @@
 |:--------|:--------|:---------|
 | Max Iterations | 最大迭代次数 | 最大反復回数 |
 
+### Skills
+
+| English | Chinese | Japanese |
+|:--------|:--------|:---------|
+| skill | Skill | スキル |
+| skill library | Skill 库 | スキルライブラリ |
+| embedded skill | 内嵌 Skill | 埋め込みスキル |
+| Skill Builder | Skill Builder | Skill Builder |
+
 ### Infrastructure
 
 | English | Chinese | Japanese |
@@ -146,7 +155,6 @@
 | runtime | 运行时 | ランタイム |
 | classic runtime | 经典运行时 | クラシックランタイム |
 | sandboxed runtime | 沙盒运行时 | サンドボックスランタイム |
-| skill | 技能 | スキル |
 | file system | 文件系统 | ファイルシステム |
 
 ### Marketplace
@@ -167,17 +175,29 @@
 | Explore | 探索 | 探索 |
 | Integrations | 集成 | インテグレーション |
 | Tools | 工具 | ツール |
+| Skills | Skills | Skills |
 
 ### App Detail Tabs
 
 | English | Chinese | Japanese |
 |:--------|:--------|:---------|
 | Orchestrate | 编排 | オーケストレート |
+| Access Point | 访问点 | アクセスポイント |
 | Monitoring | 监测 | 監視 |
-| API Access | 访问 API | API アクセス |
 | Logs | 日志 | ログ |
 | Annotations | 标注 | 注釈 |
 
+### Access Point Channel Cards
+
+| English | Chinese | Japanese |
+|:--------|:--------|:---------|
+| Web App | Web 应用 | Web アプリ |
+| Backend Service API | 后端服务 API | バックエンドサービス API |
+| API Endpoint | API Endpoint | API エンドポイント |
+| API Key | API 密钥 | API キー |
+| MCP Server | MCP 服务 | MCP サーバー |
+| Trigger | 触发器 | トリガー |
+
 ### Log Page
 
 | English | Chinese | Japanese |
@@ -194,6 +214,7 @@
 | English | Chinese | Japanese |
 |:--------|:--------|:---------|
 | Documents | 文档 | ドキュメント |
+| API Access | 访问 API | API アクセス |
 | Retrieval Testing | 召回测试 | 検索テスト |
 | Settings | 设置 | 設定 |
 | Pipeline | 流水线 | パイプライン |
@@ -316,14 +337,23 @@
 | English | Chinese | Japanese |
 |:--------|:--------|:---------|
 | Publish | 发布 | 公開する |
+| Publish Update | 发布更新 | 更新を公開 |
 | Published | 已发布 | 公開済み |
 | Unpublished | 未发布 | 未公開 |
+| Not published yet | 尚未发布 | まだ公開されていません |
+| No changes | 无更改 | 変更なし |
+| Unpublished changes | 有未发布的更改 | 未公開の変更 |
+| Up to date | 已是最新 | 最新です |
+| Open web app | 打开 Web 应用 | Web アプリを開く |
 | Preview | 预览 | プレビュー |
 | Test Run | 测试运行 | テスト実行 |
-| Run App | 运行 | アプリを実行 |
 | Features | 功能 | 機能 |
 | Version History | 版本历史 | バージョン履歴 |
 | Workflow as Tool | 发布为工具 | ワークフローをツールとして公開する |
+| Needs Setup | 需要进行配置 | 設定が必要 |
+| Ready | 已就绪 | 準備完了 |
+| Update Needed | 需要更新 | 更新が必要 |
+| Reconfigure | 重新配置 | 再設定 |
 | Embed Into Site | 嵌入网站 | サイトに埋め込む |
 | Conversation Variables | 会话变量 | 会話変数 |
 | Environment Variables | 环境变量 | 環境変数 |
diff --git a/writing-guides/glossary.md b/writing-guides/glossary.md
index 8f959df50..ab1f8ba10 100644
--- a/writing-guides/glossary.md
+++ b/writing-guides/glossary.md
@@ -136,6 +136,15 @@ Terms appear in body text exactly as written in this table. Capitalize them furt
 |:--------|:--------|:---------|:------|
 | Max Iterations | 最大迭代次数 | 最大反復回数 | Limits the maximum number of reasoning loops and tool actions. The classic Agent app setting is a different string, "Maximum Iterations" (`app-debug.agent.setting.maximumIterations.name`). |
 
+### Skills
+
+| English | Chinese | Japanese | Notes |
+|:--------|:--------|:---------|:------|
+| skill | Skill | スキル | Self-contained package of instructions and supporting files for one reusable task. Chinese keeps the product term in English; do not translate it as 技能. |
+| skill library | Skill 库 | スキルライブラリ | Workspace-wide collection of shared skills. |
+| embedded skill | 内嵌 Skill | 埋め込みスキル | Descriptive docs term for a skill that belongs to one agent and does not follow updates from the skill library. Not a UI label. |
+| Skill Builder | Skill Builder | Skill Builder | Product feature and UI name; keep it in English in all languages. |
+
 ### Infrastructure
 
 | English | Chinese | Japanese | Notes |
@@ -152,7 +161,6 @@ Terms appear in body text exactly as written in this table. Capitalize them furt
 | runtime | 运行时 | ランタイム | The execution environment for workflow nodes |
 | classic runtime | 经典运行时 | クラシックランタイム | Original lightweight execution environment focused on speed and token efficiency |
 | sandboxed runtime | 沙盒运行时 | サンドボックスランタイム | Enhanced execution environment with file system access and autonomous tool installation |
-| skill | 技能 | スキル | Reusable expertise packages that eliminate repetitive prompt writing (Sandboxed runtime) |
 | file system | 文件系统 | ファイルシステム | Sandboxed file access for reading/writing during execution |
 
 ### Marketplace
@@ -175,6 +183,7 @@ Terms in this section must match the Dify product interface exactly. When these
 | Explore | 探索 | 探索 | common.menus.explore | Sidebar menu label |
 | Integrations | 集成 | インテグレーション | common.menus.plugins | Main nav label; the hub for model providers, tools, triggers, and other extensions. Renamed from "Plugins" in v1.15.0. JA main nav uses インテグレーション; docs use 統合 for consistency (see `settings.integrations`). |
 | Tools | 工具 | ツール | common.menus.tools | Sidebar menu label |
+| Skills | Skills | Skills | skill.skillManagement.title | Main navigation label for the workspace skill library; currently stays English in all locales. |
 
 ### App Detail Tabs
 
@@ -500,4 +509,3 @@ Terms in this section must match the Dify product interface exactly. When these
 | Chunking Setting | 分段模式 | チャンキングモード | dataset-documents.embedding.mode | Section heading |
 | High-quality mode | 高质量模式 | 高品質モード | dataset-documents.embedding.highQuality | |
 | Economy mode | 经济模式 | 経済モード | dataset-documents.embedding.economy | |
-
diff --git a/zh/self-host/deploy/configuration/environments.mdx b/zh/self-host/deploy/configuration/environments.mdx
index 2066ecdcc..2c2dbf07d 100644
--- a/zh/self-host/deploy/configuration/environments.mdx
+++ b/zh/self-host/deploy/configuration/environments.mdx
@@ -1395,6 +1395,14 @@ Dify API 调用 Agent 后端运行接口时出示的 Bearer 令牌。Compose 会
 
 设为 `false` 可隐藏它并回退到经典 Agent 节点。此变量替代了 `ENABLE_AGENT_V2`，后者仍可作为回退。
 
+### UPLOAD_SKILL_FILE_SIZE_LIMIT
+
+默认值：`50`
+
+Skill 包（`.zip` 或 `.skill`）的最大大小，单位为 MB。无论将包作为内嵌 Skill 上传到 Agent，还是导入 Skill 库，都受此限制。超过限制时会返回大小错误。
+
+Skill 解压后的内容另有两项上限：200 MB 和 5000 个文件；导入 Skill 库时，文件夹也计入 5000 个条目。此变量不会改变这两项限制。若将其提高到 100 以上，还需同步提高 `NGINX_CLIENT_MAX_BODY_SIZE`，否则 Nginx 会以 413 错误拒绝上传。
+
 ### AGENT_BACKEND_BASE_URL
 
 默认值：`http://agent_backend:5050`
diff --git a/zh/self-host/use-dify/build/new-agent/build.mdx b/zh/self-host/use-dify/build/new-agent/build.mdx
index d6703811b..7c08f3eb1 100644
--- a/zh/self-host/use-dify/build/new-agent/build.mdx
+++ b/zh/self-host/use-dify/build/new-agent/build.mdx
@@ -51,21 +51,27 @@ Agent 表现好不好，很大程度取决于模型，尽量选较新的模型
 - **工具与文件的使用**：点名说明各自何时使用。
 - **输出**：期望的格式、长度或语气。
 
-你可将 Agent 指向特定的 Skill、文件、工具或知识源，也可把选择权留给它：
+你可将 Agent 指向特定的 Skill、文件、工具或知识库，也可把选择权留给它：
 
 - **在提示词中引用**：输入 `/` 引用，Agent 会在你指定的位置直接用上它。适合某个步骤依赖特定资源的场景。
-
 - **只添加不引用**：把它加到对应区域，何时使用由 Agent 自行决定。适合你更愿意相信 Agent 的判断、不想事事写死的场景。
 
 ### Skill
 
-Skill 是你为 Agent 打包的一套完整流程：把某项专门任务所需的指令、参考材料和脚本捆绑在一起，定义一次即可反复使用。
+Skill 是 Agent 针对某项特定任务遵循的一套流程。提示词设定 Agent 的整体角色，而 Skill 只负责这一项任务。
+
+例如，客服 Agent 的提示词可把它设定为处理各类问题的客服助手，而 `refund-requests` Skill 只处理退款：查询订单、仅处理 30 天内的退款，并在最后提供帮助中心链接。
+
+点击 **添加**，再选择 Skill 的来源：
 
-提示词设定的是 Agent 的整体角色，而 Skill 是它只在特定任务需要时才取用的作业指南，就像交给能干员工的一份 SOP。Agent 自带通用能力，Skill 则为这项工作提供你规定的确切步骤、材料和工具，让产出符合你的预期。
+- 选择 **从 Skill 库添加**，添加工作空间内共享的 [Skill 库中的 Skill](/zh/self-host/use-dify/build/skills)。每个 Agent 最多可添加 20 个此类 Skill，并会采用各 Skill 的最新发布版本。
+- 选择 **上传 skill.zip**，将 `.zip` 或 `.skill` 包作为内嵌 Skill 添加到 Agent。内嵌 Skill 只属于该 Agent。包大小默认不超过 50 MB；可通过 [`UPLOAD_SKILL_FILE_SIZE_LIMIT`](/zh/self-host/deploy/configuration/environments#upload_skill_file_size_limit) 环境变量调整。要与其他 Agent 共享，[将它加入 Skill 库](/zh/self-host/use-dify/build/skills#导入-skill)。
 
-例如，一个 `marketing-copy` Skill 可打包你的风格指南、品牌素材和检查清单，省得每次重新解释。
+你也可在 [构建模式](#通过对话构建) 中让 Agent 替你创建内嵌 Skill。
 
-Skill 包只能是 `.zip` 或 `.skill` 文件，不超过 50 MB，且包内要有 `SKILL.md`。关于包格式和构建方法，参见 [Agent Skills](https://agentskills.io/home)。你也可在 [构建模式](#通过对话构建) 中让 Agent 替你创建 Skill。
+<Note>
+要使用 Dify 工具、文件或知识库，请将其直接添加到 Agent，而不要只在 Skill 中引用。
+</Note>
 
 ### 文件
 
diff --git a/zh/self-host/use-dify/build/skills.mdx b/zh/self-host/use-dify/build/skills.mdx
new file mode 100644
index 000000000..a2afd2cdf
--- /dev/null
+++ b/zh/self-host/use-dify/build/skills.mdx
@@ -0,0 +1,81 @@
+---
+title: Skills
+sidebarTitle: Skills
+description: 将单项任务及其配套文件打包为可复用的 Skill，并在工作空间内共享
+---
+
+> 本文档由 AI 自动翻译。如有任何不准确之处，请参考 [英文原版](/en/self-host/use-dify/build/skills)。
+
+Skill 是一次构建、重复使用的独立内容包。其中的 `SKILL.md` 包含一项任务的执行说明，并告诉 Agent 何时使用；还可加入该任务所需的参考资料和脚本。完整格式参见 [Agent Skills](https://agentskills.io/home)。
+
+Skill 库最多可保存 500 个 Skill，并在整个工作空间内共享。发布 Skill 更新后，所有使用它的 Agent 都会采用最新版本。
+
+Skill 可用于：
+
+- [新 Agent 应用](/zh/self-host/use-dify/build/new-agent/build#skill)
+- [Workflow 应用](/zh/self-host/use-dify/build/workflow-chatflow) 中的 [新 Agent 节点](/zh/self-host/use-dify/nodes/agent)
+
+在 **Skills** 页面创建、导入和管理 Skill 库中的 Skill。
+
+<Info>
+创建和管理 Skill 需要编辑及以上角色。
+</Info>
+
+## 创建 Skill
+
+在 **Skills** 页面点击 **创建**。如需以现有 Skill 为起点，在其 **⋯** 菜单中选择 **复制**；复制已发布的 Skill 时，不包含草稿中的更改。无论采用哪种方式，系统都会打开编辑器，你可自行编写，也可通过 [Skill Builder](#使用-skill-builder-起草) 生成草稿。
+
+在 `SKILL.md` 正文中写明 Agent 要遵循的流程，并在 frontmatter 中设置：
+
+- **显示名称**：显示在侧边栏顶部以及 Skill 出现的各处。使用容易辨认的名称。
+- **名称**：Agent 引用 Skill 时使用的唯一名称，例如 `refund-requests`。
+- **描述**：Agent 通过它判断是否使用该 Skill。描述要具体。
+- **元数据**：用于记录其他参考信息的自定义字段，例如 `owner: payments-team` 或 `source: https://wiki.example.com/refund-policy`。
+
+通过文件树添加脚本、参考资料和其他配套文件。不同文件类型支持的操作如下：
+
+- **文本和代码**（Markdown、脚本、JSON、YAML、CSV 等）：直接编辑。
+- **图片和 PDF**：直接预览。
+- **其他文件**：下载后查看。
+
+### 使用 Skill Builder 起草
+
+与 Skill Builder 对话，让它为你起草 Skill。描述使用场景或附上已有的流程文档，它会编写 `SKILL.md` 并创建配套文件，供你检查和完善。
+
+支持以下文件类型：
+
+| 类型 | 示例 |
+|:-----|:-----|
+| PDF | `.pdf` |
+| Word | `.doc`、`.docx` |
+| Excel | `.xls`、`.xlsx` |
+| PowerPoint | `.ppt`、`.pptx` |
+| RTF | `.rtf` |
+| 图片 | `.png`、`.jpg`、`.jpeg`、`.gif`、`.webp`、`.svg` |
+| 文本和数据 | `.txt`、`.md`、`.csv`、`.json`、`.yaml` |
+
+每条消息最多附加 10 个文件：图片不超过 10 MB，其他文件不超过 15 MB。这些文件只为 Skill Builder 提供上下文，不会成为 Skill 的一部分。要将文件加入 Skill，请通过文件树添加。
+
+## 导入 Skill
+
+要把在其他地方构建的 Skill 加入 Skill 库，点击 **导入**，选择包含 `SKILL.md` 的 `.zip` 或 `.skill` 包。包大小默认不超过 50 MB；可通过 [`UPLOAD_SKILL_FILE_SIZE_LIMIT`](/zh/self-host/deploy/configuration/environments#upload_skill_file_size_limit) 环境变量调整。导入后，Skill 会以草稿状态加入 Skill 库，供你检查并发布。
+
+## 为 Skill 添加标签
+
+在 Skill 卡片或编辑器中添加标签，再按标签筛选 Skill。
+
+## 发布和版本
+
+更改会自动保存为草稿。发布草稿后，才能将 Skill 添加到 Agent。每次发布都会保存为一个版本，之后可重新查看或恢复。要记录版本变化，在其 **⋯** 菜单中选择 **编辑版本信息**，填写标题和说明。
+
+<Note>
+恢复版本会替换当前草稿。发布该草稿后，它才会成为最新版本。
+</Note>
+
+## 导出 Skill
+
+要在当前工作空间之外使用 Skill，在其卡片的 **⋯** 菜单中选择 **导出**。你会获得 Skill 最新发布版本的 `.zip` 文件。
+
+## 删除 Skill
+
+删除 Skill 会将它及其全部版本从工作空间和所有使用它的 Agent 中移除。删除后无法恢复；如之后可能还会用到，请先导出副本。