status-card-query

Automate the creation and compilation of agent-authored status cards using structured company search queries.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the manual overhead of tracking and summarizing business progress by enabling AI agents to programmatically create status cards and compile prose updates into structured, searchable data.

Core Features & Use Cases

  • Agent-Authored Cards: Allows agents to create and maintain status cards via the Paperclip API, scoped to their specific goals.
  • Summarizer Compilation: Converts natural language interest prompts into structured CompanySearchQuery objects for precise issue tracking.
  • Automated Reporting: Facilitates the generation of status summaries by executing queries and writing back results to the Paperclip dashboard.

Quick Start

Use the status-card-query skill to compile the current project status prompt into a structured search query and generate a summary.

Frequently Asked Questions about status-card-query

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

FAQPage Schema
How do I create a status card using the API?

Create a status card by sending a POST request to the /api/companies/{companyId}/status-cards endpoint with an interestPrompt. Ensure the agent has tasks:assign permissions and that enableStatusCards is active.

What is the purpose of the Summarizer compilation mode?

Summarizer compilation transforms a prose interest prompt into structured CompanySearchQuery objects. This allows the system to perform precise, filter-based searches for issues rather than relying on ambiguous free-text queries.

How should I handle multiple projects in a single query?

Use separate CompanySearchQuery objects for each project or label. Each query object supports exactly one projectId and one labelId, ensuring accurate filtering for complex status card requests.

Can I update an existing status card summary?

Yes, use the PATCH method to refine the interestPrompt of an owned card, or use the PUT /api/status-cards/{statusCardId}/summary endpoint to write back a new summary from an assigned generation run.

What are the limitations on status card queries?

Status card queries are capped at a limit of 50 results per query. It is recommended to use the smallest useful value, typically 20, to maintain performance and relevance.