draft-queue

name	draft-queue
description	Queue an external action (Telegram message, shell command, GitHub comment, PR merge, file write) for the user's explicit approval before it runs. Use when you want to take an outward-facing or irreversible action that needs sign-off first.
category	writing
maturity	beta
tags	["approval-queue","drafts","json-payload","telegram-action"]

Draft Queue Skill

Use when: you want to take an external action that requires the user's approval before executing.

Add a draft

node ${DRAFT_QUEUE_HOME:-$HOME/projects/draft-queue}/add-draft.cjs \
  --type <type> \
  --desc "description" \
  --payload '<json>'

Types: telegram-message, shell-command, github-comment, github-pr-merge, file-write

Payloads by type

telegram-message

{ "chat_id": "<your-telegram-user-id>", "message": "text here" }

shell-command

{ "command": "echo hello", "cwd": "$HOME" }

github-comment

{ "repo": "JansenAnalytics/myrepo", "issue": 42, "body": "comment text" }

github-pr-merge

{ "repo": "JansenAnalytics/myrepo", "pr": 7, "method": "squash" }

file-write

{ "path": "/path/to/your/file.txt", "content": "file contents" }

Approve (when the user says "approve ID")

node ${DRAFT_QUEUE_HOME:-$HOME/projects/draft-queue}/approve.cjs <id>

Reject (when the user says "reject ID")

node ${DRAFT_QUEUE_HOME:-$HOME/projects/draft-queue}/reject.cjs <id>

List pending

node ${DRAFT_QUEUE_HOME:-$HOME/projects/draft-queue}/list-drafts.cjs

List all

node ${DRAFT_QUEUE_HOME:-$HOME/projects/draft-queue}/list-drafts.cjs --all

List by status

node ${DRAFT_QUEUE_HOME:-$HOME/projects/draft-queue}/list-drafts.cjs --status approved

Notes

• Drafts file: ${DRAFT_QUEUE_HOME:-$HOME/projects/draft-queue}/drafts.json (append-only)
• Cron for expiry: 0 9 * * * /usr/bin/node ${DRAFT_QUEUE_HOME:-$HOME/projects/draft-queue}/expire-drafts.cjs >> ${DRAFT_QUEUE_HOME:-$HOME/projects/draft-queue}/draft-queue.log 2>&1
• add-draft.cjs prints the draft ID to stdout on success
• Default expiry: 24 hours. Override with --expires 7d etc.