status-card-query

Create Todero status cards and compile prose prompts into structured company-search queries.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams need recurring, curated status summaries of issue activity without manually filtering boards each time. This Skill lets agents author Todero status cards through the public API and lets the assigned Summarizer compile a card's prose interest prompt into bounded CompanySearchQuery objects, then write the first summary. ## Core Features & Use Cases - Agent-authored cards: Create, refine, and refresh company-scoped status cards via the REST API, with limits of 20 cards per agent and 4,000 characters per interest prompt. - Summarizer compilation: Convert a prose prompt into one or more structured CompanySearchQuery objects with union semantics, resolving project and label names to UUIDs and applying bounded limits. - Write-back workflow: Write the compiled query to the query endpoint, then execute the scope and write the first full Markdown summary, plus handle later incremental or full update assignments. - Use Case: A manager asks for a card tracking "blocked or in-review launch work updated this week." The agent creates the card, and the Summarizer compiles it into a query filtered by status and updatedWithin 7d, then writes the first summary. ## Quick Start Ask the agent to create a Todero status card with the interest prompt "Blocked or in-review launch work updated this week" and compile its first 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 Todero status card via the API?

Send a POST request with an interestPrompt to /api/companies/{companyId}/status-cards using a Bearer token. Creation returns 201 and queues compilation automatically; save the returned card id for later updates.

How do I compile a status card prompt into search queries?

Convert the prose prompt into CompanySearchQuery objects using structured filters like status, priority, projectId, labelId, and updatedWithin. Resolve project and label names to UUIDs first, and keep limit at 20 or below with offset 0.

What limits apply to agent-authored status cards?

An agent may author at most 20 cards and send at most 4,000 characters in interestPrompt. Cards remain company-scoped, require the tasks:assign permission, and are only available when enableStatusCards is enabled.

Can I call the status card query or summary endpoints while authoring?

No. The /query and /summary write-back routes are reserved for the assigned Summarizer generation issue and run. Authoring agents should only create, patch, or refresh cards through the public card endpoints.

How do incremental status card updates work?

Update assignments include operation, kind, trigger, fingerprint, and the changed-issue delta. For incremental updates, patch the supplied previous Markdown using only the changed issues without refetching the issue list.