# Attune skills for other agents

A skill is a Markdown file that tells an agent how to run a workflow. Attune's skills sit on top of
the [Attune MCP server](/mcp/): the server supplies the tools, the skill supplies the sequence —
what to ask, in what order, and what to do when an answer is missing.

Attune's skills follow the [Agent Plugins](https://agent-plugins.org/) layout,
`skills/<name>/SKILL.md`, so any agent that reads skills from a directory can use them. Only the
Claude manifests that ship alongside them are vendor-specific.

## attune-guide-builder

The first Attune skill drafts a new survey or interview guide, or refines an existing one:

1. **Resolve the organization.** The agent uses your only Attune organization automatically or
   asks which one to use when your account belongs to several.

2. **Use relevant business context.** The agent reads the stored company and customer context
   relevant to the study. If none is stored, it gathers only what the guide needs and optionally
   offers to save it.

3. **Complete the research objective.** It uses details already present in your request and asks up
   to three focused questions only when important information is missing. You can skip them and
   proceed with sensible defaults. If you have no objective yet, it suggests a few tailored to your
   company and your role.

4. **Choose length, interviewer voice, and how participants respond.** The default is 10 minutes
   with the default interviewer; common alternatives are 3, 5, or 20 minutes, and a positive custom
   length is accepted. Guides offer voice or chat unless you change it. The agent suggests
   **Chat only** when participants are unlikely to be able to talk out loud, for example at work
   or on the go, and **Voice only** when you want spoken answers. It tells you that a chat response
   costs 1 credit.

5. **Create the guide safely.** The agent avoids duplicate guides when retrying an uncertain
   request and returns a link to open the saved draft in the Attune studio.

6. **Refine new or existing guides.** Add or improve segments and questions, reorder the flow, set
   the intro and conclusion, or change the voice while protecting concurrent edits.

Two behaviors are deliberate. The skill never asks for credentials or tokens: OAuth is the only
auth path. And it always asks first before updating business context, because that change applies
to your whole organization.

## Use it with your agent

1. **Connect the MCP server.** Follow [Connect Attune to your AI assistant](/mcp/) for your client.
   Without the server, the skill has no tools to call.

2. **Put the skill where your agent reads skills.** Copy `attune-guide-builder/SKILL.md` into your
   agent's skills directory, such as `.cursor/skills/` or whatever path your agent documents.

3. **Ask for a study.** "Help me build an interview about churn." The agent follows the sequence
   above and hands back a link to the draft.

**Coming soon**

A public repository to download Attune's skills from is on its way. Today the skill ships inside
[the Attune plugin](/mcp/plugin/) for ChatGPT, Codex, and Claude; email
[support@tryattune.ai](mailto:support@tryattune.ai) and we will send you the file.

**Using ChatGPT, Codex, or Claude?**

Install [the Attune plugin](/mcp/plugin/) instead. It brings the MCP server and this skill in
one step.

## Writing your own

Nothing about the tools is Attune-specific to one agent: any MCP client can call
`get_business_context`, `create_interview_guide`, and the guide-editing tools directly, and a skill
is a written procedure over them. The [tool catalog](/mcp/#tool-catalog) lists what is
available and which scope each tool needs.

## Support

Email [support@tryattune.ai](mailto:support@tryattune.ai).

---

Cursor, ChatGPT, Codex, and Claude are trademarks of their respective owners. Attune is not affiliated with
them.