Skip to content

skill: stronger description for trigger discovery#1

Merged
ofekby merged 1 commit into
mainfrom
improve-skill-description
May 31, 2026
Merged

skill: stronger description for trigger discovery#1
ofekby merged 1 commit into
mainfrom
improve-skill-description

Conversation

@ofekby
Copy link
Copy Markdown
Member

@ofekby ofekby commented May 31, 2026

Summary

Rewrites the skills/dial-cli/SKILL.md frontmatter description: to follow Anthropic's skill-authoring best practices, so any agent that has the skill installed reliably loads it before running dial.

Old:

Use the `dial` CLI to give your agent a real phone number — send SMS, place AI voice calls, and react to inbound events. Invoke whenever the user wants to send a text, make a call, receive a verification code, or otherwise reach out to the real world from a phone.

New:

Reference for the `dial` CLI — gives an agent a real phone number to send SMS, place AI voice calls, and react to inbound texts and calls 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, the onboarding/auth flow, or the docs-lookup pattern needed to use Dial correctly.

What changed and why:

  • Third person, not "you" — Anthropic notes inconsistent POV hurts discovery because the description is injected into the system prompt.
  • Leads with what it does, then a dense `Use when …` clause with concrete trigger keywords (phones, calls, texts, SMS, voice, OTP, 2FA, verification codes, text, call, ring, wait for a code) so the matcher fires on the way users actually phrase phone tasks.
  • Adds the "before running any `dial` command" trigger — the user-stated goal is that the skill loads at least once before the CLI is used, even if the user request itself doesn't obviously sound phone-shaped.
  • Slightly pushy — Anthropic's skill-creator explicitly recommends this; skills tend to under-trigger.
  • Closes with an explicit instruction to load the skill before invoking the CLI, because `dial --help` doesn't surface the workflow/convention layer this skill provides.

Bumps `@getdial/cli` to 0.12.1.

Test plan

  • Merge → CI publishes `@getdial/cli@0.12.1` to npm
  • Fresh install: `npm i -g @getdial/cli@0.12.1` then `dial onboard --agent claude-code …` writes the new description into `~/.claude/skills/dial-cli/SKILL.md`
  • In a new agent session, an unrelated phone-shaped request (e.g. "text my colleague") triggers the skill before `dial` runs

References:

🤖 Generated with Claude Code

@ofekby ofekby merged commit 81c4334 into main May 31, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant