Skills that let your AI agent operate and grow FreeTicket — the LATAM (Colombia-first) ticketing platform.
Drive the ft CLI, read and mutate real account data, and write/audit events in
FreeTicket's brand voice. Installable with npx skills for
Claude Code, Cursor, and any agent that reads markdown skills.
# Install a specific skill (recommended)
npx skills add AppFreeticket/agent-skills@freeticket-cli
npx skills add AppFreeticket/agent-skills@freeticket-eventos
# List what's in the repo
npx skills add AppFreeticket/agent-skills -lSkills install into ~/.claude/skills/ (global) or the project's .claude/skills/.
The agent loads each skill's name + description and opens the body only when
your prompt matches it (progressive disclosure).
Skills are markdown files that give an AI agent focused knowledge and
workflows. Add them to your project; the agent picks the right skill from your
prompt and applies it — here, that means knowing how to drive the ft CLI, what
FreeTicket's product rules are, and how to write copy in the right voice. They
turn a general agent into one that can actually operate your FreeTicket workspace.
These are plain markdown following the Agent Skills spec — not tied to one vendor. Use them in any AI coding tool or assistant:
- Native skill support (auto-loaded): Claude Code, Cursor, Windsurf, Cline,
and any agent that reads a
skills/directory — install withnpx skills add …. - OpenAI Codex / Cursor / any AGENTS.md-based agent: point the agent at the
SKILL.md(or reference it from yourAGENTS.md), e.g.See skills/freeticket-cli/SKILL.md for how to drive the ft CLI.The agent reads it as context and runs thenpx @freeticket/cli@latestcommands from the terminal — no plugin needed. - Anything else (ChatGPT, Claude.ai, Gemini, Copilot Chat, v0, Bolt, Lovable…):
paste the relevant
SKILL.mdinto the chat as context. The CLI runs the same everywhere vianpx @freeticket/cli@latest <command>— no install, no lock-in.
The only requirement is a terminal where the agent (or you) can run npx.
2 skills. They compose: freeticket-eventos calls freeticket-cli to pull
live data before it audits.
| Skill | Scope | Install |
|---|---|---|
freeticket-cli |
Drive the official ft CLI (@freeticket/cli): log in (browser device flow), list/inspect and create/update/delete events, dates, ticket types, sales, membership plans, venues, staff; publish events; cancel/refund sales; run CFO reconciliation; export anything to CSV. Superadmin via ft admin …. --json/--csv for automation. |
npx skills add AppFreeticket/agent-skills@freeticket-cli |
freeticket-eventos |
Event & community advisor: applies FreeTicket's brand voice and real product rules (visibility, member-gated presales, platform fee, time zone, required ticket fields), and audits events with live data (via ft) to recommend sales and retention improvements. |
npx skills add AppFreeticket/agent-skills@freeticket-eventos |
Ask your agent in natural language — it picks the right skill. Examples:
| You say | Skill |
|---|---|
| "How many sales do I have?" / "List my events" / "Export buyers" | freeticket-cli |
| "Create an event" / "Publish it" / "Refund sale X" / "Raise a ticket price" | freeticket-cli |
| "Run the CFO reconciliation" / "Suspend a tenant" / "Set a feature flag" | freeticket-cli (incl. ft admin …) |
"Automate this report" / "Give me --json for jq" / "Configure my API key" |
freeticket-cli |
| "Write the description for this event" / "Improve my event copy" | freeticket-eventos |
| "Why isn't this event selling?" / "Audit my event" | freeticket-eventos (pulls data via ft) |
| "How do I grow and retain my audience?" / "Recommend a presale strategy" | freeticket-eventos |
The skill instructions are in English for global reuse, but the
buyer-facing copy freeticket-eventos produces is in neutral Spanish
(tú / impersonal, never voseo) — FreeTicket is a LATAM, Colombia-first platform.
See references/language.md.
agent-skills/
└── skills/
├── freeticket-cli/
│ ├── SKILL.md
│ └── references/commands.md
└── freeticket-eventos/
├── SKILL.md
└── references/
├── language.md # brand voice, neutral-Spanish copy
└── audit.md # pull data with ft + heuristics + community
- CLI:
@freeticket/cli(binaryft) - B2B API v1: OpenAPI 3.1 contract at
GET /api/v1/openapi.json
MIT © FreeTicket