The Helpdesky skill is a single drop-in SKILL.md that teaches your AI agent how to add a chat widget, contact form, ticket center, hosted help center, auto written articles, and inbound email to whatever it is building.
Read https://helpdesky.io/docs/skill.md and set up Helpdesky for my app: add the widget, the contact form, the ticket center, and email forwarding. If you can connect to MCP, connect to https://helpdesky.io/mcp first and create the helpdesk yourself.
The prompt links to the skill itself, served as plain Markdown at helpdesky.io/docs/skill.md, so any agent that can read a URL can follow it. Prefer to install it locally? Run npx skills add helpdesky/helpdesky-skill, see below.
The skill knows every Helpdesky surface, so your agent can wire up exactly what your app needs.
A floating help button with instant search, AI answers, and live messaging.
A clean embedded form so visitors can reach your team in one step.
A full inbox style center where visitors track replies over time.
Links and deep links for every hosting mode: the Helpdesky address, your own subdomain, a subfolder on your website (the agent writes the reverse proxy), or headless articles rendered inside your own templates with the headless Content API.
Create and sync help articles programmatically, including AI written content.
Route support email straight into your Helpdesky inbox with threading.
Two routes, one agent. The skill covers the code in your app; the MCP server covers your Helpdesky dashboard. Use either on its own, or both together.
Connected to helpdesky.io/mcp, the agent signs in as you and does the setup itself, within your permissions:
It never sees your HMAC secret, API key, billing or password. About the MCP server · Connection docs
The skill is what the agent follows inside your codebase, where MCP cannot reach:
Served as Markdown at helpdesky.io/docs/skill.md, or installed with npx skills add helpdesky/helpdesky-skill.
The same file works across every AI app builder that reads instruction or skill files. Only the folder it lives in changes.
The GitHub repo lists the exact install location for each platform.
No SDK, no runtime dependency, no version to keep in sync. The installer runs once and leaves nothing in your project's dependencies; the skill is just a text file your agent reads.
In your project folder, run:
npx skills add helpdesky/helpdesky-skill
The installer asks which agent you use and puts the skill in the right folder. Skip the prompt with -a <agent>, for example -a cursor.
Tell your agent what you want. It reads the skill, asks for any credentials, and writes the integration.
Prefer not to use npx? Copy SKILL.md by hand from the GitHub repo into your agent's skills folder.
Building a headless help center? Point your agent at helpdesky.io/docs/headless.md: a self-contained spec for rendering help articles inside your own site templates through the public Content API.
Want the agent to set up and manage the helpdesk itself? Connect it to the Helpdesky MCP server — Claude, ChatGPT, Cursor and Claude Code can create the helpdesk, configure hosting and embeds, and read and write articles as you, within your permissions (setup docs). See how the two routes combine.
Drop the skill in once and let your agent handle Helpdesky from then on.