Skills

Status Card Queries

Creates agent status cards and compiles interest prompts into bounded search queries.

Install

npx skills add paperclipai/paperclip --skill status-card-query -g -a claude-code -y
Repository
paperclipai/paperclip110k
Category
AI and agents
Updated
3d ago
License
MIT
Context cost
Lightabout 1,485 tokens
Runs scripts
No, instructions only

What it does

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.

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:

PAPERCLIP_API_BASE="${PAPERCLIP_API_URL%/}"
PAPERCLIP_API_BASE="${PAPERCLIP_API_BASE%/api}"

curl -sS -X POST \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"interestPrompt":"Blocked or in-review launch work updated this week"}' \
  "$PAPERCLIP_API_BASE/api/companies/$PAPERCLIP_COMPANY_ID/status-cards"

Creation returns 201 and queues compilation automatically. Save the returned card id. To refine an owned card or request a refresh:

curl -sS -X PATCH \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"interestPrompt":"Blocked or in-review launch work updated this week. Call out the single next decision."}' \
  "$PAPERCLIP_API_BASE/api/status-cards/$STATUS_CARD_ID"

curl -sS -X POST \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"full":false}' \
  "$PAPERCLIP_API_BASE/api/status-cards/$STATUS_CARD_ID/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

Read the whole SKILL.md on GitHub

More in AI and agents