paperclip-task-bridge

Create, comment on, update, and list Todero tasks from Hermes using scoped API credentials.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/nabitllc/todero --skill paperclip-task-bridge-nabitllc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: paperclip-task-bridge
Source: https://github.com/nabitllc/todero/tree/main/packages/adapters/hermes/skills/paperclip-task-bridge
Command: npx skills add https://github.com/nabitllc/todero --skill paperclip-task-bridge-nabitllc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Hermes agents need a controlled way to create and update Todero work items without holding a full agent API key that grants broad company-wide access. This Skill bridges Hermes to the Todero API using a narrowly scoped task_bridge key, so external runtimes can only operate within approved task boundaries. ## Core Features & Use Cases - Scoped Task Creation: Create Todero issues under approved parent issues or projects, with priority, status, work mode, and assignee controls. - Progress Updates: Post comments and transition issue statuses (todo, in_progress, in_review, done, blocked, cancelled) with optional resume/reopen flags. - Assignment Listing: List tasks currently assigned to the authenticated Hermes agent to avoid duplicate work. - Use Case: A Hermes agent investigating checkout failures creates a child task under an approved parent issue, comments with findings, and moves the issue to in_review when finished. ## Quick Start Set PAPERCLIP_API_URL and PAPERCLIP_BRIDGE_API_KEY in your environment, then ask the agent to create a Todero task titled "Investigate checkout failures" under your approved parent issue.

Frequently Asked Questions about paperclip-task-bridge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Todero task from a Hermes agent?

Run the paperclip-task.mjs helper with the create-task command, passing --title and optionally --description, --parent-id, --priority, and --status. The task defaults to being assigned to the authenticated Hermes agent unless you pass --unassigned.

What API key does the Todero task bridge require?

It requires a Todero agent API key created with scope.kind set to task_bridge, stored in PAPERCLIP_BRIDGE_API_KEY. A full agent key must never be used in an internet-facing Hermes runtime because it grants broad company-wide access.

Can a task_bridge key access all Todero issues?

No. A bridge key can only create tasks inside its approved parent-issue or project boundary and can only comment on or update bridge-created or assigned issues. It cannot use company-wide issue list, search, or read surfaces.

How do I update a Todero issue status from the command line?

Use the update-status command with --issue and --status, where status is one of backlog, todo, in_progress, in_review, done, blocked, or cancelled. You can attach a comment with --comment or --comment-file.

Why does the helper fail with a missing environment variable error?

The helper exits with a usage error when PAPERCLIP_API_URL or PAPERCLIP_BRIDGE_API_KEY is unset. Configure both in the Hermes environment or profile secrets, never in prompt text, before running any command.