---
{
  "id": "platform.skill.overview",
  "topic": "skill",
  "title": "平台內建 Skill 概觀",
  "locale": "zh-TW",
  "version": "2026-08-25",
  "summary": "Skills 提供扣點媒體能力，也提供審核目錄探索、安裝、套件生命週期、逐 Agent 設定、自訂 Skill 管理與安全的 URL 匯入預覽。",
  "content": "`skill` family 包含扣點媒體與管理。用 `list_catalog`／`get_catalog_skill` 探索 reviewed Skill，package list/detail 看來源與版本。Catalog 與管理 actions 都是 private-only，因為 route projection 含逐 owner 的安裝狀態。`install_skill`／`uninstall_skill` 管理私人 standalone Skill；package entries 必須走原子化 lifecycle。安裝、移除、package 寫入、發布與 Tier-1 toggle 都需確認。`list_installed_skills` 彙整 owned fleet；`configure_agent_skill` 修改一個 owned Agent 的啟用、activation mode 或受限 config。\n\n自訂 Skill 支援 private CRUD 與 reviewed-package 發布政策，不可繞過 migration error。`preview_import` 掃描 GitHub `SKILL.md` 但不寫入；提交仍只能在 `/skills?tab=my` 的 web session 完成。不得呼叫 deprecated `install_from_url`。`arinova.skill.web_search` 是隱藏 alias；公開網路用 `arinova.web.search`，授權站內資源用 `arinova.search.query`。\n\n扣點 actions 使用觸發者點數；現價以 Skills Hub、runtime 與 wallet 為準。結果含 `call_id`、`status`、`cost_charged_points`。不可原樣重試 moderated 內容；失敗或攔截會自動退回 reserve。`insufficient_credit` 會映射為 resource conflict；請使用者補點。\n\n沒有 enablement row 時預設啟用；明確設為 disabled 會回 `ACTION_DISABLED`。媒體轉換與 Speech Engine 限 private；Speech Engine 不能呼叫工具或做特權操作。`skill.image_edit` 只執行一次 prompt-based edit；開啟的編輯 session 用 `image_editor` family。以 live registry/runtime 為準。\n",
  "aliases": [
    "生成圖片",
    "產生圖片",
    "畫一張",
    "語音",
    "文字轉語音",
    "音效生成",
    "語音轉文字",
    "音訊轉錄",
    "音樂生成",
    "聲音轉換",
    "人聲分離",
    "多語配音",
    "即時語音對話",
    "安裝技能",
    "瀏覽技能目錄",
    "設定 Agent 技能",
    "技能套件更新",
    "自訂技能",
    "built-in skill",
    "image generation",
    "text to speech",
    "install skill"
  ],
  "tags": [
    "skill",
    "overview",
    "billing",
    "routing"
  ],
  "relatedActions": [
    "arinova.skill.image_gen",
    "arinova.skill.image_edit",
    "arinova.skill.voice_tts",
    "arinova.skill.sound_effects",
    "arinova.skill.voice_stt",
    "arinova.skill.music_gen",
    "arinova.skill.voice_changer",
    "arinova.skill.voice_isolator",
    "arinova.skill.dubbing",
    "arinova.skill.speech_engine",
    "arinova.skill.list_catalog",
    "arinova.skill.get_catalog_skill",
    "arinova.skill.install_skill",
    "arinova.skill.uninstall_skill",
    "arinova.skill.list_installed_skills",
    "arinova.skill.list_skill_packages",
    "arinova.skill.get_skill_package",
    "arinova.skill.list_installed_skill_packages",
    "arinova.skill.preview_skill_package_update",
    "arinova.skill.install_skill_package_version",
    "arinova.skill.update_skill_package_install",
    "arinova.skill.rollback_skill_package_install",
    "arinova.skill.disable_skill_package_install",
    "arinova.skill.uninstall_skill_package_install",
    "arinova.skill.list_custom_skills",
    "arinova.skill.create_custom_skill",
    "arinova.skill.update_custom_skill",
    "arinova.skill.delete_custom_skill",
    "arinova.skill.publish_custom_skill",
    "arinova.skill.toggle_tier1",
    "arinova.skill.configure_agent_skill",
    "arinova.skill.preview_import"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/skill/overview/"
}
---

`skill` family 包含扣點媒體與管理。用 `list_catalog`／`get_catalog_skill` 探索 reviewed Skill，package list/detail 看來源與版本。Catalog 與管理 actions 都是 private-only，因為 route projection 含逐 owner 的安裝狀態。`install_skill`／`uninstall_skill` 管理私人 standalone Skill；package entries 必須走原子化 lifecycle。安裝、移除、package 寫入、發布與 Tier-1 toggle 都需確認。`list_installed_skills` 彙整 owned fleet；`configure_agent_skill` 修改一個 owned Agent 的啟用、activation mode 或受限 config。

自訂 Skill 支援 private CRUD 與 reviewed-package 發布政策，不可繞過 migration error。`preview_import` 掃描 GitHub `SKILL.md` 但不寫入；提交仍只能在 `/skills?tab=my` 的 web session 完成。不得呼叫 deprecated `install_from_url`。`arinova.skill.web_search` 是隱藏 alias；公開網路用 `arinova.web.search`，授權站內資源用 `arinova.search.query`。

扣點 actions 使用觸發者點數；現價以 Skills Hub、runtime 與 wallet 為準。結果含 `call_id`、`status`、`cost_charged_points`。不可原樣重試 moderated 內容；失敗或攔截會自動退回 reserve。`insufficient_credit` 會映射為 resource conflict；請使用者補點。

沒有 enablement row 時預設啟用；明確設為 disabled 會回 `ACTION_DISABLED`。媒體轉換與 Speech Engine 限 private；Speech Engine 不能呼叫工具或做特權操作。`skill.image_edit` 只執行一次 prompt-based edit；開啟的編輯 session 用 `image_editor` family。以 live registry/runtime 為準。