Agent skill

Shop Voice Checkin

by CALLE-AI in CALLE-AI/awesome-phone-call-agents

Place consent-based outbound CALL-E phone check-ins with informal African and Indian retailers to capture morning inventory and evening sales through natural voice conversation, then return…

MITAuto-check passedBusiness, Finance & HR

Install Shop Voice Checkin

skills CLI
$ npx skills add CALLE-AI/awesome-phone-call-agents --skill shop-voice-checkin -a claude-code

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

GitHub CLI
$ gh skill install CALLE-AI/awesome-phone-call-agents shop-voice-checkin --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/CALLE-AI/awesome-phone-call-agents.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/shop-voice-checkin .claude/skills/shop-voice-checkin && 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
shop-voice-checkin
GitHub stars
107
Token cost
~2.4k tokens
SKILL.md length
708 words
Files
21 (incl. scripts, references, assets)
Skills in repo
101
Repo updated
First seen
Licence
MIT

At a glance

Place consent-based outbound CALL-E phone check-ins with informal African and Indian retailers to capture morning inventory and evening sales through natural voice conversation, then return…

  • Works in 7 steps: Read references/safety.md and confirm… → Choose call type: inventory (morning) or… → Build task text from… → …
  • Business, Finance & HR work in your project
  • SKILL.md covers When to use, When not to use, Required fields and Core workflow, plus 12 more sections

What it does

Shop Voice Checkin is an agent skill from CALLE-AI/awesome-phone-call-agents. Place consent-based outbound CALL-E phone check-ins with informal African and Indian retailers to capture morning inventory and evening sales through natural voice conversation, then return structured shop data for a voice-first business manager workflow.

Its SKILL.md is about 2.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 22 other files, including scripts, reference files and assets (for example `assets/example-request-inr.template.json`, `assets/example-request.template.json` and `assets/sample-shop-profile-inr.json`).

It sits in Business, Finance & HR. The repository describes itself as: Portable phone-call Agent Skills, apps, examples, adapters, and scheduler recipes for AI agents. The licence is MIT.

When your agent uses it

  • Business, Finance & HR work in your project

Example prompts

  • “/shop-voice-checkin”

Requirements

  • Python 3

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Read references/safety.md and confirm recipient consent.
  2. Choose call type: inventory (morning) or sales (evening).
  3. Build task text from references/call-scripts-pidgin.md, references/call-scripts-english.md, or references/call-scripts-hindi-english.md.
  4. Attach the matching result schema
  5. Preview first — inspect the planned task and schema without placing a call.
  6. Live call — only with explicit user approval and --execute-style confirmation in the runnable app.
  7. Pass structured results to the shop ledger app or host workflow.

What it can do on your machine

Read from SKILL.md and the folder at commit 38d4118. 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

    Ships 1 file in scripts/, which the agent can run.

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

  • Network

    No URLs in SKILL.md.

    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

Shop Voice Checkin loads about 2.4k tokens when it runs, and up to ~14k if it reads all its reference files. Until then it costs about 69 tokens; SKILL.md has 708 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~69
When it runs · the whole SKILL.md, loaded when a task matches
~2.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~14k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from CALLE-AI/awesome-phone-call-agents at commit 38d4118, republished under its MIT licence (© CALLE-AI). 708 words, ~2,427 tokens.

Download SKILL.mdSave it as .claude/skills/shop-voice-checkin/SKILL.md (or your agent's skills folder). This skill also uses 20 other files; get the full folder from GitHub.
name
shop-voice-checkin
description
Place consent-based outbound CALL-E phone check-ins with informal African and Indian retailers to capture morning inventory and evening sales through natural voice conversation, then return structured shop data for a voice-first business manager workflow.
license
MIT

Shop Voice Check-in

Use this skill when a shop owner has opted in to regular phone check-ins instead of entering data into an app. The agent calls, speaks in simple English, Pidgin-influenced English, or Hindi-English (Hinglish), asks about stock and sales, and returns structured JSON for a local shop ledger.

This skill is the voice layer of Voice Shop Manager — "your business manager, on the phone."

When to use

  • Morning inventory check-in — approximate stock levels, low items, supplier mentions
  • Evening sales recap — approximate daily revenue, top sellers, restock spend
  • Voice-first workflows for informal retailers in Nigeria, West Africa, or similar markets (India via English/Hindi task variants)

Pair with the runnable app at apps/python/shop-voice-manager/ (relative to this submission repository root) to persist results in SQLite and generate weekly summaries.

Demo mode: Default hackathon path uses fixtures — no live call. See references/demo-mode.md.

When not to use

  • Cold-calling retailers who did not consent
  • Loan offers, credit scoring conversations, or regulated financial advice on the call
  • Replacing a POS, accounting system, or tax filing workflow
  • Batch supplier procurement calls without explicit authorization per recipient
  • Recurring schedules without a separate scheduler wrapper — see call-reminder

Required fields

For each call, require:

  • shop_id — stable identifier for the retailer
  • call_type — inventory, sales, reorder_offer, vendor_order, order_status, or onboarding
  • phone — E.164 number of the consenting shop owner (or, for vendor_order, the consenting vendor)
  • region — CALL-E region code, e.g. NG or IN
  • locale — CALL-E locale, e.g. en
  • recipient_consented — must be true for live calls

Optional:

  • currency — NGN, INR, etc.
  • language_style — pidgin-english, english, or hindi-english
  • products_to_ask — short list for morning check-ins
  • timezone — IANA name for scheduling context

Ask for any missing required field. Do not infer phone, region, locale, or timezone from context.

Core workflow

  1. Read references/safety.md and confirm recipient consent.
  2. Choose call type: inventory (morning) or sales (evening).
  3. Build task text from references/call-scripts-pidgin.md, references/call-scripts-english.md, or references/call-scripts-hindi-english.md.
  4. Attach the matching result schema:
    • inventory → references/result-schema-inventory.json
    • sales → references/result-schema-sales.json
    • reorder_offer → references/result-schema-reorder-offer.json
    • vendor_order → references/result-schema-vendor-order.json
    • order_status → references/result-schema-order-status.json
    • onboarding → references/result-schema-onboarding.json
  5. Preview first — inspect the planned task and schema without placing a call.
  6. Live call — only with explicit user approval and --execute-style confirmation in the runnable app.
  7. Pass structured results to the shop ledger app or host workflow.

Use this shape:

text
consent check -> build task + schema -> preview -> live call -> structured result -> shop ledger

Call task template (inventory)

text
Call the shop owner for a short morning inventory check-in. Match language_style:
Pidgin for pidgin-english, plain English for english, Hindi-English mix for
hindi-english. Ask about: {{products_to_ask}}. For each product, capture
approximate quantity and unit. Ask what is running low. Also ask once whether
they added any new goods not on that list; if yes, capture name, quantity, and
unit so the ledger can add them. Disclose you are an AI assistant for their shop
manager service. Keep the call under {{max_minutes}} minutes. Do not give
financial advice.

Call task template (sales)

text
Call the shop owner for a short evening sales recap. Ask roughly how much they
sold today, what sold best, and whether they bought stock for the shop today.
Disclose you are an AI assistant for their shop manager service. Keep the call
under {{max_minutes}} minutes. Do not give financial advice.

Call task template (reorder offer)

text
Call the consenting shop owner. Tell them the following is running low:
{{low_stock_items}}. Ask if they want to place a restock order. If yes, ask quantity
needed per item, then ask which vendor to use. If it is a vendor already on file, do
not ask what they sell or their phone number again. If it is a new vendor, explicitly
ask two more questions before ending the call: what the vendor sells, and the
vendor's phone number — do not skip the phone number just because the owner did not
offer it; ask for it directly. If the owner truly does not have it, say the vendor
cannot be called yet without it. Never invent a vendor phone number. If no, end
politely; do not place any vendor call. Disclose you are an AI assistant. Keep the
call under {{max_minutes}} minutes. Do not give financial advice or discuss loans.

Call task template (vendor order)

text
Call {{vendor_display_name}} on behalf of {{shop_id}}. Disclose you are an AI
assistant calling on their behalf. State you are calling to place an order for
{{order_items}}. Ask if they are available, the price if they wish to share
it, and an estimated delivery time. Do not discuss payment, bank details, or
loans.

Call task template (order status)

text
Call the consenting shop owner with a short update on their restock order.
Disclose you are an AI assistant. Tell them exactly the known outcome from the
vendor call — placed, unavailable, or delayed — plus the ETA and amount if
known. Do not leave the outcome for the model to guess; a task with no known
outcome to report should not be created. Keep under 2 minutes. Do not give
financial advice.

Call task template (onboarding)

text
Call the consenting new shop owner. Disclose you are an AI assistant. Explain
you will collect basic shop details to set up their account: shop name, phone
number (read back to confirm), region, and language. Ask for 3 to 5 staple
products they sell and, optionally, one preferred supplier's name. Ask for
consent to store this information and to make future check-in calls. Do not
infer region, locale, or currency — ask explicitly. Keep under {{max_minutes}}
minutes.

Idempotency

Use one idempotency key per shop, call type, and calendar day for inventory, sales, reorder_offer, and onboarding. vendor_order and order_status key on the restock request instead, since a shop may restock more than once a day:

text
shopvoice-{shop_id}-inventory-{YYYY-MM-DD}
shopvoice-{shop_id}-sales-{YYYY-MM-DD}
shopvoice-{shop_id}-reorder_offer-{YYYY-MM-DD}
shopvoice-{shop_id}-vendor_order-{request_id}
shopvoice-{shop_id}-order_status-{request_id}
shopvoice-{shop_id}-onboarding-{YYYY-MM-DD}

Phase 3 payout key: vendor_pay — see references/result-schema-payment-consent.json.

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

Runnable app

The reference runner lives at apps/python/shop-voice-manager/. Default mode is preview (no network call). See the app README for live opt-in flags.

Assets

  • assets/sample-shop-profile.json — fictional masked Nigeria (NGN) shop profile
  • assets/sample-shop-profile-inr.json — fictional masked India (INR) shop profile
  • assets/example-request.template.json — Nigeria request shape for the Python app
  • assets/example-request-inr.template.json — India request shape (region: IN, currency: INR)

Output

After a completed inventory call, expect fields such as check_in_completed, products[] (including new goods the owner introduced), and optional owner_notes. New product names are upserted into the SQLite ledger automatically.

After a completed sales call, expect sales_day_completed, estimated_revenue, top_sellers[], and optional procurement fields.

After a completed reorder-offer call, expect owner_wants_to_order and, if true, items[] with quantity and vendor detail per item — saved to a restock_requests row and the vendor directory.

After a completed vendor-order call, expect available, items[], and optional quoted_amount/eta_text — written back onto the matching orders row.

After a completed order-status callback, expect order_id and status_reported (placed / unavailable / delayed) — the same orders row is updated with the callback outcome.

After a completed onboarding call, expect display_name, phone, region, locale, both consent flags, and typical_products[] — written to shops and products.

Mask phone numbers in any user-facing summary.

Scheduling recurring check-ins

This skill places one call per invocation. The host scheduler owns recurrence; CALL-E places one call per run.

See references/scheduling.md for the cron and Windows Task Scheduler recipes, how to update a schedule without doubling the calls, and how to cancel. Generate entries with scripts/render_schedule.py rather than writing them by hand.

For general scheduler-wrapper guidance across other hosts, see call-reminder.

Hackathon plan: docs/projects/voice-shop-manager/PROJECT_PLAN.md
Phase 2 + Phase 3 next steps: docs/projects/voice-shop-manager/NEXT_STEPS.md

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

Files

SKILL.md and 20 other files (scripts, references, assets) in skills/shop-voice-checkin of CALLE-AI/awesome-phone-call-agents.

  • SKILL.md
  • assets/example-request-inr.template.json
  • assets/example-request.template.json
  • assets/sample-shop-profile-inr.json
  • assets/sample-shop-profile.json
  • references/call-scripts-english.md
  • references/call-scripts-hindi-english.md
  • references/call-scripts-pidgin.md
  • references/demo-mode.md
  • references/examples.md
  • references/result-schema-inventory.json
  • references/result-schema-onboarding.json
  • references/result-schema-order-status.json
  • references/result-schema-payment-consent.json
  • references/result-schema-reorder-offer.json
  • references/result-schema-sales.json
  • references/result-schema-vendor-order.json
  • references/safety.md
  • references/scheduling.md
  • … and 2 more

Open the folder on GitHubat commit 38d4118

Compare with similar skills

Shop Voice Checkin 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.

Shop Voice Checkin compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Shop Voice Checkin this skillCALLE-AI/awesome-phone-call-agents107—~2.4kAutomated safety check: PassMIT
Technical Analysttradermonty/claude-trading-skills3k4 repos~4.6kAutomated safety check: PassMIT
Theme Detectortradermonty/claude-trading-skills3k2 repos~4.9kAutomated safety check: PassMIT
Creating Financial ModelsChen-zexi/open-ptc-agent7293 repos~1.3kAutomated safety check: PassMIT
Stock APIzhangxiangliang/stock-api2k—~507Automated safety check: PassMIT
Itr Walakaranb192/itr-wala871—~3.6kAutomated safety check: PassMIT

Similar skills

  • Technical Analyst

    tradermonty/claude-trading-skills

    This skill should be used when analyzing weekly price charts for stocks, stock indices, cryptocurrencies, or forex pairs.

    3k GitHub starsUsed in 4 repos~4.6k tokens
    Business, Finance & HRAuto-check passed
  • Theme Detector

    tradermonty/claude-trading-skills

    Detect and analyze trending market themes across sectors. An agent skill from tradermonty/claude-trading-skills.

    3k GitHub starsUsed in 2 repos~4.9k tokens
    Business, Finance & HRAuto-check passed
  • Creating Financial Models

    Chen-zexi/open-ptc-agent

    This skill provides an advanced financial modeling suite with DCF analysis, sensitivity testing, Monte Carlo simulations, and scenario planning for investment decisions

    729 GitHub starsUsed in 3 repos~1.3k tokens
    Business, Finance & HRAuto-check passed
  • Stock API

    zhangxiangliang/stock-api

    Fetch real-time stock quotes, K-line (candlestick) history, and search symbols for China A-shares, Hong Kong, and US markets.

    2k GitHub stars~507 tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Itr Wala

    karanb192/itr-wala

    File Indian income tax returns (ITR) for FY 2025-26 / AY 2026-27.

    871 GitHub stars~3.6k tokensUpdated 7 days ago
    Business, Finance & HRAuto-check passed
  • Tushare Data

    zillionare/zillionare

    面向中文自然语言的 Tushare 数据研究技能。用于把“看看这只股票最近怎么样”“帮我查财报趋势”“最近哪个板块最强”“北向资金在买什么”“给我导出一份行情数据”这类请求,转成可执行的数据获取、清洗、对比、筛选、导出与简要分析流程。适用于 A 股、指数、ETF/基金、财务、估值、资金流、公告新闻、板块概念与宏观数据等研究场景。

    322 GitHub starsUsed in 2 repos~2.3k tokens
    Business, Finance & HRAuto-check passed

More from CALLE-AI/awesome-phone-call-agents

All 101 skills in this repo
  • Accessible Outing Verifier

    CALLE-AI/awesome-phone-call-agents

    Demonstrates advisory accessibility-planning checks with offline fixtures and a proposed bounded CALL-E workflow; use for exploring unknown or qualified venue claims without making calls.

    107 GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed
  • Ground Truth Gate

    CALLE-AI/awesome-phone-call-agents

    A skill your agent uses when an agent holds some evidence for a physical-world claim but the evidence is broader, narrower, or older than the exact question asked, and it must first decide whether a…

    107 GitHub stars~3.3k tokensUpdated yesterday
    Auto-check passed
  • Is It Accessible

    CALLE-AI/awesome-phone-call-agents

    Call a venue and ask the accessibility questions that matter to one specific person — step-free entry, hearing loop, guide dogs, quiet hours, changing places — then return a per-need verdict backed…

    107 GitHub stars~4.3k tokensUpdated yesterday
    Auto-check passed
  • Landmark Navigation Assist

    CALLE-AI/awesome-phone-call-agents

    Turns a pre-written, building-level location config into a CALL-E outbound phone-call task that guides a delivery driver through the last few hundred metres to a specific building using landmarks…

    107 GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed
  • Research Gap Call Verifier

    CALLE-AI/awesome-phone-call-agents

    Turn cited business research into a bounded, approval-gated phone-call plan that asks only unresolved factual questions, then reconcile CALL-E-compatible results without treating voicemail, refusal…

    107 GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed
  • Structured Outcome Followup Call

    CALLE-AI/awesome-phone-call-agents

    Place a goal-driven CALL-E call that collects specific structured answers, score those answers against a deterministic rubric you supply, and conditionally trigger a follow-up action — all runnable…

    107 GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed

Questions about Shop Voice Checkin

What does Shop Voice Checkin do?

Place consent-based outbound CALL-E phone check-ins with informal African and Indian retailers to capture morning inventory and evening sales through natural voice conversation, then return…. Shop Voice Checkin is an agent skill from CALLE-AI/awesome-phone-call-agents. Place consent-based outbound CALL-E phone check-ins with informal African and Indian retailers to capture morning inventory and evening sales through natural voice conversation, then return structured shop data for a voice-first business manager workflow.

When should I use Shop Voice Checkin?

Shop Voice Checkin fits situations like: business, Finance & HR work in your project.

How do I install Shop Voice Checkin in Claude Code?

Run `npx skills add CALLE-AI/awesome-phone-call-agents --skill shop-voice-checkin -a claude-code`. Or copy the skill folder (skills/shop-voice-checkin in CALLE-AI/awesome-phone-call-agents) into .claude/skills/shop-voice-checkin in your project. Claude Code loads it when a task matches its description.

How do I install Shop Voice Checkin in Codex?

Run `npx skills add CALLE-AI/awesome-phone-call-agents --skill shop-voice-checkin -a codex`. Or copy the skill folder (skills/shop-voice-checkin in CALLE-AI/awesome-phone-call-agents) into .agents/skills/shop-voice-checkin in your project. Codex loads it when a task matches its description.

Can I use Shop Voice Checkin 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 CALLE-AI/awesome-phone-call-agents --skill shop-voice-checkin -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/shop-voice-checkin, .gemini/skills/shop-voice-checkin, .github/skills/shop-voice-checkin and .opencode/skills/shop-voice-checkin in your project.

What does Shop Voice Checkin need to run?

SKILL.md names no scripts, command-line tools or credentials: Shop Voice Checkin is instructions for the agent only. Our summary lists: Python 3.

Does Shop Voice Checkin access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Shop Voice Checkin 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Shop Voice Checkin use?

Shop Voice Checkin is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Shop Voice Checkin use?

About 2.4k tokens (SKILL.md is roughly 9.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 11k tokens, read only when the agent opens those files.

What are the alternatives to Shop Voice Checkin?

Skills that share tags, products or a category with Shop Voice Checkin: Technical Analyst (tradermonty/claude-trading-skills, 3k stars), Theme Detector (tradermonty/claude-trading-skills, 3k stars), Creating Financial Models (Chen-zexi/open-ptc-agent, 729 stars) and Stock API (zhangxiangliang/stock-api, 2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Shop Voice Checkin?

CALLE-AI (a GitHub organization) maintains it in CALLE-AI/awesome-phone-call-agents, which has 107 GitHub stars. The repository holds 101 skills in this directory. The repository was last updated on October 10, 2026.

Source: CALLE-AI/awesome-phone-call-agents on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.