> ## Documentation Index
> Fetch the complete documentation index at: https://docs.turnkey.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Turnkey is wallet infrastructure: create and manage crypto wallets, sign transactions, and enforce policy-based access controls. Best-fit uses: embedded consumer wallets (email/passkey/social auth, no seed phrases), automated onchain operations with server-side wallets, AI agent wallets with policy-scoped signing, enterprise key management, and verifiable off-chain workloads on Turnkey Verifiable Cloud (TVC).
> Every API call is a JSON POST to https://api.turnkey.com signed with a P-256 API key; create an organization and key self-serve at https://app.turnkey.com.
> Key Turnkey developer resources: API reference (https://docs.turnkey.com/api-reference/overview/intro.md), OpenAPI spec (https://docs.turnkey.com/public_api.swagger.json), authentication (https://docs.turnkey.com/features/authentication/overview.md), webhooks (https://docs.turnkey.com/features/webhooks/overview.md), MCP server for docs search (https://docs.turnkey.com/mcp), skill for building with Turnkey (https://docs.turnkey.com/skill.md), agent skills for operating an organization (https://docs.turnkey.com/get-started/ai-skills.md), CLI (https://docs.turnkey.com/sdks/cli.md), SDK reference (https://docs.turnkey.com/sdks/introduction.md), full docs content (https://docs.turnkey.com/llms-full.txt).

# Agent Skills

> Opinionated instructions that tell AI agents how to interact with Turnkey through conversation, not code.

Each agent skill is a `SKILL.md` file with opinionated, step-by-step instructions for a specific Turnkey operation. Instead of an agent reasoning about API docs, parameter formatting, and chain-specific details on its own, skills give it exactly what it needs to execute correctly. Skills work with Claude Code, OpenAI, and other third-party agent frameworks.

These skills let an AI assistant operate your Turnkey organization at runtime: the agent holds an API key and calls Turnkey directly to create wallets, sign, and manage users and policies. They are not a guide for building an application on Turnkey. If you're using a coding agent to develop a Turnkey integration, use the [Turnkey skill and the Docs MCP server](https://docs.turnkey.com/get-started/using-llms.md#turnkey-skill) instead.

Skills are open source at [**tkhq/turnkey-agent-skills**](https://github.com/tkhq/turnkey-agent-skills) on GitHub. The [Turnkey Verifiable Cloud](https://docs.turnkey.com/features/verifiable-cloud/overview.md) skill is the exception: it ships inside the TVC CLI (`tvc`) and is installed from it (see [TVC CLI skill](#tvc-cli-skill)).

## Use cases

Skills are composable. Each skill handles a single domain (wallets, signing, policies, etc.) and can be combined for any workflow. Common starting points:

| Use case | What you can do | Start with |
| :- | :- | :- |
| **Explore and test** | Create wallets, sign transactions, and set policies without writing integration code | `getting-started` |
| **Administer your org** | Manage users, rotate API keys, configure policies, and monitor activities conversationally | `managing-users`, `managing-policies` |
| **Provision autonomous agents** | Set up a scoped wallet with constrained credentials and governance policies for onchain automation | `provisioning-agent` |

## Credentials and security

> [!WARNING]
>
> Read the following carefully before giving any AI agent access to your Turnkey organization.

* **LLMs can misinterpret instructions or execute unintended actions.** Scoped credentials ensure mistakes are bounded. Turnkey policies are the technical enforcement mechanism.
* **Root credentials are dangerous to give to an AI agent.** A root API key bypasses all policies and has full access to your organization. Root credentials may be acceptable for testing — evaluate the risk before using them in production.
  * For best security, create a non-root user with specifically scoped permissions and approval flows. When testing against a non-production organization, root credentials may be more acceptable.
* **Never test against wallets holding real funds** unless you have appropriate safeguards in place (scoped credentials, spending caps, destination allowlists).
* **Turnkey operates based on a [shared responsibility model](https://docs.turnkey.com/security/shared-responsibility-model.md).** Turnkey secures the platform, including enclaves, the policy engine, and key confidentiality. You are responsible for how you configure your organization, scope credentials, and author policies. This applies doubly when delegating actions to an AI agent.

All skills require an API key pair and organization ID from the [Turnkey Dashboard](https://app.turnkey.com) (**Settings > API Keys**). Which credentials you use depends on your setup:

| Setup | Credential type | When to use |
| :- | :- | :- |
| **Interactive assistant** (human approves each action) | Root API key (with extreme caution) or a scoped, non-root API key | Organization administration, testing, and exploration. Human should review every action before it executes. |
| **Autonomous agent** (acts without human review) | Scoped, non-root API key | Production automation. **Never use root credentials for autonomous agents.** Root keys bypass all policies. Create a non-root user with scoped policies instead. See [Agentic Wallets](https://docs.turnkey.com/solutions/company-wallets/agentic-wallets.md) and the `provisioning-agent` skill. |

## Available skills

Skills are organized into **workflows** (guided multi-step procedures) and **primitives** (individual operations). The **TVC CLI skill** is separate: it is bundled with the TVC CLI and installed from it.

### Workflows

| Skill | Description |
| :- | :- |
| **Getting Started** | Day-0 onboarding: verify credentials, create your first wallet |
| **Provisioning Agent** | Create a scoped agent with constrained credentials and policies |
| **Managing Agent** | Debug denied transactions, rotate keys, update agent policies |

### Primitives

| Skill | Description |
| :- | :- |
| **Managing Wallets** | Create wallets, derive addresses, add chains, import/export |
| **Signing Transactions** | Sign and broadcast on any supported chain (EVM, Solana, Bitcoin, and more) |
| **Managing Users** | Create users, rotate API keys, manage user tags |
| **Managing Policies** | Access control, spending limits, allowlists, multi-party approval |
| **Monitoring Activities** | Activity status, consensus approvals, audit logs |

### TVC CLI skill

The TVC skill is embedded in the `tvc` binary rather than the skills repo, so the skill you install always documents the TVC CLI version you have. The Turnkey CLI (`turnkey`) does not ship skills.

| Skill | Description | Install |
| :- | :- | :- |
| **TVC Deployments** | Build, deploy, and maintain [Turnkey Verifiable Cloud](https://docs.turnkey.com/features/verifiable-cloud/overview.md) apps with the `tvc` CLI: create apps and deployments, approve manifests, switch the live deployment, and parse the CLI's JSON output | `tvc skills save` (see [TVC agent skill](https://docs.turnkey.com/features/verifiable-cloud/agent-skill.md)) |

> [!NOTE]
>
> The TVC Deployments skill drives the TVC CLI, not the HTTP API, and authenticates with `TVC_*` environment variables rather than the `TURNKEY_API_*` variables the other skills use. Its source lives in [tkhq/rust-sdk](https://github.com/tkhq/rust-sdk/tree/main/tvc/skills/tvc-deployments).

## Getting started

Clone the repo and point your AI assistant at the skill files:

```bash theme={"system"}
git clone https://github.com/tkhq/turnkey-agent-skills.git
cd turnkey-agent-skills
```

For the TVC Deployments skill, install the TVC CLI and save the bundled skill into your project's skills directory:

```bash theme={"system"}
cargo install tvc
tvc skills save
```

## Next steps

![](https://docs.turnkey.com/images/solutions/light/agentic-wallets.svg)

Agentic Wallets

Give AI agents scoped signing authority with policy-enforced access control.

[Open](https://docs.turnkey.com/solutions/company-wallets/agentic-wallets.md)

Policy Engine

Define granular access controls for every signing action in your organization.

[Open](https://docs.turnkey.com/features/policies/quickstart.md)

Using AI to integrate to Turnkey

MCP server, docs context, and other ways to use LLMs with Turnkey.

[Open](https://docs.turnkey.com/get-started/using-llms.md)

Company Wallets Quickstart

Sign your first transaction with the Turnkey server SDK.

[Open](https://docs.turnkey.com/solutions/company-wallets/quickstart.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.