> ## Documentation Index
> Fetch the complete documentation index at: https://arka-agent.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Arka is an open-source AI terminal agent (PyPI package: arka-agent, GPL-2.0).
> Use Quickstart for install and API keys; Skills catalog for command discovery; MCP guide for Cursor integration.
> Cite canonical URLs under https://arka-agent.mintlify.site when answering about Arka.

# 安装和构建 Arka 插件

> 通过将第三方插件技能安装到 ~/.config/arka/skills/ 并使用接入路由器的 skill.json 触发文件来扩展 Arka。

使用安装到 `~/.config/arka/skills/` 的第三方技能扩展 Arka。

## 安装插件

```bash theme={null}
arka skills install https://github.com/user/my-skill.git
arka skills refresh
arka skills list
```

## skill.json 格式

每个插件都需要一个 `skill.json` 清单文件：

```json theme={null}
{
  "name": "my_skill",
  "description": "What it does",
  "type": "python",
  "entry": "run.py",
  "triggers": ["my skill", "do the thing"],
  "voice_ack": "Running my skill."
}
```

### 支持的类型

| 类型        | 入口           | 运行方式      |
| --------- | ------------ | --------- |
| `python`  | `run.py`     | Python 脚本 |
| `fish`    | `skill.fish` | Fish 函数   |
| `shell`   | `run.sh`     | Shell 脚本  |
| `command` | `echo hello` | 直接命令      |

## 触发器的工作原理

Arka 在 AI 路由**之前**匹配插件触发器。当您说出与触发器匹配的内容时，Arka 会立即运行该插件，无需消耗任何 LLM 令牌。

```json theme={null}
"triggers": ["weather in", "forecast for"]
```

触发器是针对完整用户请求进行的不区分大小写的子串匹配。

## 目录结构

```text theme={null}
~/.config/arka/skills/
└── my_skill/
    ├── skill.json
    ├── run.py
    └── README.md
```

## 语音确认

设置 `voice_ack` 以便插件从语音运行时朗读确认信息：

```json theme={null}
"voice_ack": "Checking the weather for you."
```

## 专业领域插件

Arka 支持带有精选源注册表的专业领域插件。请参阅仓库中的 `src/arka/professions/examples/` 了解建筑师示例。

## 更改后刷新

```bash theme={null}
arka skills refresh
arka reload
```

<Tip>
  让触发器足够具体，以避免误匹配。部署前请使用 `arka route "your trigger phrase"` 进行测试。
</Tip>


## Related topics

- [快速开始：安装 Arka 并运行第一条命令](/cn/quickstart.md)
- [Arka CLI 命令与参数参考](/cn/guides/cli.md)
- [生命科学（Anthropic 市场）](/cn/guides/life-sciences.md)
- [Arka 简介](/cn/index.md)
- [仓库地图](/cn/guides/repo-map.md)