Agent skill · operations · paperclipai
status-card-query
Create and maintain agent-authored Paperclip status cards, or compile a prose interest prompt into bounded CompanySearchQuery objects and write the first summary from the assigned Summarizer run.
Why this skill is useful
Adds specific API commands for creating and managing Paperclip status cards that the AI wouldn't reliably generate on its own.
What it needs
Requires paperclipai account access. About 3k tokens when loaded. Last updated 2026-08-07. 75,771 stars on the source repository.
What this skill does
Status card query Use this skill in one of two modes: 1. Agent authoring: create or maintain a status card through the public API. 2. Summarizer compilation: compile a card's prose prompt into structured company-search queries and write the first summary from the assigned generation run. Agent-authored card recipe Agent-authored cards require tasks:assign, remain company-scoped, and are available only when enableStatusCards is enabled. An agent may manage only cards it authored, may author at most 20 cards, and may send at most 4,000 characters in interestPrompt. Normalize the run-provided API base and create a manual card: Creation returns 201 and queues compilation automatically. Save the returned card id. To refine an owned card or request a refresh: Do not call /query or /summary while authoring. Those write-back routes are reserved for the assigned Summarizer generation issue and run. Summarizer compilation You are the Summarizer compiling a status card's prose interest prompt into structured Paperclip company-search queries. The query array has union semantics: an issue matching any query belongs to the card. Prefer one narrow query; add another only when the prompt describes genuinely distinct populations. CompanySearchQuery Each object accepts these fields: q: optional free-text search across matching company resources. Use it only for concepts not represented by structured filters. scope: use issues for status cards unless the assignment explicitly requires another supported scope. status: issue-status array. priority: issue-priority array. assigneeAgentId / assigneeUserId: a resolved assignee id. projectId: one resolved project UUID. labelId: one resolved label UUID. updatedWithin: a bounded duration such as 24h, 7d, 4w, or 3m. sort: relevance, updated, created, or priority. limit: 1–50. Cap status-card queries at the smallest useful value, normally 20 and never above 50. offset: normally 0. Resolve project and label names to ids before writing the query. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills paperclipai/status-card-query