skills.rest
mastra-ai
mastra-aiOFFICIAL
Explore all skills by this author →
Website𝕏@mastraGitHub

herdr-manager-query

Query Herdr Review and Work Manager inventory and materialize confirmed remote-only review records.

27.6k|2.7k|Updated Aug 6, 2024
Search Tags:#CLI#worktree#recommendation#herdr#Code review#Pull request#inventory query
One-click install
npx skills add https://github.com/mastra-ai/mastra --skill herdr-manager-query
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: herdr-manager-query
Source: https://github.com/mastra-ai/mastra/tree/main/.mastracode/skills/herdr-manager-query
Command: npx skills add https://github.com/mastra-ai/mastra --skill herdr-manager-query

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It gives you a single authoritative, repository-independent view of all your Herdr Review Manager and Work Manager records so you can decide what PR to review or work on next without manually checking GitHub, local Git state, or raw manager files.

Core Features & Use Cases

  • Authoritative inventory queries: Discovers the enabled herdr-kit plugin, negotiates protocol capabilities, and queries the global manager inventory with strict schema validation.
  • Work recommendations: Ranks open review requests and work items by actionability, diff size, CI state, freshness, and checkout safety, with concrete next actions.
  • Confirmed materialization: Materializes user-confirmed remote-only Review Manager records through the plugin's public CLI with frozen head SHAs and per-item outcome reporting.
  • Use Case: Ask which PRs still need your review; the skill queries the manager inventory, compares review event timestamps against your latest submitted review, and recommends the smallest actionable PRs first.

Quick Start

Ask the assistant which Herdr review requests or managed PRs need your attention right now.

Frequently Asked Questions about herdr-manager-query

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

FAQPage Schema
How do I find which PRs still need my review?▼

Query the Herdr manager inventory through the herdr-kit plugin CLI and filter Review Manager records where you are requested or have participated. The skill compares review event timestamps against your latest submitted review to identify genuine follow-up feedback.

How do I materialize a remote-only review record in Herdr?▼

Materialization requires explicit user confirmation of the exact repository and PR targets. The skill freezes the confirmed key and head SHA in a request file and calls the plugin's review materialize CLI, which validates against current inventory before mutating.

Can I use gh or git directly instead of the manager inventory?▼

No. The manager inventory is the authoritative source, and the skill explicitly forbids substituting direct GitHub, gh, current-directory Git, TUI scraping, or raw manager state files. If any query step errors, it stops and reports the problem.

What happens if the herdr-kit protocol version is unsupported?▼

The skill negotiates capabilities before any query and aborts if the protocol version is not 1 or the manager_query operation is unavailable. It never guesses around unsupported versions or falls back to alternative data sources.

How are review recommendations ranked?▼

Open Review Manager PRs with actionable work rank first, then smaller diffs by changed files and total changes, recent activity, and passing CI. Cleanup-only, merged, stale, blocked, or hazardous records are deprioritized, and missing diff metadata is never treated as a small PR.

Related Skills

Explore More Software Engineering Skills→
wyattjohwyattjoh
1

herdr

Control herdr workspaces, tabs, and panes via a local unix socket.

Community
Advanced
atomicinnovationatomicinnovation
30

respond-to-pr

Triage and respond to GitHub pull request review feedback.

Official
Advanced
ISmarshISmarsh

pr-check

Monitor CI checks and triage review comments on GitHub pull requests.

Community
Intermediate
yharuto0917yharuto0917

gh-cli

Manage GitHub repositories, issues, pull requests, and Actions from the terminal.

Community
Advanced