status-card-query

1# Status card query
2 
3Use this skill in one of two modes:
4 
51. **Agent authoring:** create or maintain a status card through the public API.
62. **Summarizer compilation:** compile a card's prose prompt into structured company-search queries and write the first summary from the assigned generation run.
7 
8## Agent-authored card recipe
9 
10Agent-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`.
11 
12Normalize the run-provided API base and create a manual card:
13 
14```bash
15PAPERCLIP_API_BASE="${PAPERCLIP_API_URL%/}"
16PAPERCLIP_API_BASE="${PAPERCLIP_API_BASE%/api}"
17 
18curl -sS -X POST \
19  -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
20  -H "Content-Type: application/json" \
21  -d '{"interestPrompt":"Blocked or in-review launch work updated this week"}' \
22  "$PAPERCLIP_API_BASE/api/companies/$PAPERCLIP_COMPANY_ID/status-cards"
23```
24 
25Creation returns `201` and queues compilation automatically. Save the returned card id. To refine an owned card or request a refresh:
26 
27```bash
28curl -sS -X PATCH \
29  -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
30  -H "Content-Type: application/json" \
31  -d '{"interestPrompt":"Blocked or in-review launch work updated this week. Call out the single next decision."}' \
32  "$PAPERCLIP_API_BASE/api/status-cards/$STATUS_CARD_ID"
33 
34curl -sS -X POST \
35…