The Helpdesky AI agent skill is a single instruction file that teaches any AI coding agent how to add Helpdesky to the app it is building. You drop one SKILL.md file into your agent, and from then on it knows how to wire up the chat widget, a contact form, a ticket center, deep links into your hosted help center, auto written articles, and inbound email. You do not have to read our docs line by line or copy script tags by hand.
It is agent agnostic. The same file works with Replit, Lovable, Cursor, Google Gemini, Bolt, v0, and any other AI app builder that reads instruction or skill files.
You can grab the file from the public repo: github.com/helpdesky/helpdesky-skill.
What the skill is
Think of the skill as a briefing document for your AI agent. It is plain Markdown that lives alongside your project. When your agent plans a task like "add live chat to my site" or "let visitors email support," it reads the skill, learns the correct Helpdesky setup, and writes the integration for you.
Because it is just a text file, there is nothing to install at runtime, no SDK to manage, and no version to keep in sync with your dependencies. You add it once and your agent uses it whenever support features come up.
What it can add to your app
The skill covers every embeddable and hosted Helpdesky surface:
- Chat widget: a floating help button with search, AI answers, and messaging. See Adding the Widget to Your Site.
- Contact form: a simple embedded form for one way messages. See the Contact Form Setup Guide.
- Ticket center: a full inbox style center where visitors track replies. See the Ticket Center Setup Guide.
- Help center deep links: links straight into your hosted help center on
docs.helpdesky.ioor your own custom domain. - Articles by API: create and sync help articles programmatically with the REST API, including AI written content.
- Inbound email: route support email into your Helpdesky inbox. See the Email Forwarding Setup Guide.
Which platforms it works with
The skill does not assume any one builder. It works the same way across:
- Replit agent and its skills directory
- Cursor project rules and instructions
- Lovable, Bolt, and v0 project knowledge
- Google Gemini and other assistants that accept reference files
- Any other AI agent that reads instruction files before it writes code
The only thing that changes between platforms is where the file lives. The repo lists the exact location for each one.
What you need before you start
Most surfaces need nothing more than your Helpdesk ID, which you copy from your dashboard. A few need extra credentials:
- API key: required when your agent creates or syncs articles through the REST API. Generate it under Settings, API Integration.
- HMAC secret: required for a secure ticket center that ties conversations to a signed in user.
The skill explains which credential each surface needs, so your agent only asks for what the task actually requires.
How to install the skill
- Open github.com/helpdesky/helpdesky-skill and copy the
SKILL.mdfile. - Add it to your agent's skills or instructions directory. The repo notes the exact path for Replit, Cursor, Lovable, Bolt, v0, Gemini, and others.
- Ask your agent for what you want, for example "add a Helpdesky chat widget" or "let visitors open support tickets."
- Your agent reads the skill, asks for any credentials it needs, and writes the integration into your app.
That is the whole setup. After this, support features become a normal part of how you build, not a separate chore.
Which surface should you use
Pick based on how much your visitors need:
- Want a quick way for people to reach you? Use the contact form.
- Want search, AI answers, and chat in one place? Use the chat widget.
- Want visitors to track replies over time? Use the ticket center.
- Want a full public knowledge base? Publish a help center and link into it.
You can combine them. Many teams run the widget for instant help and the ticket center for longer conversations.
Start building
Add the skill once and let your agent handle Helpdesky from then on. Read the full pitch and per platform notes on the Helpdesky AI agent skill page, or go straight to the GitHub repo to grab the file.