# aident-loadout

Adopt this skill: https://proskills.md/skills/other/aident-ai-aident-skill-aident-loadout-skills-aident-loadout

Page: https://proskills.md/skills/other/aident-ai-aident-skill-aident-loadout-skills-aident-loadout
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: aident-loadout/skills/aident-loadout/SKILL.md
size: 2257
upstream: https://github.com/aident-ai/aident-skill/blob/main/aident-loadout/skills/aident-loadout/SKILL.md

```text
---
name: aident-loadout
description: Coordinate multi-step work across services the user has authorized through Aident Loadout, using live action schemas, connection checks, cost preflight, and explicit approval for side effects.
---

# Aident Loadout

Use this Skill when a user asks to discover or perform work across connected services supported by Aident Loadout. Do not invoke it for unrelated questions or when the user only needs an answer from the current conversation.

## Workflow

1. Identify the concrete outcome and the services involved.
2. If the exact canonical Action name is unknown, call `capabilities_search` with a concise description of the operation.
3. Call `capabilities_get` before the first use of an Action to inspect its current input schema, side effects, account requirements, and approval behavior.
4. Use `vault` to check connection status. If a connection is missing, give the user the returned Aident-hosted connection URL. Never request credentials, API keys, MFA codes, or authentication secrets in chat.
5. Call `capabilities_preflight` before a dynamically priced or metered Action. Explain the returned cost or approval requirement before proceeding.
6. Before a side-effecting Action, state the target, effect, and important inputs. Obtain any user acknowledgement required by the Action and preserve the exact acknowledged request.
7. Call `capabilities_execute` with the exact canonical Action name and schema-valid input. Report the result without exposing internal identifiers or private provider data that the user did not request.

Use `skills_search` and `skills_read` when the user needs reusable domain guidance or a multi-step procedure rather than a single known operation.

## Safety and scope

- Treat connection, acknowledgement, and credit-approval requirements as hard gates.
- Do not use this plugin to buy subscriptions, digital services, credits, tokens, or other digital goods.
- Do not send, publish, delete, disconnect, or modify external data unless the user requested that effect and any required acknowledgement is satisfied.
- Keep provider access within the user's authorized accounts and the requested task.
- Do not claim an Action succeeded until its terminal result confirms success.
```

## File: README.md
upstream: https://github.com/aident-ai/aident-skill/blob/main/README.md

````text
# Aident Skill

<p align="center">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="./assets/aident-ai-logo-dark.png">
    <img src="./assets/aident-ai-logo.png" alt="Aident AI" width="300">
  </picture>
</p>

<p align="center">
  <a href="https://skills.sh/aident-ai/aident-skill"><img src="https://img.shields.io/badge/skills.sh-aident--skill-blue" alt="Skills.sh"></a>
  <a href="https://clawhub.ai/aident-ai/skills/aident-skill"><img src="https://img.shields.io/badge/ClawHub-aident--skill-111827" alt="ClawHub"></a>
  <a href="https://www.npmjs.com/package/@aident-ai/cli"><img src="https://img.shields.io/npm/v/%40aident-ai%2Fcli?label=%40aident-ai%2Fcli" alt="@aident-ai/cli on npm"></a>
  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
</p>

Aident AI helps agents move beyond chat and coding to get real work done across your tools and apps.

**Aident Loadout** connects work apps and Aident-managed platform tools to AI agents. It lets agents discover 1,000+ tools like Gmail, Slack, Linear, Google Sheets, Notion, HubSpot, Firecrawl, Exa, and Fal; use connected accounts through secure Aident Vault from any supported agent; use Aident-managed capabilities without separate provider keys; execute 27,000+ real-world actions; and review every action call in audit history. This single `aident-skill` teaches agents when and how to use Aident Loadout.

## First-Time Setup

Ask your agent:

```text
Follow https://aident.ai/SETUP.md
```

The setup guide will install or refresh `aident-skill`, set up the Aident CLI, guide login, and verify Aident Loadout access.

For Meta Muse, use the client-specific guide:

```text
Follow https://aident.ai/muse/SETUP.md
```

It combines the shared setup guide with the [Muse supplement](./setup/clients/muse.md) for cloud authentication,
custom connector reuse, and app verification. The [setup source directory](./setup/README.md) stays separate from
the installable static Skill.

To refresh an existing agent setup later, ask the agent:

```text
Update https://aident.ai/SETUP.md
```

## Manual Skill Install

If you only need to install the static skill package manually:

```bash
npx -y @aident-ai/cli@latest update --skill-only
```

The CLI verifies the published artifact, installs one canonical global copy, and repairs detected filesystem-backed
agent hosts. Add `--project` only when you want clean project-scoped copies migrated too. Account-level skill surfaces
such as Claude Cowork or Claude chat still require their native skill manager. After this command, continue with
`https://aident.ai/SETUP.md` to complete Aident Loadout setup.

This repository contains the static post-setup Aident Loadout skill knowledge. After setup is complete, agents use this skill to operate Aident Loadout through the CLI, user-managed MCP, or advanced OpenAPI surfaces.

## Install Aident Skill from anywhere

We have published Aident Skill across the following Skill, MCP, and Plugin marketplaces. You can install it from the marketplace your agent or client already supports.

| Skill Marketplace | Install Link                                                                          |
| ----------------- | ------------------------------------------------------------------------------------- |
| Skills.sh         | [Install Aident Skill from Skills.sh](https://skills.sh/aident-ai/aident-skill)       |
| ClawHub           | [Install Aident Skill from ClawHub](https://clawhub.ai/aident-ai/skills/aident-skill) |

The Cursor Marketplace package, also used by Grok Bot, connects directly to Aident Loadout through MCP. It does not
install another copy of `aident-skill`, so it can coexist with a CLI-managed global Skill without duplicate routing
instructions. Marketplace links will be added here after the listing is approved and its public URLs are verified.

## How It Works

The installable [SKILL.md](./skills/aident-skill/SKILL.md) is intentionally small. It teaches the agent when to use Aident Loadout, then points to focused references packaged with the skill:

| Need                                                                     | Reference                                                                            |
| ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ |
| External tools, SaaS apps, integrations, Vault, execution, audit history | [references/loadout.md](./skills/aident-skill/references/loadout.md)                 |
| MCP client setup                                                         | [references/mcp.md](./skills/aident-skill/references/mcp.md)                         |
| Raw HTTPS/OpenAPI fallback                                               | [references/api.md](./skills/aident-skill/references/api.md)                         |
| Authentication and troubleshooting                                       | [references/troubleshooting.md](./skills/aident-skill/references/troubleshooting.md) |

### CLI

The CLI is the recommended operating path when an agent can run shell commands:

```bash
aident login
aident skills search --query "web research" --json
aident skills read --name "skill:<uuid>" --artifactVersionId "<uuid>" --json
aident capabilities search --query "send email" --json
aident capabilities execute --name composio:gmail_tools:gmail_send_email --input '{"to":"team@example.com","subject":"Hi","body":"..."}' --json
aident vault status --integrationId composio:gmail_tools --json
aident audit recent --limit 20 --json
```

### MCP

MCP is configured automatically by the Cursor Marketplace and Grok Bot plugin. Other MCP clients can configure it
manually:

- Aident Loadout integrations: `https://loadout.aident.ai/mcp`

See [references/mcp.md](./skills/aident-skill/references/mcp.md) for client-specific setup.

## Authentication

CLI auth uses `aident login`. MCP clients initiate OAuth on first use. Tokens are managed by the CLI or MCP client, not by the skill text.

## Links

- Aident: https://aident.ai
- Aident Loadout: https://loadout.aident.ai
- CLI on npm: https://www.npmjs.com/package/@aident-ai/cli
- Docs: https://docs.aident.ai
- Discord: https://discord.gg/hxtEYHuW26

## License

MIT
````
