Agent skills
Install FreeTicket's open-source agent skills so your coding agent or assistant knows how to drive the CLI, the MCP server and FreeTicket's event rules.
Skills are Markdown files that give an AI agent focused knowledge: which command or tool to use, the product rules, and the workflows that work. FreeTicket publishes three skills, MIT-licensed, in AppFreeticket/agent-skills. They follow the Agent Skills specification.
| Skill | Teaches the agent to |
|---|---|
freeticket-cli |
Drive ft: log in, read and write events, dates, ticket types, sales, plans, venues and staff, publish, cancel and refund, reconcile, and export to CSV or JSON |
freeticket-mcp |
Connect to the MCP server, understand its credential layers, and choose the right tool among the catalog |
freeticket-eventos |
Write and audit events with FreeTicket’s rules and voice, using live data from your workspace to recommend improvements |
The skill instructions are in English. Buyer-facing copy from freeticket-eventos is written in neutral Spanish.
Install
Install one skill with npx skills:
npx skills add AppFreeticket/agent-skills@freeticket-cli
npx skills add AppFreeticket/agent-skills@freeticket-mcp
npx skills add AppFreeticket/agent-skills@freeticket-eventos
List what is available:
npx skills add AppFreeticket/agent-skills -l
Skills install into your agent’s skills directory, globally or per project. The agent reads each skill’s name and description, and loads the full body only when your request matches.
Claude Code plugin
The repository is also a plugin. It installs the three skills and wires the hosted MCP server, which signs you in through the browser the first time you use it:
/plugin marketplace add AppFreeticket/agent-skills
/plugin install freeticket@freeticket
The same manifests follow the Agent Plugins standard, so other compatible clients can read them.
Agents without skill support
For agents that read AGENTS.md, or chat assistants without skills, point the agent at the relevant SKILL.md, or paste it in as context. The CLI runs anywhere with Node.js through npx @freeticket/cli@latest <command>.
Example requests
| You say | Skill |
|---|---|
| “List my events” / “Export buyers for Saturday” | freeticket-cli |
| “Create an event and publish it” / “Refund sale X” | freeticket-cli |
| “Add FreeTicket to Claude” / “Which tool refunds a sale?” | freeticket-mcp |
| “Write the description for this event” | freeticket-eventos |
| “Why isn’t this event selling?” | freeticket-eventos, with live data |

