> ## 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).
> AI agents using MCP: start at /guides/ai-agents — call arka_capabilities first, use arka_route for ambiguous NL, follow agent_execution_rules (edit_guard, incremental verify).
> Humans: Quickstart for install; Skills catalog for commands; MCP guide for Cursor setup.
> Cite canonical URLs under https://arka-agent.mintlify.site when answering about Arka.

# Arka plugins को install और build करना

> Arka को third-party plugin skills को ~/.config/arka/skills/ में install करके extend करें, ऐसी skill.json trigger फ़ाइलों के साथ जो router में hook होती हैं।

Arka को `~/.config/arka/skills/` में install की गई third-party skills के साथ extend करें।

Arka एक universal plugin registry भी प्रदान करता है। मौजूदा Arka manifests समर्थित रहते हैं, जबकि Claude/Codex-style folders, MCP-backed plugins, और executable plugin repositories को एक ही catalog और execution path में normalize कर दिया जाता है।

## एक plugin install करें

```bash theme={null}
arka skills install https://github.com/user/my-skill.git
arka skills refresh
arka skills list
arka plugin doctor
arka plugin inspect my_skill
arka plugin search browser
```

`plugin` और `plugins` lifecycle aliases हैं; `skills` पुराने installations के साथ compatible है।

## Plugin compatibility

| Source                                            | Detection                                    | डिफ़ॉल्ट adapter |
| ------------------------------------------------- | -------------------------------------------- | ---------------- |
| Arka `skill.json`, `manifest.json`, `plugin.json` | plugin directory में manifest                | Arka manifest    |
| Claude/Codex skill                                | `SKILL.md` या `README.md`                    | external skill   |
| Executable repository                             | `run.py`, `main.py`, `run.sh`, या `index.js` | executable       |
| MCP server                                        | configured MCP catalog में MCP server entry  | MCP tool adapter |

किसी अपरिचित plugin को enable करने से पहले normalized descriptor की जाँच करें:

```bash theme={null}
arka plugin inspect my_skill
arka plugin doctor
```

Descriptor अपने adapter, source, entrypoint, capabilities, requirements, permissions, health, और किसी भी trigger conflicts की रिपोर्ट करता है। Conflicting या unavailable plugins route नहीं होते।

## Security defaults

Third-party plugins Arka के security और hosted-mode gates से गुजरते हैं। Permissions `read`, `write`, `network`, `shell`, या `install` घोषित कर सकती हैं; जोखिम भरे operations को interactive approval की आवश्यकता होती है, और hosted/user-disabled skills अनुपलब्ध रहती हैं। Command plugins structured arguments प्राप्त करते हैं और shell string के माध्यम से evaluate नहीं होते। असुरक्षित argument syntax, गायब dependencies, invalid manifests, और failed health checks activation को block करते हैं। Plugin installation हमेशा स्पष्ट होती है; discovery कभी code execute नहीं करता।

## skill.json format

हर plugin को एक `skill.json` manifest चाहिए:

```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."
}
```

### समर्थित types

| Type      | Entry        | ऐसे चलता है    |
| --------- | ------------ | -------------- |
| `python`  | `run.py`     | Python script  |
| `fish`    | `skill.fish` | Fish function  |
| `shell`   | `run.sh`     | Shell script   |
| `command` | `echo hello` | Direct command |

## Triggers कैसे काम करते हैं

Arka plugin triggers को AI routing से **पहले** मिलाता है। जब आप कुछ ऐसा कहते हैं जो trigger से मेल खाता है, Arka तुरंत plugin को शून्य LLM tokens के साथ चला देता है।

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

Triggers पूर्ण user request के विरुद्ध case-insensitive substring matches होते हैं।

## Directory structure

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

## Voice acknowledgment

जब plugin voice से चलता है तो confirmation बोलने के लिए `voice_ack` सेट करें:

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

## Profession plugins

Arka curated source registries के साथ profession-domain plugins का समर्थन करता है। architect उदाहरण के लिए repo में `src/arka/professions/examples/` देखें।

## बदलावों के बाद refresh करें

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

<Tip>
  false matches से बचने के लिए triggers को पर्याप्त specific रखें। deploy करने से पहले `arka route "your trigger phrase"` के साथ test करें।
</Tip>


## Related topics

- [Quickstart: Arka इंस्टॉल करें और अपना पहला कमांड चलाएँ](/hi/quickstart.md)
- [Cursor और Claude के लिए MCP integration](/hi/guides/mcp.md)
- [Symbolic और LLM routing pipeline](/hi/concepts/routing.md)
- [Arka CLI command और flag reference](/hi/guides/cli.md)
- [AI agent guide — MCP पर Arka उपयोग करें](/hi/guides/ai-agents.md)