Skip to main content
The Plain Support Skill gives AI tools direct access to your Plain workspace via the GraphQL API. Once installed, your agent can read customers, threads, thread timelines, Help Center articles, and more. The skill uses your Plain API key to authenticate, so the agent will only have access to what that API key permits.
Agent skill in Plain

​
Compatible agents

The Plain Support Skill follows the open Agent Skills specification and works with any compatible agent, including:

​
Installation

Install the skill using the skills CLI:
The installer will ask which agent(s) you want to install to. You can also specify the agent directly:
Alternatively, you can clone the repository manually:

​
Prerequisites

​
API key

In Plain, go to Settings → Machine users & API keys and create an API key. Then set it as an environment variable:
Add this to your shell profile (.bashrc, .zshrc, etc.) so it persists across sessions.

​
Dependencies

The skill requires curl and jq. On most systems curl is already installed. For jq:

​
What you can do

​
Use case examples

  • Debug a customer issue end to end: Ask your agent to look up a customer, read their thread timeline, and summarize the conversation. Then use that context to investigate the bug in your codebase and put up a fix, all in one session.
  • Research customer history before a call: “Show me everything about customer john@acme.com”. The agent will pull their profile, open threads, and recent conversations so you’re fully briefed.
  • Add investigation notes: After debugging an issue, tell the agent to add your findings as an internal note on the thread so your team has context.
  • Draft Help Center content: Ask the agent to create a new Help Center article based on patterns it sees in support threads. It can write the HTML content and publish it directly to your Plain Help Center.
  • Ad hoc analysis: “Which customers are in the Enterprise tier?” or “Show me all open threads with priority 0”. Query your support data conversationally.

​
Example prompts

  • “What are the open support threads for customer john@example.com?”
  • “Read the full conversation on thread th_01ABC and summarize it”
  • “Add a note to thread th_01ABC with my investigation findings”
  • “Create a Help Center article about how to reset passwords”
  • “Which customers are in the Enterprise tier?”
  • “List my open threads”