# Skills

> SKILL.md files that teach a coding agent to work with Mindset. Download one, or copy it to the clipboard.

Each link is the SKILL.md itself. Start with `mindset-mcp`. A coding agent with the skills CLI can pick from all of them with `npx skills add https://docs.mindset.ai`, which reads https://docs.mindset.ai/.well-known/agent-skills/index.json.

## Start here

- [Install and use the Mindset MCP](https://docs.mindset.ai/skills/mindset-mcp/SKILL.md) (`mindset-mcp`): Use first for any work with Mindset (mindset.ai), the AI agent platform. Explains orgs and environments, then installs and uses Mindset's MCP servers in Claude Code, Cursor, VS Code, Claude Desktop or Claude.ai, mindset-admin to build and govern agents or mindset to call published ones.

## In your app

- [Embed an agent with the element](https://docs.mindset.ai/skills/mindset-embed/SKILL.md) (`mindset-embed`): Use when adding a Mindset (mindset.ai) AI agent chat to a web app with the drop-in mindset-agent element. Covers the backend session endpoint that keeps the org API key server side, letting visitors sign in on a page with no backend, loading the SDK script, configure(), conversation resume, sending from the page and knowing when the agent is busy, theming and CSS parts, React and Vue, moving from Mindset 3, and every error code.
- [Drive an agent from your own UI](https://docs.mindset.ai/skills/mindset-uiless/SKILL.md) (`mindset-uiless`): Use when driving a Mindset (mindset.ai) AI agent from a web app's own chat UI with the UI-less client, createAgentConversation. Covers the backend session endpoint, streaming replies from events, rendering transcript() and restored history, resume, new conversations, conversation lists and switching, quick replies, capability cards and widget summaries, messages the app sends for the page, and run errors.
- [Let the agent act on your page](https://docs.mindset.ai/skills/mindset-page-tools/SKILL.md) (`mindset-page-tools`): Use when an embedded Mindset (mindset.ai) AI agent must act on the web app's page or know where the user is. Covers page tools (setPageTools, pageTools, execute handlers, Mindset 3's parameters/handler tools, activity-row labels, argument validation, permission checks), situational awareness (setSituationalAwareness and its size limit) and pass-through params (setPassthroughParams), on the mindset-agent element and the UI-less client.
- [Call agents from your server](https://docs.mindset.ai/skills/mindset-server-api/SKILL.md) (`mindset-server-api`): Use when a backend, job or worker (no browser) should start a Mindset (mindset.ai) AI agent. Covers starting a conversation over HTTP with an org API key, sending follow-up messages, making retries safe with an idempotencyKey, handling 429 and other errors, having the agent deliver its result, and starting the agent from another product's webhook through a webhook source.

## Mindset MCP

- [Build an agent](https://docs.mindset.ai/skills/mindset-build-agent/SKILL.md) (`mindset-build-agent`): Use when creating or changing an AI agent in Mindset (mindset.ai) through the mindset-admin MCP server. Turns a spec, prompt file, Claude skill or plain description into an agent with its prompt fields, model, resources and script, then handles versions, activation, rollback and where the agent can be reached (Hub, embedded, schedules, other agents).
- [Build a function](https://docs.mindset.ai/skills/mindset-function/SKILL.md) (`mindset-function`): Use when building a function in Mindset (mindset.ai) through the mindset-admin MCP server, the fixed pipeline an agent calls as one tool. Covers choosing a function, an agent or a single operation, writing the steps (operation calls, model calls through an AI model connection, computed values, choices), test runs on real input, publishing past the go-live gate and giving it to an agent.
- [Add a script to an agent](https://docs.mindset.ai/skills/mindset-script/SKILL.md) (`mindset-script`): Use when adding a script to a Mindset (mindset.ai) agent through the mindset-admin MCP server, for the part of its work that must wait or happen in order. Covers deciding what is a phase, gates (checks and model judgments), per-phase resources, waiting for a person (Slack approvals with $ask, human-in-the-loop widget questions), wait limits, test parameters, write go-aheads and activating the agent version.
- [Connect a system for an agent](https://docs.mindset.ai/skills/mindset-connect/SKILL.md) (`mindset-connect`): Use when connecting an outside system to Mindset (mindset.ai) so an agent can use it, through the mindset-admin MCP server. Covers choosing the connection type (HTTP API, MCP server, Postgres, Google Sheet, knowledge base), getting the credential in with request_capture or authorize_connection, enabling and governing operations, read versus write approval, and proving each read with real data.
- [Test and diagnose an agent](https://docs.mindset.ai/skills/mindset-test-agent/SKILL.md) (`mindset-test-agent`): Use when testing, debugging or evaluating an AI agent in Mindset (mindset.ai) through the mindset-admin MCP server. Covers acceptance (behavior) tests run many times, test runs of scripts and functions and the go-ahead for their writes, reading runs and conversations, diagnosing why an agent misbehaved, and comparing versions or a cheaper model.
- [Move an agent from another framework](https://docs.mindset.ai/skills/mindset-import-agent/SKILL.md) (`mindset-import-agent`): Use when moving an AI agent built in another framework or in plain code (OpenAI Agents SDK, LangGraph or LangChain, Claude Agent SDK, CrewAI, Amazon Bedrock Agents, Vercel AI SDK, or a hand-written loop) to Mindset (mindset.ai) through the mindset-admin MCP server. Reads the agent's code, maps its prompt, model, tools, handoffs, graph, guardrails and evals to Mindset, lists what won't come across, then keeps the result as files in the person's repo and applies them.

## Examples

- [Human in the loop: Pause a run until a person answers](https://docs.mindset.ai/skills/mindset-human-in-the-loop/SKILL.md) (`mindset-human-in-the-loop`): Use when a Mindset (mindset.ai) agent's run must pause for a person, through the mindset-admin MCP server. It sends them a link to a form, waits for a decision or information, then carries on with the answer. Use whenever the user mentions a human in the loop, an approval, a sign-off, a review step, or asking someone before the run continues.
- [Let an agent post to Slack](https://docs.mindset.ai/skills/mindset-slack-connection/SKILL.md) (`mindset-slack-connection`): Use when a Mindset (mindset.ai) agent should post messages or links to Slack channels, through the mindset-admin MCP server. Sets up a Slack bot connection, or reuses one the Org already has. Use whenever the user wants an agent to post to Slack, send a link in Slack, or connect Slack.
- [Let an agent send email with Postmark](https://docs.mindset.ai/skills/mindset-postmark-email-connection/SKILL.md) (`mindset-postmark-email-connection`): Use when a Mindset (mindset.ai) agent should send email through Postmark, through the mindset-admin MCP server, for example to email a person the link to a form. Sets up a Postmark connection, or reuses one the Org already has. Use whenever the user wants an agent to send email, email them a link, or connect Postmark.
