Skip to main content

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.

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. Skills are for interacting with Turnkey directly through an AI assistant, not for building the application layer on top of Turnkey. If you’re using a coding agent to develop a Turnkey integration, connect it to the Docs MCP server instead. Skills are open source at tkhq/turnkey-agent-skills on GitHub.

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 caseWhat you can doStart with
Explore and testCreate wallets, sign transactions, and set policies without writing integration codegetting-started
Administer your orgManage users, rotate API keys, configure policies, and monitor activities conversationallymanaging-users, managing-policies
Provision autonomous agentsSet up a scoped wallet with constrained credentials and governance policies for onchain automationprovisioning-agent

Credentials and security

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. 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 (Settings > API Keys). Which credentials you use depends on your setup:
SetupCredential typeWhen to use
Interactive assistant (human approves each action)Root API key (with extreme caution) or a scoped, non-root API keyOrganization administration, testing, and exploration. Human should review every action before it executes.
Autonomous agent (acts without human review)Scoped, non-root API keyProduction 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 and the provisioning-agent skill.

Available skills

Skills are organized into workflows (guided multi-step procedures) and primitives (individual operations).

Workflows

SkillDescription
Getting StartedDay-0 onboarding: verify credentials, create your first wallet
Provisioning AgentCreate a scoped agent with constrained credentials and policies
Managing AgentDebug denied transactions, rotate keys, update agent policies

Primitives

SkillDescription
Managing WalletsCreate wallets, derive addresses, add chains, import/export
Signing TransactionsSign and broadcast on any supported chain (EVM, Solana, Bitcoin, and more)
Managing UsersCreate users, rotate API keys, manage user tags
Managing PoliciesAccess control, spending limits, allowlists, multi-party approval
Monitoring ActivitiesActivity status, consensus approvals, audit logs

Getting started

Clone the repo and point your AI assistant at the skill files:
git clone https://github.com/tkhq/turnkey-agent-skills.git
cd turnkey-agent-skills