Przejdź do treści
Biblioteka skilli
Sprzedaż i obsługa klienta · Integracja z narzędziem

smooth-operator

/smooth-operator

Wykonuje akcje organizacyjne w Smoo AI przez CLI: szkice maili, kontakty CRM, szablony i analitykę.

Repozytorium
smooth ↗
Licencja
MIT
Ostatnia zmiana repozytorium
27.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Wykonuje akcje organizacyjne w Smoo AI przez CLI: szkice maili, kontakty CRM, szablony i analitykę.

Wyzwalacze z opisu

email this leadadd a contacthow many conversations last weekdraft a follow-up
Oryginalny opis (EN)

Drive the user's Smoo AI org Smooth Operator from the CLI via `smoo api smooth-operator chat` — draft/send email, create/search CRM contacts, generate templates, query analytics, search the knowledge base. Use when the user asks for an org-level action ("email this lead", "add a contact", "how many conversations last week", "draft a follow-up") rather than a code change. Handles the confirm-before-execute flow for destructive actions (email send) safely.

Jak działa

  1. When to use this
  2. Auth
  3. The commands
  4. The confirm flow (destructive actions — READ THIS)
  5. Notes
Sekcje z nagłówków SKILL.md, w oryginale · 90 linii, 587 słów
Podgląd SKILL.md
---
name: smooth-operator
description: Drive the user's Smoo AI org Smooth Operator from the CLI via `smoo api smooth-operator chat` — draft/send email, create/search CRM contacts, generate templates, query analytics, search the knowledge base. Use when the user asks for an org-level action ("email this lead", "add a contact", "how many conversations last week", "draft a follow-up") rather than a code change. Handles the confirm-before-execute flow for destructive actions (email send) safely.
---

# smooth-operator — drive the org's dashboard agent from `th`

The Smoo AI **Smooth Operator** is the always-on agent inside the SmooAI dashboard.
It acts on the _org's own_ data on behalf of an operator: searching the
knowledge base, looking up and creating CRM contacts, querying analytics,
generating content/templates, and drafting + (on confirmation) sending email.
`smoo api smooth-operator` is the headless bridge to it — reach for it when the user
wants an **org action**, not a code change.

## When to use this

Use `smoo api smooth-operator chat` when the ask is an org operation, e.g.:

- "Draft a follow-up email to jane@acme.com" → smooth-operator drafts it
- "Send that email" → smooth-operator pauses on a **destructive** action (see confirm flow)
- "Add John Doe (john@acme.com) as a contact" → `crm.create_contact`
- "Find contacts named Jane" → `crm.search_contacts`
- "How many conversations did we handle last week?" → `analytics.ask`
- "Generate a welcome-email template" → `templates.generate`
- "What does our knowledge base say about refunds?" → `knowledge.search`

Do **not** use it for code changes, deploys, or anything the other `th`
subcommands already do (`th pearls`, `th worktree`, `smoo api agents`, …).

## Auth

Smooth Operator routes are user-authed. Run `smoo auth login` once (Supabase user
session); the CLI auto-refreshes. It 401s under an M2M client. The org is the
active org, or pass `--org <id>` / set `SMOOAI_ORG_ID`.

## The commands

```bash
# Start a conversation (prints reply + a compact "ran <tool>" line per tool call)
smoo api smooth-operator chat "Find contacts named Jane and draft a follow-up email"

# Continue it — pass the conversationId from the previous turn
smoo api smooth-operator chat "Make it warmer" --conversation <conversation-id>

# Machine-readable turn result (conversationId, reply, toolCalls, pendingAction)
smoo api smooth-operator chat "..." --json

# Read a conversation back
smoo api smooth-operator history <conversation-id>
```

## The confirm flow (destructive actions — READ THIS)

Destructive tools (currently **`email.send`**) never auto-run. When a turn
triggers one, the response carries a `pendingAction` and the loop pauses. How
`th` resolves it:

- **On a TTY (a human is watching):** you get a `Approve email.send — …?` y/N
  prompt. Default is **No**.
- **Non-interactively (you, the agent):** you must decide _up front_ with a flag:
    - `--confirm` — auto-approve any destructive action this turn triggers
    - `--no-confirm` — auto-decline it
    - **no flag** → `th` prints the pending action and **stops without running
      it** (it does not guess). This is the safe default.

**Rules for agents:**

- **Never pass `--confirm` by default.** Only add it when the user has
  explicitly authorized _this_ send (e.g. "yes, send it").
- To inspect first, then decide, run the chat **without** a flag, read the
  printed `pendingAction` (or use `--json`), and — if authorized — confirm the
  _same_ conversation without resending the message:

    ```bash
    smoo api smooth-operator chat "Send the follow-up to jane@acme.com"   # pauses, prints the pending email.send
    # ...user confirms they want it sent...
    smoo api smooth-operator confirm <conversation-id> --approve          # runs it
    smoo api smooth-operator confirm <conversation-id> --decline          # or drop it
    ```

- When the user has already said "send it" in the same breath, the one-shot
  form is fine:

    ```bash
    smoo api smooth-operator chat "Send jane@acme.com the follow-up email" --confirm
    ```

## Notes

- Responses are **buffered** (no token streaming yet — phase 2 on the backend).
- Each tool run is audit-logged against the logged-in user.
- Tool availability is gated by org entitlements (e.g. CRM tools need the `crm`
  feature; `email.send` needs a configured email integration).

Wersje

W bazie nie ma innych skilli o nazwie smooth-operator.

Migawka bazy z 13.11.2026 · wersja paczki fd2a1c226196 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100softsync-email
    Pisze szablony e-maili w SoftSync i wysyła je do jednego kontaktu albo całej listy, a także śledzi lub anuluje wysyłkę.
  • 100hubspot
    Przeszukuje, czyta, tworzy i aktualizuje kontakty, firmy i szanse sprzedażowe w HubSpot oraz dodaje notatki, bez wysyłania maili i kasowania.
  • 95openses
    Wysyła i odbiera e-maile przez OpenSES na własnym Amazon SES, obsługuje skrzynkę, kontakty i szablony.
  • 90cold-email-draft
    Przygotowuje szkice zimnych maili i sekwencji do przeglądu, bez wysyłania, planowania i scalania korespondencji.
  • 90contacts-and-crm
    Zamienia imię lub fragment adresu na prawdziwy e-mail i dodaje kontekst CRM, np. HubSpot lub Apollo, przed odpowiedzią.
  • 90working-in-flito
    Pracuje w CRM Flito przez narzędzia Flito: klienci, firmy, kontakty, szanse sprzedaży, oferty, faktury i zadania.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.