bark

Name: bark
Author: uvwt/agentdock

$npx mdskill add uvwt/agentdock/bark

Send Bark notifications using Python standard library securely

Automatically sends secure Bark notifications without exposing device key.
Deploys a custom Skill for Docker environments to integrate with Bark API.
Validates and configures Bark server URL and device key in the background.
Generates and outputs safe URLs for Bark notifications, protecting sensitive data.

SKILL.md

.github/skills/barkView on GitHub ↗

---
name: bark
description: Send Bark-compatible notifications with Python standard library while keeping the device key in the private Skill data environment.
version: 0.1.8
---

# Bark Push Skill

把 Bark 兼容 HTTP API 封装为 AgentDock 原生 Skill，用于 Dock 通知。

## 能力

- `send`：发送普通 Bark 推送。
- `event`：发送格式化的 Dock 运行事件通知。
- `health`：验证 Bark server URL 与 device key 配置；`live: true` 会真实发送一条健康检查通知。
- `url`：生成兼容 GET 调用 URL，但输出中会隐藏 device key。

## 配置

默认连接 `https://api.day.app`。可设置 `BARK_SERVER_URL` / `BARK_BASE_URL` / `BARK_URL`，或在调用中传 `server_url` 指向自建 Bark server。

设备 key 只从 `BARK_DEVICE_KEY` / `BARK_KEY` / `.env` 读取，不接受 action input 或命令行参数。可通过 `BARK_ENV_FILE` 或调用参数 `env_file` 指定 `.env` 文件。

## 安全约束

- `server_url` 仅允许 `http` / `https`，禁止 URL 内嵌用户名和密码。
- 默认使用 `POST /push`，device key 不进入 URL。
- `url` 操作只生成 URL 不发送，并对 device key 做脱敏。
- 不依赖第三方 Python 包。

## 辅助脚本执行

Skill 本体是本说明文档。确需调用包内辅助脚本时，在 Skill 包根目录使用相对路径执行；运行宿主负责切换到包根目录并把所需变量注入当前子进程。

```bash
printf '%s' '{"skill_action":"<动作>"}' | python3 run.py
```

输入必须是 JSON 对象。写操作仍按本文档中的确认规则执行。

| 动作 | 用途 |
|---|---|
| `send` | Send a Bark push notification. |
| `event` | Send a formatted Dock event notification through Bark. |
| `health` | Verify Bark configuration and optionally perform a dry or live connectivity check. |
| `url` | Build a Bark-compatible GET URL without sending it. The device key is redacted in output. |

More from uvwt/agentdock

Skill	Description
baidu-netdisk	Use this skill when managing Baidu Netdisk files through the bdpan CLI inside the application data scope.
cloudsaver	Use this skill when calling the local CloudSaver API for status checks, resource search, Douban hot lists, share parsing, or transfer actions.
code-debrief	Explain and teach the core implementation produced by vibecoding from real code, focusing on the main call chain, core code, state and data flow, design reasoning, and transferable engineering knowledge. Use when the user asks to explain, review, learn, debrief, or understand recent code changes, a commit, PR, diff, feature, module, or code path.
codex-usage	Use this skill when checking the current macOS user Codex CLI account state or Codex usage quota.
desktop	macOS desktop automation as an AgentDock Skill workflow.
douban-marks	只读查询豆瓣电影、图书、音乐标记列表和电影条目联想。用于读取用户自己的已看、想看、在看等标记；公开主页可直接读，私密列表需要本机环境或 .env 中的 DOUBAN_COOKIE。禁止用于批量采集、绕登录、写入标记或读取非授权账号。
douyin-hot	获取抖音实时热榜并返回标题、热度和跳转链接。
find-skills-skill	Search and discover OpenClaw skills from various sources. Use when: user wants to find available skills, search for specific functionality, or discover new skills to install.
grok-quota	Query detailed Grok weekly usage, GrokChat/GrokBuild breakdown, plan, monthly credits, and pay-as-you-go state from local xAI OAuth credentials.
linkwarden	Manage a Linkwarden instance through its official HTTP API: check configuration, search and inspect bookmarks, collections, tags and highlights, and perform controlled link, collection or tag changes with explicit confirmation for destructive actions.