Developer tools & API

Agent skill

The telmoni skill: what it teaches a coding agent about Telmoni, and how to install it in Claude Code, Codex, Cursor, Antigravity, OpenCode and other agents that read SKILL.md.

The agent skill, telmoni/skills, teaches a coding agent to work with Telmoni on your behalf: to record your agents' runs with the SDKs, and its own sessions with its plugin, drive the CLI, call the read-only API with an API key, build and test a receiver for signed webhooks, and self-host with Docker Compose or Kubernetes. It sends the agent to these pages for the details, and adds what the pages alone don't give it: which path fits which situation, the mistakes agents make, and the guardrails around keys and your infrastructure. The skill itself sends nothing: a session is recorded by the plugin, once you install it.

Every install below fetches the repository's release branch, which holds only what an agent loads: the plugin manifests, the skill, LICENSE and NOTICE.

Claude Code

In Claude Code:

/plugin marketplace add telmoni/skills@release
/plugin install telmoni@telmoni

From a shell, the same is:

$ claude plugin marketplace add telmoni/skills@release
$ claude plugin install telmoni@telmoni

The skill loads by itself when a task involves Telmoni, and /telmoni:telmoni calls it by name. Claude Code doesn't update a third-party marketplace on its own: claude plugin update telmoni@telmoni fetches the latest, or turn on auto-update for it under /plugin → Marketplaces.

Codex

$ codex plugin marketplace add telmoni/skills@release
$ codex plugin add telmoni@telmoni

Cursor

The skill is not in the Cursor Marketplace yet. Until it is, clone it into Cursor's local plugins folder, then restart Cursor or run Developer: Reload Window:

$ git clone --depth 1 --branch release https://github.com/telmoni/skills.git ~/.cursor/plugins/local/telmoni

git pull in that folder, then a reload, brings a newer version. Cursor skips a symlink to a clone elsewhere, so clone into the folder itself. On Teams and Enterprise plans, an admin allows local plugins with Allow Local Plugin Imports, which is off by default on Enterprise.

Antigravity

The agy CLI installs a clone as a plugin, for the IDE and the CLI alike:

$ git clone --depth 1 --branch release https://github.com/telmoni/skills.git telmoni-skills
$ agy plugin install ./telmoni-skills

git pull in the clone, then the same install again, brings a newer version.

OpenCode, GitHub Copilot, Gemini CLI and others

The skills CLI installs the skill into the agents it finds in your project; -a picks one (opencode, cursor, github-copilot, gemini-cli, …), and -g installs it for your user instead:

$ npx skills add https://github.com/telmoni/skills/tree/release

By hand, clone the release branch and link skills/telmoni into your agent's skills folder: ~/.claude/skills/ for Claude Code, ~/.agents/skills/ for Codex, Cursor, Copilot and Gemini CLI, ~/.config/opencode/skills/ for OpenCode, or ~/.gemini/config/skills/ for Antigravity.

Before you start

  • Keys stay out of the chat. Put an API key in TELMONI_API_KEY, and a webhook signing secret in your secret store, before you start: the skill has the agent check that a key is set, and never ask for or print one.
  • Self-hosted? Set TELMONI_ENDPOINT to your deployment's machine host; without it, the CLI and the SDKs talk to https://api.telmoni.com.
  • The CLI is optional: the skill installs it when a task needs it, with your go-ahead.