Draft Queue

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  \
  --desc "description" \
  --payload ''

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

Payloads by type

telegram-message

{ "chat_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 

Reject (when the user says "reject ID")

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

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.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: JansenAnalytics
• Source: JansenAnalytics/claudex
• License: MIT

Install and usage instructions live in the source repository linked above.