sent-account-readiness — Claude Code skill: check your Sent account
This skill uses Sent MCP tools to check whether an account can send: balance, onboarding, KYC and the selected Sender Profile.
npx skills add sentdm/sent-plugin --skill sent-account-readiness -a claude-codeWhat sent-account-readiness does
Three tools do the work. account.get returns the authorized account context with the selected organization and Sender Profile, balance.get reports the balance with currency and a timestamp, and onboarding.status lists incomplete, pending, approved or blocked steps. Run it before a high-volume send or a channel launch and you learn what stands in the way.
The MCP client handles OAuth 2.1/PKCE. The skill never asks for, prints or stores tokens, API keys, authorization headers or client IDs — if authentication fails, it explains what can still be planned and points you back to your MCP client to reauthorize. The grant is scoped to the organization and Sender Profile chosen during that flow, so a different organization or a profile outside the grant needs a fresh authorization.
Diagnosis only: this skill does not mutate onboarding state. It routes the blocking issue onward — live SMS market requirements to sent-compliance, Sender Profile boundaries to sender-profile-architect, US A2P registration prep to sms-10dlc-registration, WhatsApp Embedded Signup to waba-embedded-signup, RCS Business Messaging launch prep to rcs-agent-onboarding. One trap: an onboarding.status response with found: false means no conversion flow exists, not that onboarding is approved.
What it helps with
- check funds before a high-volume send
- see which onboarding steps are still open
- find out which organization and Sender Profile the MCP client authorized
- tell a zero own balance apart from billing inherited through a profile
- run a preflight check before a mutation or channel launch
Example prompts for the agent
- Check whether my Sent account is ready to send
- Why is onboarding blocked and what should I do next?
- Show the balance and KYC status for the selected Sender Profile
How to install sent-account-readiness
1Skills CLI (Vercel)
npx skills add sentdm/sent-plugin --skill sent-account-readiness -a claude-code2Manually: put the files in place
~/.claude/skills/sent-account-readiness/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/sent-account-readiness/
1Skills CLI (Vercel)
npx skills add sentdm/sent-plugin --skill sent-account-readiness -a codex2Manually: put the files in place
.agents/skills/sent-account-readiness/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add sentdm/sent-plugin --skill sent-account-readiness -a cursor2Manually: put the files in place
.cursor/skills/sent-account-readiness/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install sentdm/sent-plugin sent-account-readiness2Manually: put the files in place
.github/skills/sent-account-readiness/SKILL.md1Skills CLI (Vercel)
npx skills add sentdm/sent-plugin --skill sent-account-readiness -a gemini-cli2Platform CLI
gemini skills install https://github.com/sentdm/sent-plugin --path skills/sent-account-readinessManually: put the files in place
.devin/skills/sent-account-readiness/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add sentdm/sent-plugin --skill sent-account-readiness -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about sent-account-readiness
How do I install sent-account-readiness in Claude?
Run npx skills add sentdm/sent-plugin --skill sent-account-readiness -a claude-code. The skill lands at ~/.claude/skills/sent-account-readiness/SKILL.md.
What does sent-account-readiness do?
It inspects the authorized Sent account, balance and onboarding status through Sent MCP tools, then routes any blocking issue to the matching skill.
Does the skill need my API keys or tokens?
No. The MCP client performs OAuth 2.1/PKCE authorization, and the skill never requests, prints or stores tokens, keys or authorization headers.
Source text
SKILL.md · MIT
--- name: sent-account-readiness description: Checks the authorized Sent account, organization and Sender Profile scope, balance, onboarding/KYC status, and readiness with the Sent MCP tools. Use when a user asks whether the account can send, what the MCP connection authorized, whether funds are sufficient, why onboarding is blocked, or for a preflight check before a mutation or channel launch. Route remediation to the relevant onboarding or compliance skill. --- # Sent Account Readiness Inspect readiness with `account.get`, `balance.get`, and `onboarding.status`. ## Authorize safely Let the MCP client perform OAuth 2.1/PKCE. Never request, accept, print, or store tokens, API keys, authorization headers, client IDs, or secrets. The authorization grant is scoped to the organization and Sender Profile selected during the client flow. Revoke the grant through the client or applicable Sent account controls when it is no longer needed. If MCP is unsupported or authentication fails, explain what can still be planned from the skill and direct the user to authorize or reauthorize in their MCP client. Do not ask them to paste credentials. An organization grant may select an owned Sender Profile with the tool schema's optional `profileId`; omit it to act as the authenticated account. Validate ownership with `sender_profiles.list` or `sender_profiles.get`, and use the same selector for preflight reads, mutations, and follow-up reads. Profile grants cannot use this selector. Reauthorize for a different organization or a profile outside the grant. Never invent scope fields or request credentials. ## Check readiness 1. Use `account.get` to identify the authorized account context and surface the selected organization and Sender Profile. Return only the minimum account fields needed for the task. 2. Use `balance.get` before high-volume sends or when insufficient funds may block messaging. Report the currency and returned timestamp or freshness information when available. An account with no own balance row returns `balance: 0` and `initialized: false`; distinguish this from the returned effective balance under profile/organization billing inheritance. 3. Use `onboarding.status` to identify incomplete, pending, approved, or blocked onboarding steps. Preserve the distinction between an observed status and a remediation action. Its `found`/`item` envelope can return `found: false` when no conversion flow exists; that is not a tool error or proof of approval. Mask identifiers where practical. Do not repeat account, KYC, contact, or billing details unnecessarily. ## Route remediation This skill diagnoses readiness but does not mutate onboarding state. - Route live SMS market requirements and setup calls to `sent-compliance`. - Route Sender Profile boundary or tenancy design to `sender-profile-architect`. - Route US A2P registration preparation to `sms-10dlc-registration`. - Route WhatsApp Embedded Signup to `waba-embedded-signup`. - Route RCS Business Messaging launch preparation to `rcs-agent-onboarding`. When the user asks only whether an account is ready, report the blocking status and recommended public skill without inventing an operational fix.
© sentdm · MIT · sentdm/sent-plugin