Integrations
Agent skill
The telem-search agent skill teaches your coding agent to
call the Telem API directly. It is one page that your agent reads when a task needs the
live web. Nothing is installed into your agent.
Want native tools instead? The installer adds Telem to the coding
agents you have, with telem_search and telem_fetch as tools, and a record of each
session in the console. This page is the lightweight path.
Before you begin
Section titled “Before you begin”Create a Telem API key
- Open your project
- API keys
- Issue API key
tlm_••••••••••••••••Keys start with tlm_.
Never paste a key into a chat with your agent. Every path below sets it for you.
Install
Section titled “Install”Teach your agent the Telem API
-
Add the skill. The command installs
telem-searchfor your agent.Terminal window npx skills add https://docs.telem.ai -
Set your key in the shell that starts your agent. The skill tells the agent to read it from the environment at call time.
Terminal window export TELEM_API_KEY=tlm_your_key -
Ask your agent to search. For example: “Search the web with Telem for the latest PostgreSQL release.” The agent reads the skill and calls
POST /v1/search.
What your agent learns
Section titled “What your agent learns”The skill is a single SKILL.md. It teaches your agent these things:
- When to search, and when not to. An answer already in the model’s weights is a reason not to spend a search. So are a private corpus and a URL that the agent already has.
- The request.
POST https://router.telem.ai/v1/search, with the query inuser_inputand everything else in the optionalsearchblock. The skill shows it in curl, TypeScript and Python. - How to read the response. The response has one entry per provider under
preprocessor_runs. Each entry has its own normalized response,statusanderror. So when one provider fails, you get a partial result, and the request does not fail. The skill also shows the flatten-and-merge pass that turns those entries into one list. - How to write a query. The providers use two retrieval styles, so a full natural-language sentence works better than a keyword fragment.
- The cost options.
tier,num_results, and why an explicitsearch.providers.includemakes the price of a call your decision. warnings[]and the error table. Which statuses to retry, and which ones give the same failure again.- Reading one known URL with
POST /v1/fetch, instead of a search for a page that the agent can already name.
The skill tells the agent to read the key from the environment at call time. It also tells the agent never to do these things with the key:
- hardcode it
- commit it
- print it into a snippet
- send it to a browser
You can read the same page yourself: SKILL.md.
How discovery works
Section titled “How discovery works”npx skills add https://docs.telem.ai fetches
https://docs.telem.ai/.well-known/agent-skills/index.json and finds the telem-search
entry. Then it downloads the SKILL.md beside it, at
/.well-known/agent-skills/telem-search/SKILL.md. Some hosts have their own remote-skill
registries, OpenCode for example. They read the same two files.
If your host installs skills another way, point it at either URL directly. The skill is a plain Markdown file with YAML frontmatter. It has no dependencies, no scripts and no install step.
What you give up
Section titled “What you give up”| Agent skill | Installer | |
|---|---|---|
| Search available to the agent | yes, as HTTP the model writes | yes, as a native telem_search tool |
| Page fetch | the skill teaches POST /v1/fetch |
telem_fetch, a native tool |
| Results rendered with provider attribution | your code does it | the plugin does it |
| Retrieval metrics and trajectory analytics | no | yes |
| Touches your framework config | no | yes |
A plugin gives the model better tools. It also gives you a record of what the model searched for.
Update and remove
Section titled “Update and remove”To update the skill:
npx skills update telem-searchTo remove it:
npx skills remove telem-searchA skill costs nothing to remove, and it does not change how your agent runs.
Learn more
Section titled “Learn more”Every endpoint the skill describes.
What each search option does, from tiers to date windows.
Every request option and its limit.
Every error the API returns, and what to do.