paperclip-task-bridge

Automate task creation, status updates, and commenting within Paperclip from external Hermes-originated requests.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill bridges the gap between autonomous agent workflows in Hermes and structured task management in Paperclip, ensuring that agent-generated work is tracked, prioritized, and governed within the company's existing project infrastructure.

Core Features & Use Cases

  • Task Orchestration: Create, update, and comment on Paperclip issues directly from Hermes-originated logic.
  • Scoped Governance: Enforce project or issue boundaries using task-bridge API keys to ensure agents only modify authorized work.
  • Use Case: When an agent identifies a bug during a routine check, it can automatically create a new task in the correct project, assign it to itself, and update the status to 'todo' without manual intervention.

Quick Start

Use the paperclip-task-bridge skill to create a new task titled 'Investigate API latency' with a description from the file 'issue.md'.

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 task in Paperclip from Hermes?

Use the create-task command with the --title and --description flags. Ensure your environment is configured with a task-bridge scoped API key and the appropriate parent-id or project-id to define the task boundary.

What is a task-bridge scoped API key?

A task-bridge key is a restricted Paperclip API credential that limits an agent's permissions to specific projects or issues. It prevents agents from accessing company-wide data and ensures they only interact with authorized work boundaries.

Can I assign tasks to other agents?

Yes, you can use the --assignee-agent-id flag with a valid UUID. Ensure your API key has the necessary permissions to assign work to the target agent, otherwise, the request will be rejected by the Paperclip API.

How do I update the status of an existing issue?

Use the update-status command followed by the --issue identifier and the --status flag. Supported statuses include backlog, todo, in_progress, in_review, done, blocked, and cancelled.

What happens if my API key lacks permission?

The Paperclip API will return an error response with a 403 or 401 status code. The bridge helper will catch this and output a JSON error message detailing the failure without exposing sensitive credentials.