New: 97,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Dial Phone CLI

by nanocoai in nanocoai/nanoclaw

Reference for the dial CLI, which gives an agent a real phone number to send SMS, place AI voice calls and wait for inbound texts or verification codes.

MITAuto-check passedProductivity & Automation

Install Dial Phone CLI

skills CLI
$ npx skills add nanocoai/nanoclaw --skill dial-cli -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install nanocoai/nanoclaw dial-cli --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/nanocoai/nanoclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/add-dial-tool/container-skills/dial-cli .claude/skills/dial-cli && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
dial-cli
GitHub stars
31k
Token cost
~2k tokens
SKILL.md length
912 words
Files
1
Skills in repo
59
Repo updated
First seen
Licence
MIT

At a glance

Reference for the dial CLI, which gives an agent a real phone number to send SMS, place AI voice calls and wait for inbound texts or verification codes.

  • A user asks the agent to text or call someone
  • SKILL.md covers This is a sandbox, Orient yourself before each…, Searching for what the CLI /… and Workflow shapes worth knowing, plus 2 more sections
  • Calls curl; reaches docs.getdial.ai
  • Waiting for a one-time passcode or verification code sent by SMS

What it does

Dial is a communication service for AI agents, and its CLI wraps the REST API for texting, voice calls handled by an AI voice agent, number management and waiting on inbound events. In the NanoClaw sandbox described here, the account, number and credentials are already provisioned and the API key is injected at the network boundary, so the agent never asks for or reads a key.

Rather than listing flags, the skill tells the agent to run help for each new command before using it, and to pass the json option when it needs machine-readable output. For anything beyond local help it points to the published docs, including a single concatenated text file that can be searched with grep. If the CLI is missing, the agent reports an image installation problem and does not try to install it.

When your agent uses it

  • A user asks the agent to text or call someone
  • Waiting for a one-time passcode or verification code sent by SMS
  • Checking what the Dial platform can do before running a dial command

Example prompts

  • “Send a text to my colleague saying the build is ready for review.”
  • “Wait for the verification code that the signup form sends to our number and tell me what it is.”
  • “Place a voice call to the venue and ask whether they have a table for the group tonight.”

Requirements

  • The dial CLI installed in the sandbox
  • A pre-provisioned Dial account and phone number

What it can do on your machine

Read from SKILL.md and the folder at commit 66f0823. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • docs.getdial.ai

    Also links to:

    • getdial.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Dial Phone CLI loads about 2k tokens when it runs. Until then it costs about 158 tokens; SKILL.md has 912 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~158
When it runs · the whole SKILL.md, loaded when a task matches
~2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from nanocoai/nanoclaw at commit 66f0823, republished under its MIT licence (© nanocoai). 912 words, ~2,042 tokens.

Download SKILL.mdSave it as .claude/skills/dial-cli/SKILL.md (or your agent's skills folder).
name
dial-cli
description
Reference for the `dial` CLI — gives you a real phone number to send SMS, place AI voice calls, and receive inbound texts/codes via the Dial platform (getdial.ai). Use when the user mentions phones, calls, texts, SMS, voice, OTP, 2FA, or verification codes; when they ask to text, call, ring, or wait for a code from someone; before running any `dial …` command for the first time in a session; or when investigating what the Dial platform can do. Load this skill before invoking the CLI — `dial --help` alone will not surface the workflows, the `--json` conventions, or the docs-lookup pattern needed to use Dial correctly.

Dial CLI

dial is the official CLI for Dial — a Communication Stack for AI Agents. It wraps the Dial REST API so you can send SMS, place voice calls handled by an AI voice agent, manage numbers, and wait for inbound events — all without writing HTTP code.

The first time the user asks you to "text someone," "call someone," "receive a code," or anything else phone-shaped, reach for dial.

This is a sandbox

You are running inside a pre-provisioned, ephemeral environment:

  • The account, number, and credentials are already set up — you have a working phone number ready to use. There is nothing to configure.
  • You never handle credentials. The API key is injected automatically at the network boundary; the CLI runs keyless here. Never ask the user for a key, and never try to read or write an auth file.
  • Just use the workflows below — send SMS, place calls, wait for inbound events. Inbound event delivery is managed for you; dial --help shows what's available here.

If dial is somehow missing (command -v dial returns nothing), that is an installation bug in this image, not something for you to fix — report it to the operator ("the Dial CLI isn't installed in this container") rather than improvising an install.

Orient yourself before each new verb

This skill does not enumerate every flag. The CLI is the source of truth — when you encounter a verb you have not used in this session, run its --help first:

bash
dial --help                    # available commands
dial <command> --help          # flags + usage for a specific command
dial <command> <sub> --help    # subcommand-level help

Examples worth running on first use: dial doctor --help, dial message --help, dial call --help, dial call get --help, dial wait-for --help.

Every command supports --json for machine-readable output — prefer it when piping into jq or parsing the result programmatically.

Searching for what the CLI / API can do

For anything beyond what --help shows on the local CLI, the canonical reference is the published docs. Two endpoints make this fast:

Capability search — llms-full.txt

A single concatenated markdown file of the whole docs site. Grep it directly for the keyword you care about:

bash
curl -fsSL https://docs.getdial.ai/llms-full.txt | grep -i -B2 -A8 'whatsapp'
curl -fsSL https://docs.getdial.ai/llms-full.txt | grep -i -B1 -A5 'language'

Use this when you want to know if Dial supports something, or which command / endpoint covers it — without reading the whole site.

Deep dive — sitemap.xml + per-page .md

When you need to read a page in detail, use the sitemap to discover URLs, then fetch the .md companion of any page — same content as the HTML page but plain markdown, faster to scan.

bash
# 1. Discover available pages
curl -fsSL https://docs.getdial.ai/sitemap.xml | grep -oE 'https://docs\.getdial\.ai/[^<]+'

# 2. For any page like https://docs.getdial.ai/documentation/get-started/introduction
#    fetch the .md companion:
curl -fsSL https://docs.getdial.ai/documentation/get-started/introduction.md

The rule is one-to-one: every page at https://docs.getdial.ai/<path> has a markdown twin at https://docs.getdial.ai/<path>.md.

Show full SKILL.md (500 more words)Show less

Workflow shapes worth knowing

These are the verbs you will most often compose. Read the relevant .md page for the full story; the one-liners below are signposts.

  • Send an SMS — dial message --to +14155550123 --body "..." (send-an-sms.md)
  • Show a typing indicator while composing — dial typing start --to-number +14155550123; sending a message clears it natively, so start again between messages, and dial typing stop --to-number +14155550123 if you end up not sending. iMessage numbers display it; SMS numbers ignore it, so it's always safe to call (commands.md)
  • Place a voice call — dial call --to +14155550123 --outbound-instruction "..." then dial call get <id> once it ends. Add --voice-gender male|female to choose the agent's voice (default: female) (place-a-voice-call.md)
  • Buy an additional number — dial number purchase --inbound-instruction "..." --explicit-programmatic-consent "<attestation>". --explicit-programmatic-consent is required: a short attestation that the account holder consented to provisioning programmatically. Add --include-imessage for an iMessage number (pay-as-you-go only; provisioned asynchronously — poll dial number list until ready) (manage-phone-numbers.md)
  • Set a number's inbound behavior or nickname — dial number set +14155550123 --inbound-instruction "..." and/or --inbound-language es-ES and/or --nickname "Support line" (at least one flag; --nickname "" / --inbound-language "" clear). The inbound instruction is the system prompt the AI uses on calls into that number. The inbound language pins inbound calls to one language — unset, the AI detects the caller's language from their country prefix (alongside en-US). The nickname is a human-readable label for telling numbers apart (manage-phone-numbers.md)
  • Receive a verification code (2FA) — dial wait-for message.received -f channel=sms and parse the body (receive-inbound-sms.md)
  • React to a call ending — dial wait-for call.ended -f callId=<id>. Fires however the call ends — completed, failed, or cancelled — carrying the terminal status and a canceled flag, so the wait always resolves (stream-account-events.md)

dial wait-for long-polls the Dial API directly, so it works here without any background daemon.

Conventions

  • --json everywhere for parseable output.
  • Always pass --from-number with this install's wired line (stated at the end of this file if the channel is set up). This sandbox has no saved default sender — defaultNumberId is null here — so an omitted selector fails outright. Never pick one from dial number list instead: on a multi-number account that list is ordered newest-first, which is unrelated to the line this install is wired to, so a number chosen from it reaches nobody and replies to it are dropped. If no line is stated below and the user hasn't named one, ask rather than guess.
  • Phone numbers are E.164 (+14155550123). Reject anything else before calling Dial.
  • Writes (message, call, number purchase) are not idempotent — on an ambiguous failure, list first to check before retrying.

When a call fails auth (401 / 403)

You run keyless — the gateway injects the credential, so neither error is something you can fix from here. A 403 blocked_by_policy means the operator chose not to give this agent Dial access: say so plainly and stop. A 401 means the operator's Dial credential is missing or invalid in the vault: tell the operator the Dial credential needs (re)connecting. In both cases stop and wait rather than retrying in a loop.

© nanocoai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/add-dial-tool/container-skills/dial-cli of nanocoai/nanoclaw.

Open the folder on GitHubat commit 66f0823

Compare with similar skills

Dial Phone CLI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Dial Phone CLI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dial Phone CLI this skillnanocoai/nanoclaw31k—~2kAutomated safety check: PassMIT
Slack Browser Automationvercel-labs/agent-browser44k1 repos~2.1kAutomated safety check: PassApache-2.0
She Love Me863401402/she-love-me9141 repos~1.3kAutomated safety check: PassMIT
Claude To Imop7418/Claude-to-IM-skill2.9k—~3.4kAutomated safety check: NotesMIT
Last30days CnJesseovo/last30days-skill-cn1.9k—~2.4kAutomated safety check: NotesMIT
Huashu Wechat Imagealchaincyf/huashu-skills1.7k1 repos~2.4kAutomated safety check: NotesMIT

Similar skills

  • Slack Browser Automation

    vercel-labs/agent-browser

    Official

    Drives the Slack web app with the agent-browser CLI to check unread channels, search, read channel details and extract information, with screenshots as evidence.

    44k GitHub starsUsed in 1 repo~2.1k tokens
    Productivity & AutomationAuto-check passed

  • She Love Me

    863401402/she-love-me

    Acquire, import, and analyze WeChat or QQ chat histories, including installing supported exporters, guiding required login or contact selection, converting exports, assessing relationship dynamics…

    914 GitHub starsUsed in 1 repo~1.3k tokens
    Productivity & AutomationAuto-check passed

  • Claude To Im

    op7418/Claude-to-IM-skill

    Bridge THIS Claude Code or Codex session to Telegram, Discord, Feishu/Lark, QQ, or WeChat so the user can chat with Claude from their phone.

    2.9k GitHub stars~3.4k tokensUpdated 6 mo ago
    Productivity & AutomationAuto-check: notes

  • Last30days Cn

    Jesseovo/last30days-skill-cn

    Research what Chinese internet users actually said in the last 30 days across Weibo, Xiaohongshu (RED), Bilibili, Zhihu, Douyin, WeChat public accounts, Baidu and Toutiao: engagement-weighted…

    1.9k GitHub stars~2.4k tokensUpdated today
    Productivity & AutomationAuto-check: notes

  • Huashu Wechat Image

    alchaincyf/huashu-skills

    为微信公众号文章生成高质量配图。支持封面图（2.35:1）、正文插图（16:9/4:3）、信息图。提供两条路径：AI生成（视觉创意型）和HTML渲染（文字精确型）。当用户提到"公众号配图"、"公众号封面"、"文章配图"、"正文插图"、"公众号图片"时使用此技能。

    1.7k GitHub starsUsed in 1 repo~2.4k tokens
    Productivity & AutomationAuto-check: notes

  • Instagram Skill

    supreme-gg-gg/instagram-cli

    How to use Instagram CLI to interact with Instagram from the command line on behalf of a user.

    2.2k GitHub stars~1.4k tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed

More from nanocoai/nanoclaw

All 59 skills in this repo

  • Iron Proxy Gateway for NanoClaw

    nanocoai/nanoclaw

    Installs or refreshes Iron Proxy and its Iron Control web console for NanoClaw, with a local Docker setup, database, credentials and a human approval bridge.

    31k GitHub stars~4.6k tokensUpdated yesterday
    Auto-check: notes

  • Agent Browser

    nanocoai/nanoclaw

    Drives a web browser from the shell with the agent-browser CLI: open pages, read an element snapshot, click and fill by reference, grab text and screenshots.

    31k GitHub starsUsed in 3 repos~1.6k tokens
    Auto-check passed

  • NanoClaw OneCLI Gateway Installer

    nanocoai/nanoclaw

    Installs or refreshes OneCLI as the gateway provider for NanoClaw, copying the adapter files, registering the provider and running the setup script.

    31k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check: notes

  • OpenClaw to NanoClaw Migration

    nanocoai/nanoclaw

    Guides a conversational migration from an OpenClaw install to NanoClaw v2, carrying over identity, channel credentials, scheduled tasks and workspace files.

    31k GitHub stars~6k tokensUpdated yesterday
    Auto-check: notes

  • Add A Second Dial Phone Number

    nanocoai/nanoclaw

    Wires up an additional phone number onto an already-installed Dial channel, so one NanoClaw install answers SMS and AI voice calls on more than one line.

    31k GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed

  • NanoClaw LLM Wiki Setup

    nanocoai/nanoclaw

    Adds a persistent wiki knowledge base to a NanoClaw group following Karpathy's LLM Wiki pattern, with folders, a tailored container skill and a CLAUDE.md section.

    31k GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed

Categories

Questions about Dial Phone CLI

What does Dial Phone CLI do?

Reference for the dial CLI, which gives an agent a real phone number to send SMS, place AI voice calls and wait for inbound texts or verification codes. Dial is a communication service for AI agents, and its CLI wraps the REST API for texting, voice calls handled by an AI voice agent, number management and waiting on inbound events. In the NanoClaw sandbox described here, the account, number and credentials are already provisioned and the API key is injected at the network boundary, so the agent never asks for or reads a key.

When should I use Dial Phone CLI?

Dial Phone CLI fits situations like: A user asks the agent to text or call someone; waiting for a one-time passcode or verification code sent by SMS; checking what the Dial platform can do before running a dial command.

How do I install Dial Phone CLI in Claude Code?

Run `npx skills add nanocoai/nanoclaw --skill dial-cli -a claude-code`. Or copy the skill folder (.claude/skills/add-dial-tool/container-skills/dial-cli in nanocoai/nanoclaw) into .claude/skills/dial-cli in your project. Claude Code loads it when a task matches its description.

How do I install Dial Phone CLI in Codex?

Run `npx skills add nanocoai/nanoclaw --skill dial-cli -a codex`. Or copy the skill folder (.claude/skills/add-dial-tool/container-skills/dial-cli in nanocoai/nanoclaw) into .agents/skills/dial-cli in your project. Codex loads it when a task matches its description.

Can I use Dial Phone CLI in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add nanocoai/nanoclaw --skill dial-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dial-cli, .gemini/skills/dial-cli, .github/skills/dial-cli and .opencode/skills/dial-cli in your project.

What does Dial Phone CLI need to run?

Going by SKILL.md and its folder, Dial Phone CLI needs the command-line tools its instructions call (curl). Our summary lists: The dial CLI installed in the sandbox; A pre-provisioned Dial account and phone number.

Does Dial Phone CLI access the network?

SKILL.md names 2 domains. In commands or code: docs.getdial.ai; the agent is likely to contact it when it follows the instructions. As links in the text: getdial.ai. This is read from the text; nothing was executed.

Is Dial Phone CLI safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Dial Phone CLI use?

Dial Phone CLI is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Dial Phone CLI use?

About 2k tokens (SKILL.md is roughly 8.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Dial Phone CLI?

Skills that share tags, products or a category with Dial Phone CLI: Slack Browser Automation (vercel-labs/agent-browser, 44k stars), She Love Me (863401402/she-love-me, 914 stars), Claude To Im (op7418/Claude-to-IM-skill, 2.9k stars) and Last30days Cn (Jesseovo/last30days-skill-cn, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dial Phone CLI?

nanocoai (a GitHub organization) maintains it in nanocoai/nanoclaw, which has 30,883 GitHub stars. The repository holds 59 skills in this directory. The repository was last updated on October 6, 2026.

Source: nanocoai/nanoclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.