---
{
  "id": "platform.skill.overview",
  "topic": "skill",
  "title": "Built-in Skill overview",
  "locale": "en",
  "version": "2026-08-25",
  "summary": "Skills provide billed media capabilities plus reviewed catalog discovery, installation, package lifecycle, per-Agent configuration, custom-skill management, and safe URL-import previews.",
  "content": "The `skill` family includes billed media and management. Use `list_catalog`/`get_catalog_skill` for reviewed skills and package list/detail for provenance and versions. Catalog and management actions are private-only because their route projections include per-owner installation state. `install_skill`/`uninstall_skill` manage private standalone skills; reviewed package entries require atomic package lifecycle actions. Installs, uninstalls, package writes, publication, and Tier-1 toggles require confirmation. `list_installed_skills` groups an owned fleet; `configure_agent_skill` updates one owned Agent's enablement, activation mode, or bounded config.\n\nCustom skills support private CRUD and reviewed-package publication policy; never bypass its migration error. `preview_import` scans a supported GitHub `SKILL.md` without persistence. Commit remains web-session-only at `/skills?tab=my`; never call deprecated `install_from_url`. `arinova.skill.web_search` is a hidden alias: use `arinova.web.search` for public web data and `arinova.search.query` for authorized Arinova resources.\n\nBilled actions use the triggering user's points. Current prices are in Skills Hub; runtime and wallet records are authoritative. Results include `call_id`, `status`, and `cost_charged_points`. Do not resubmit identical moderated content. Failed or moderated calls refund their reserve automatically. `insufficient_credit` maps to a resource conflict; ask the user to add points.\n\nNo enablement row means enabled by default; an explicit disabled setting returns `ACTION_DISABLED`. Media transforms and Speech Engine are private-only; Speech Engine cannot invoke tools or take privileged actions. `skill.image_edit` performs one prompt-based edit; use the `image_editor` family for an open editor. Live registry and results override this card.\n",
  "aliases": [
    "built-in skill",
    "generate image",
    "image generation",
    "draw a picture",
    "text to speech",
    "sound effects",
    "speech to text",
    "transcribe audio",
    "generate music",
    "change a voice",
    "isolate a voice",
    "dub audio",
    "realtime voice conversation",
    "install skill",
    "browse skill catalog",
    "configure agent skill",
    "skill package update",
    "custom 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/en/kb/skill/overview/"
}
---

The `skill` family includes billed media and management. Use `list_catalog`/`get_catalog_skill` for reviewed skills and package list/detail for provenance and versions. Catalog and management actions are private-only because their route projections include per-owner installation state. `install_skill`/`uninstall_skill` manage private standalone skills; reviewed package entries require atomic package lifecycle actions. Installs, uninstalls, package writes, publication, and Tier-1 toggles require confirmation. `list_installed_skills` groups an owned fleet; `configure_agent_skill` updates one owned Agent's enablement, activation mode, or bounded config.

Custom skills support private CRUD and reviewed-package publication policy; never bypass its migration error. `preview_import` scans a supported GitHub `SKILL.md` without persistence. Commit remains web-session-only at `/skills?tab=my`; never call deprecated `install_from_url`. `arinova.skill.web_search` is a hidden alias: use `arinova.web.search` for public web data and `arinova.search.query` for authorized Arinova resources.

Billed actions use the triggering user's points. Current prices are in Skills Hub; runtime and wallet records are authoritative. Results include `call_id`, `status`, and `cost_charged_points`. Do not resubmit identical moderated content. Failed or moderated calls refund their reserve automatically. `insufficient_credit` maps to a resource conflict; ask the user to add points.

No enablement row means enabled by default; an explicit disabled setting returns `ACTION_DISABLED`. Media transforms and Speech Engine are private-only; Speech Engine cannot invoke tools or take privileged actions. `skill.image_edit` performs one prompt-based edit; use the `image_editor` family for an open editor. Live registry and results override this card.