agentsclimarketplace

Poke api

Skill uvwt/agentdock/skill-sources/poke-api

Send context-rich instructions to Poke through the V2 inbound API using a securely injected API key.From its SKILL.md

Install
npx -y skills add uvwt/agentdock --skill poke-api

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

3 things to look at

  • reads credentialsReads from 2 credential sources: `~/.agentdock/env/skill/poke-api.env` and 1 more.
  • runs commandsInstructs the agent to run 1 command, including `printf '%s' '{"skill_action":"<动作>"}' | python3 run.py`.
  • fetches URLsInstructs the agent to fetch 1 URL, including https://poke.com/api/v1/inbound/api-message.

SKILL.md

2.2 KB, 688 tokens by cl100k_base, as published. Nobody here has run it

Poke API Skill

通过 Poke V2 API 将消息或结构化上下文发送给你的 Poke 助手。

操作

status

检查 Skill 版本、固定端点以及 POKE_API_KEY 是否已从 ~/.agentdock/env/skill/poke-api.env 或当前命令显式环境加载。不会发起网络请求,也不会输出密钥。

send

向 https://poke.com/api/v1/inbound/api-message 发送 JSON。

输入:

  • message:推荐使用的自然语言指令。
  • context:可选 JSON 对象,其字段会与 message 合并到顶层请求体,便于附带 URL、文件路径、事件 ID 或其他结构化信息。
  • dry_run:只构造请求,不访问 Poke;无密钥时也可使用。
  • timeout_seconds:请求超时,范围 1–60 秒。

message 与 context 至少提供一个。若两者都提供,显式 message 会作为最终请求体的 message 字段。

配置

仅通过私有 Skill 环境文件或当前命令环境配置:

POKE_API_KEY

不要把 API Key 写进 Skill 源码、输入参数、日志、README 或 Git。该 Skill 只支持 Kitchen 创建的 V2 Key 和新端点;不调用已弃用的 /api/v1/inbound-sms/webhook。

安全边界

  • API 端点固定为 https://poke.com/api/v1/inbound/api-message,输入不能覆盖。
  • Authorization Header 和 API Key 不会出现在输出中。
  • HTTP 响应会递归脱敏常见凭据字段。
  • 请求体限制为 512 KiB,响应体限制为 1 MiB。
  • 使用 Python 标准库,无第三方依赖。

辅助脚本执行

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

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

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

动作用途
statusCheck Poke API configuration without sending a request or revealing the API key.
sendSend a natural-language message and optional top-level structured context to Poke.

Keep looking

Skills are one crate of 325,949. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.