← Back to Skills Marketplace
pidgesms
by
Adam Malone
· GitHub ↗
· v1.0.0
529
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install pidgesms
Description
Send and read SMS text messages via an Android phone using pidge. Use when asked to send a text, check texts, read SMS inbox, or reply to a text message.
Usage Guidance
This skill appears coherent and implements exactly what it claims: a thin wrapper around the pidge CLI to interact with an Android SMS Gateway. Before installing, verify you trust the upstream pidge project (SKILL.md suggests installing via `go install github.com/typhonius/pidge@latest` which fetches code from GitHub). Secure your phone and gateway (run the Android SMS Gateway only on trusted networks), inspect ~/.config/pidge/config.toml for any credentials or webhook endpoints, and test with a controlled phone number. If you want to prevent accidental or automated sends, consider disabling autonomous skill invocation for this skill (or require explicit user approval) so the agent cannot send SMS without your confirmation.
Capability Analysis
Type: OpenClaw Skill
Name: pidgesms
Version: 1.0.0
The skill is designed to interact with an SMS gateway via the `pidge` CLI tool. While SMS interaction inherently involves sensitive data, the `SKILL.md` explicitly includes comprehensive 'Safety rules' that instruct the AI agent to confirm recipients, avoid sending sensitive information, prevent bulk messages, and never leak private SMS content into group chats. These instructions actively mitigate potential misuse and demonstrate an intent for responsible operation, rather than malicious activity. The installation method (`go install`) is standard for Go tools, and no other high-risk behaviors, obfuscation, or exfiltration attempts are present.
Capability Assessment
Purpose & Capability
Name/description (SMS via pidge) align with the declared runtime requirements: the skill only requires the pidge binary and the pidge config (~/.config/pidge/config.toml). There are no unrelated environment variables, binaries, or config paths requested.
Instruction Scope
SKILL.md instructs only on running the pidge CLI (send, inbox, status, ack/unack, health) and references pidge's config file. It does not instruct reading other files, scanning the system, or posting SMS content to external endpoints unrelated to the Android SMS Gateway.
Install Mechanism
The registry lists no formal install spec, but the SKILL.md metadata suggests `go install github.com/typhonius/pidge@latest`. That will fetch and build code from the public GitHub repo (moderate trust requirement). This is not a private/paste URL or arbitrary binary download, but it does pull external code to disk — review the upstream project before installing.
Credentials
No environment variables or credentials are requested. The only config path referenced is pidge's config (~/.config/pidge/config.toml), which is appropriate for the stated purpose.
Persistence & Privilege
The skill does not request permanent/always-on inclusion (always:false) and does not modify other skills. It is callable by the model (default behavior) — because the skill can send real SMS, consider the implications of autonomous invocation (the platform default) if you need to prevent the agent from sending messages without explicit approval.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install pidgesms - After installation, invoke the skill by name or use
/pidgesms - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of pidgesms — send and read SMS using an Android phone via the pidge CLI.
- Send SMS messages to E.164 formatted numbers using the pidge command.
- Check delivery status of sent messages.
- Read SMS inbox, including unread and JSON view.
- Mark messages as processed or unprocessed.
- Includes health check functionality.
- Safety rules included: prohibits sending sensitive info, bulk messages, or to unknown numbers.
Metadata
Frequently Asked Questions
What is pidgesms?
Send and read SMS text messages via an Android phone using pidge. Use when asked to send a text, check texts, read SMS inbox, or reply to a text message. It is an AI Agent Skill for Claude Code / OpenClaw, with 529 downloads so far.
How do I install pidgesms?
Run "/install pidgesms" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is pidgesms free?
Yes, pidgesms is completely free (open-source). You can download, install and use it at no cost.
Which platforms does pidgesms support?
pidgesms is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created pidgesms?
It is built and maintained by Adam Malone (@typhonius); the current version is v1.0.0.
More Skills