Agent skill

PushMe Message Sender

by yafoo in yafoo/pushme

Sends push messages to the PushMe Android client from scripts, CI jobs and alerts, choosing between notification and silent data message types.

No licenceAuto-check passedProductivity & Automation

SKILL.md written in Chinese; this summary is our English description.

Install PushMe Message Sender

skills CLI
$ npx skills add yafoo/pushme --skill pushme-send-message -a claude-code

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

GitHub CLI
$ gh skill install yafoo/pushme pushme-send-message --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/yafoo/pushme.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skill/pushme-send-message .claude/skills/pushme-send-message && 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
pushme-send-message
GitHub stars
220
Token cost
~1.9k tokens
SKILL.md length
458 words
Files
5
Skills in repo
1
Repo updated
First seen
Licence
None found

At a glance

Sends push messages to the PushMe Android client from scripts, CI jobs and alerts, choosing between notification and silent data message types.

  • Works in 9 steps: 先分「通知」还是「数据」 —— 想通知却发了数据消息,手机上静默无提示,等于没发。 → 返回值不是 success 一律算失败 —— 别只看 HTTP 状态码。 → title 和 content 至少有一个,两个都空会失败。 → …
  • Sending a build-finished or alert notification to a phone from a script
  • SKILL.md covers 什么时候用它, 配置文件, ⚠️ 第一步:判断用户到底要「通知」还是「数据展示」 and push_key 从哪来, plus 10 more sections
  • Runs Python scripts from its folder; calls python and curl; reaches push.i-i.me; needs PUSHME_KEY

What it does

This skill covers calling the PushMe API to deliver a message to a phone. Its central rule is to decide first whether the user wants a notification or a data display. Notification types (text, markdown, html, url) pop up, ring and vibrate; data types (data, markdata, chart, echarts, svg) render on the app's data screen and raise no notification, so choosing the wrong class looks like a broken push. When intent is unclear the agent defaults to `text`.

Settings resolve from environment variables (`PUSHME_URL`, `PUSHME_KEY`), then `pushme.config.json`, then defaults. The key is a permanent `push_key` or a `temp_key` taken from the app, and the address can be the official service, a self-hosted server or a direct LAN address. The bundled `send.py` implements this logic and takes a title and a body. The skill says to keep keys out of the repository and to ask you for one instead of guessing, and it notes that code written for WeCom, DingTalk or Feishu group bots can be switched over because the interface is compatible.

When your agent uses it

  • Sending a build-finished or alert notification to a phone from a script
  • Writing curl, Python, Node or shell code that calls the PushMe API
  • Switching existing group-bot notification code over to PushMe
  • Debugging messages that were sent but never arrived

Example prompts

  • “Notify me on my phone when the nightly backup script finishes.”
  • “Write a Python function that pushes a markdown alert to PushMe using the PUSHME_KEY variable.”
  • “Show the live online-user count on my PushMe data screen without raising a notification.”
  • “Messages from my self-hosted PushMe server never arrive, help me find out why.”

Requirements

  • A PushMe `push_key` or `temp_key` from the app
  • Python to run the bundled `send.py`
  • Network access to the official server, a self-hosted one or the device on the LAN

Workflow steps

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

  1. 先分「通知」还是「数据」 —— 想通知却发了数据消息,手机上静默无提示,等于没发。
  2. 返回值不是 success 一律算失败 —— 别只看 HTTP 状态码。
  3. title 和 content 至少有一个,两个都空会失败。
  4. date 用小写 mm 表示分钟。
  5. push_key 与 temp_key 二选一,同时传会出错。
  6. 数据消息用 title 去重 —— 同 title 的多次推送只会看到最后一条。
  7. push_key 泄露等于任何人可给你的设备发消息 —— 一律走 pushme.config.json(已 gitignore)或环境变量。
  8. pushme.config.json 的 url 留空是有意为之 —— 表示走官方接口,不要误判为「配置未填写」。
  9. 收不到消息先查手机权限,这不是接口问题(见下)。

What it can do on your machine

Read from SKILL.md and the folder at commit 63f456f. 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 script files (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • 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:

    • push.i-i.me

    Also links to:

    • github.com

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • PUSHME_KEY

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

Context cost

PushMe Message Sender loads about 1.9k tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 458 words of instructions outside code blocks.

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

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 458 words (~1,878 tokens).

name
pushme-send-message
agent_created
true

Read the full SKILL.md on GitHub

Files

SKILL.md and 4 other files in skill/pushme-send-message of yafoo/pushme.

  • SKILL.md
  • .gitignore
  • pushme.config.example.json
  • pushme.config.schema.json
  • send.py

Open the folder on GitHubat commit 63f456f

Compare with similar skills

PushMe Message Sender 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.

PushMe Message Sender compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
PushMe Message Sender this skillyafoo/pushme220—~1.9kAutomated safety check: PassNone
Wechat Miniprograminfometa/workbuddyskills344—~1.5kAutomated safety check: NotesNone
LangBot EBA Adapter Developmentlangbot-app/LangBot18k—~4kAutomated safety check: PassApache-2.0
QQ Guild Channel Managertencent-connect/openclaw-qqbot1.6k—~1.8kAutomated safety check: PassMIT
Brigade Voice Callsspinabot/brigade11k—~288Automated safety check: PassMIT
DisCatSharp Discord DevelopmentAiko-IT-Systems/DisCatSharp140—~1.2kAutomated safety check: PassMIT

Similar skills

  • Wechat Miniprogram

    infometa/workbuddyskills

    WeChat Mini Program (微信小程序) development framework. An agent skill from infometa/workbuddyskills.

    344 GitHub stars~1.5k tokensUpdated today
    Productivity & AutomationAuto-check: notes
  • Guides building, migrating and testing LangBot messaging-platform adapters for the Event-Based Agents layout, with unified event and message conversion.

    18k GitHub stars~4k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • QQ Guild Channel Manager

    tencent-connect/openclaw-qqbot

    Manages QQ guilds and their sub-channels, members, posts, announcements and schedules through the qqbot_platform_api tool.

    1.6k GitHub stars~1.8k tokensUpdated 27 days ago
    Productivity & AutomationAuto-check passed
  • Brigade Voice Calls

    spinabot/brigade

    Starts and inspects phone calls through the Brigade voice-call plugin, using a CLI command or the voice_call tool, with Twilio, Telnyx, Plivo or a mock provider.

    11k GitHub stars~288 tokensUpdated 5 days ago
    Productivity & AutomationAuto-check passed
  • DisCatSharp Discord Development

    Aiko-IT-Systems/DisCatSharp

    Helps build, explain and troubleshoot C# Discord apps on DisCatSharp, answering from the project's installed version and the library's documentation rather than guesses.

    140 GitHub stars~1.2k tokensUpdated 3 days ago
    Backend & APIsAuto-check passed
  • Feishu Doc

    openclaw/openclaw

    Feishu document read/write workflows. An agent skill from openclaw/openclaw.

    392k GitHub stars~516 tokensUpdated today
    Productivity & AutomationAuto-check passed

Questions about PushMe Message Sender

What does PushMe Message Sender do?

Sends push messages to the PushMe Android client from scripts, CI jobs and alerts, choosing between notification and silent data message types. This skill covers calling the PushMe API to deliver a message to a phone. Its central rule is to decide first whether the user wants a notification or a data display.

When should I use PushMe Message Sender?

PushMe Message Sender fits situations like: sending a build-finished or alert notification to a phone from a script; writing curl, Python, Node or shell code that calls the PushMe API; switching existing group-bot notification code over to PushMe; debugging messages that were sent but never arrived.

How do I install PushMe Message Sender in Claude Code?

Run `npx skills add yafoo/pushme --skill pushme-send-message -a claude-code`. Or copy the skill folder (skill/pushme-send-message in yafoo/pushme) into .claude/skills/pushme-send-message in your project. Claude Code loads it when a task matches its description.

How do I install PushMe Message Sender in Codex?

Run `npx skills add yafoo/pushme --skill pushme-send-message -a codex`. Or copy the skill folder (skill/pushme-send-message in yafoo/pushme) into .agents/skills/pushme-send-message in your project. Codex loads it when a task matches its description.

Can I use PushMe Message Sender 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 yafoo/pushme --skill pushme-send-message -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pushme-send-message, .gemini/skills/pushme-send-message, .github/skills/pushme-send-message and .opencode/skills/pushme-send-message in your project.

What does PushMe Message Sender need to run?

Going by SKILL.md and its folder, PushMe Message Sender needs Python for the scripts in its folder, the command-line tools its instructions call (python and curl) and credentials named PUSHME_KEY. Our summary lists: A PushMe `push_key` or `temp_key` from the app; Python to run the bundled `send.py`; Network access to the official server, a self-hosted one or the device on the LAN.

Does PushMe Message Sender access the network?

SKILL.md names 2 domains. In commands or code: push.i-i.me; the agent is likely to contact it when it follows the instructions. As links in the text: github.com. This is read from the text; nothing was executed.

Is PushMe Message Sender 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 PushMe Message Sender use?

No licence was found for PushMe Message Sender or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does PushMe Message Sender use?

About 1.9k tokens (SKILL.md is roughly 7.5k 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 PushMe Message Sender?

Skills that share tags, products or a category with PushMe Message Sender: Wechat Miniprogram (infometa/workbuddyskills, 344 stars), LangBot EBA Adapter Development (langbot-app/LangBot, 18k stars), QQ Guild Channel Manager (tencent-connect/openclaw-qqbot, 1.6k stars) and Brigade Voice Calls (spinabot/brigade, 11k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains PushMe Message Sender?

yafoo (a GitHub user) maintains it in yafoo/pushme, which has 220 GitHub stars. The repository was last updated on October 3, 2026.

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