Skills pro AI coding agenty

SmsManager skills jsou balíček znalostí pro AI coding agenty (Claude Code, Cursor, Codex a další). Po instalaci váš agent ví, jak správně používat SmsManager API — rozumí omnikanálovému flow, ID odesílatelů a aliasům, rozdílu mezi Unicode a GSM kódováním, plánování, dávkovému odesílání, doručenkám, dotazování na stav zpráv i chytákům, ve kterých se jazykové modely jinak běžně pletou. Skills jsou vrstva znalostí: učí agenta psát kód proti vašemu API. Pokud chcete, aby AI asistent za vás přímo pracoval s účtem (posílal zprávy, kontroloval doručení, spravoval klíče a kredit), připojte MCP server — vrstvu akcí. Obě vrstvy lze používat současně.

K instalaci nepotřebujete žádné přihlašovací údaje. API klíč potřebujete až ve chvíli, kdy chcete agentem vygenerovaný kód skutečně spustit a odeslat zprávu.

Zdrojový kód a aktuální verze katalogu: github.com/smsmngr/smsmanager-skills (licence Apache-2.0).

Instalace

Claude Code
skills CLI (Cursor, Codex, …)
Cursor plugin
Ručně

Nainstalujte skills jako plugin z oficiálního marketplace SmsManager. V Claude Code spusťte:

/plugin marketplace add smsmngr/smsmanager-skills
/plugin install smsmanager-skills@smsmanager

Plugin se aktualizuje přes /plugin stejně jako ostatní pluginy.

Každý agent, který podporuje skills CLI, si skills stáhne jedním příkazem:

npx skills add smsmngr/smsmanager-skills

Příkaz funguje i v Claude Code, pokud nechcete používat plugin marketplace.

Pro Cursor existuje oficiální plugin smsmngr/smsmanager-cursor-plugin, který obsahuje všech 7 skills a zároveň registruje MCP server. Nainstalujte plugin smsmanager z tohoto marketplace a získáte obě vrstvy najednou.

Zkopírujte složky z adresáře skills/ do adresáře skills vašeho agenta, například ~/.claude/skills/. Každá složka obsahuje SKILL.md a volitelné podsložky references/ a scripts/.

Používáte ChatGPT nebo Codex? Plugin smsmngr/smsmanager-chatgpt-plugin přidává čtyři workflow skills (odeslání s ověřením doručení, nastavení účtu, objednání odesílatele, denní report kampaně) nad MCP server. Je určený spíš pro práci s účtem v konverzaci než pro psaní kódu.

Co skills obsahují

Katalog má sedm skills. Každý pokrývá jednu část API a odkazuje na ostatní, takže agent si načte jen to, co pro daný úkol potřebuje.

Skill	Kategorie	Co agenta naučí
`smsmanager-authentication`	Základ	Práce s API klíčem, základní URL JSON API v2 a REST API v1, hlavička `x-api-key` vs. query parametr `apikey`, řešení chyb autentizace. Sdílený základ pro všechny ostatní skills.
`smsmanager-messaging-api`	Zprávy	Odesílání SMS, Viber, WhatsApp a RCS přes `/message`, `/message/priority`, `/messages` a `/simple/message` — omnikanálový `flow`, ID odesílatelů a aliasy, Unicode, plánování, dávky, štítky, vlastní `payload`.
`smsmanager-delivery-reports`	Zprávy	Webhooky pro stav doručení, příchozí zprávy a odpovědi (`callback` URL), stavové kódy, kódy zamítnutí, obousměrné SMS.
`smsmanager-message-status`	Zprávy	Dotazování na stav zpráv, seznam odeslaných zpráv, statistiky za požadavek či den a schránka přes REST API v1 (`/message`, `/messages`, `/request`, `/requests`, `/inbox`).
`smsmanager-optout-blacklist`	Zprávy	Správa opt-out seznamu a blacklistu — přidání a odebrání čísel, export do CSV (`/optout`, `/blacklist`).
`smsmanager-services`	Účet	Objednání placených služeb — alfanumerických odesílatelů, vyhrazených čísel, SIM hostingu — s náhledem ceny nanečisto; stav kreditu; zrušení služby (`/credit/services`, `/credit/order`, `/credit/cancel`).
`smsmanager-bulk-messaging`	Zprávy	Hromadné odeslání z JSONL souboru přes předpodepsaný upload, validace zpráv bez odeslání, zrušení naplánovaných zpráv a hromadných uploadů (`/messaging/url`, `/messaging/validate`, `/messaging/cancel`).

Struktura jednoho skillu

skills/smsmanager-<oblast>/
├─ SKILL.md        # vstupní bod — krátký, do 500 řádků
├─ references/     # podrobné podklady načítané až na vyžádání
└─ scripts/        # spustitelné Node.js skripty bez závislostí (.cjs)

SKILL.md je záměrně stručný a odkazuje na references/ (například přehled endpointů, popis jednotlivých kanálů nebo ukázky v Node.js, PHP a Pythonu). Agent tak nezahltí kontext a načte podrobnosti až ve chvíli, kdy je potřebuje. Některé skills přinášejí i hotové skripty, které agent může rovnou spustit — například send_sms.cjs, get_message_status.cjs nebo upload_bulk.cjs.

Konfigurace

Skills čtou přihlašovací údaje výhradně z proměnných prostředí. Agent je instruován, aby klíč nikdy nezapisoval do kódu.

Proměnná	Povinná	Význam
`SMSMANAGER_API_KEY`	Ano (pro reálné volání)	Váš API klíč z app.smsmanager.com/app/developers.
`SMSMANAGER_BASE_URL`	Ne	Základní URL JSON API v2. Výchozí `https://api.smsmngr.com/v2`.
`SMSMANAGER_REST_BASE_URL`	Ne	Základní URL REST API v1. Výchozí `https://rest-api.smsmngr.com/v1`.
`SMSMANAGER_SENDER`	Ne	Výchozí ID odesílatele, které agent použije, pokud ho nezadáte v promptu.

export SMSMANAGER_API_KEY="YOUR_API_KEY"
export SMSMANAGER_SENDER="MujSender"

Při vývoji můžete do SMSMANAGER_BASE_URL nastavit mock endpoint https://api-mock.smsmngr.com/v2 nebo použít testovací číslo 420777777777 — kód vygenerovaný agentem pak nic neodešle a neodečte kredit.

Jak s agentem pracovat

Skills se aktivují automaticky podle toho, co po agentovi chcete. Stačí popsat úkol běžným jazykem:

„Pošli SMS s jednorázovým kódem na 420777123456 a použij prioritní endpoint.“
„Přidej do našeho Express serveru endpoint, který přijímá doručenky ze SmsManageru a ukládá stav do databáze.“
„Zprávu pošli nejdřív přes WhatsApp šablonu a když se do 10 minut nedoručí, přejdi na SMS.“
„Vygeneruj JSONL soubor z tohoto CSV a nahraj ho jako hromadnou kampaň naplánovanou na zítra 9:00.“
„Zjisti, proč nám API vrací kód 304, a oprav to.“

Před generováním kódu si agent doplní chybějící informace (kanál, odesílatel, jazyk, zda text obsahuje diakritiku) a poté použije správný endpoint, formát čísel (E.164 bez +) a hlavičku x-api-key.

Zabudované pojistky

Skills obsahují pravidla, která chrání váš účet a kredit:

Objednávky služeb se vždy nejdřív spouštějí nanečisto (dryrun: true), agent vám ukáže celkovou cenu a čeká na potvrzení.
Vymazání celého opt-out seznamu nebo blacklistu (all: true) agent provede jen po výslovném potvrzení.
API klíč se načítá z proměnné prostředí, nikdy se nevkládá do zdrojového kódu ani do repozitáře.
Pro hromadné kampaně agent doporučí sdílený tag a callback, aby šlo výsledky dohledat.

Skills, nebo MCP server?

	Skills	MCP server
Co to je	Znalosti API pro coding agenty	Nástroje, kterými asistent operuje reálný účet
Typický úkol	„Napiš integraci, která…“	„Pošli zprávu, zkontroluj kredit, vytvoř klíč…“
Přihlášení	Není potřeba (API klíč až pro spuštění kódu)	OAuth přihlášení do SmsManageru, bez API klíčů
Kde běží	Lokálně ve vašem agentovi	Hostovaný server SmsManager
Vhodné pro	Vývojáře píšící vlastní integraci	Provozní práci s účtem v konverzaci

Vývojářům doporučujeme obojí: skills pro psaní kódu, MCP server pro rychlé ověření, že zpráva odešla, nebo pro vytvoření sub-klíče pro novou integraci.

Verze a aktualizace

Skills se publikují přímo z repozitáře — sloučení do větve main znamená vydání. Aktuální verzi katalogu a změny jednotlivých skills najdete v CHANGELOG.md. Aktualizaci provedete opakovanou instalací (/plugin v Claude Code, případně znovu npx skills add). Všechna fakta ve skills odpovídají této dokumentaci. Pokud narazíte na nesrovnalost, otevřete issue v repozitáři.

Další kroky

MCP server

Připojte AI asistenta přímo k vašemu účtu — odesílání, stav doručení, klíče, kredit a služby.

Autentizace

Kde získat API klíč a jak ho bezpečně předávat v požadavcích.

Testování napojení

Testovací číslo, testovací brána a mock endpointy pro kód generovaný agentem.

JSON API v2

Referenční specifikace endpointů, ze které skills vycházejí.

Odesílání zpráv

Příjem a ověření

Testování

AI asistenti

Přístup a klíče

Instalace

Co skills obsahují

Struktura jednoho skillu

Konfigurace

Jak s agentem pracovat

Zabudované pojistky

Skills, nebo MCP server?

Verze a aktualizace

Další kroky

MCP server

Autentizace

Testování napojení

JSON API v2

​Instalace

​Co skills obsahují

​Struktura jednoho skillu

​Konfigurace

​Jak s agentem pracovat

​Zabudované pojistky

​Skills, nebo MCP server?

​Verze a aktualizace

​Další kroky

MCP server

Autentizace

Testování napojení

JSON API v2

Instalace

Co skills obsahují

Struktura jednoho skillu

Konfigurace

Jak s agentem pracovat

Zabudované pojistky

Skills, nebo MCP server?

Verze a aktualizace

Další kroky