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

herdr-kit-workflows

Configure Herdr Kit and manage Review and Work manager scope, synchronization, and worktree lifecycles.

27.6k|2.7k|Updated Aug 6, 2024
Search Tags:#plugin configuration#Mastra#Synchronization#repository scope#herdr#Git worktree#Pull request
One-click install
npx skills add https://github.com/mastra-ai/mastra --skill herdr-kit-workflows
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: herdr-kit-workflows
Source: https://github.com/mastra-ai/mastra/tree/main/.mastracode/skills/herdr-kit-workflows
Command: npx skills add https://github.com/mastra-ai/mastra --skill herdr-kit-workflows

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Operating the Herdr Kit plugin for Herdr and Mastra Code involves strict safety rules, capability negotiation, and manager-specific repository scope that are easy to get wrong, risking stale worktrees, unintended clones, or corrupted manager state.

Core Features & Use Cases

  • Safe Setup and Configuration: Install the herdr-kit plugin and Mastra Code integration, validate configuration with herdr config check, and update outdated plugins only through verified channels.
  • Manager Scope and Synchronization: Register, list, open, and remove repositories in Review or Work manager scope, and synchronize full or selected manager records using authoritative query data.
  • Worktree Lifecycle Management: Materialize and dematerialize Review and Work worktrees with frozen keys, head SHAs, and revisions, verified by post-operation queries.
  • Use Case: A developer wants to check out a remote PR locally for review. The skill queries the Review manager, confirms the exact record and head SHA with the user, materializes the linked worktree, and verifies the resulting state before reporting.

Quick Start

Ask the assistant to install and configure Herdr Kit, or to materialize a specific remote PR worktree from the Review manager.

Frequently Asked Questions about herdr-kit-workflows

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

FAQPage Schema
How do I install and set up Herdr Kit with Mastra Code?▼

Install the plugin with `herdr plugin install mastra-ai/herdr-kit`, then run `herdr integration install mastracode` and `herdr server reload-config`. Configure launcher settings in the plugin's integrations.env and validate with `herdr config check`.

How do I materialize a remote PR worktree for review?▼

Query the Review manager for authoritative records, confirm the exact key and head SHA with the user, then submit a materialize request with those frozen values. Afterward, re-query to verify the worktree path and head SHA match.

Why does the skill refuse to run herdr commands in my terminal?▼

Herdr Kit workflows require running inside a Herdr session, detected by the HERDR_ENV environment variable being set to 1. Outside a Herdr session, the skill stops and reports that these workflows are unavailable.

Does adding a repository to Review scope also add it to Work scope?▼

No, repository scope is manager-specific. Adding a repository to Review scope does not register it in Work scope; each manager requires its own add-local or clone registration with a concrete checkout path.

What happens when the installed herdr-kit plugin is outdated?▼

A missing capability or unsupported protocol version is treated as an update signal. GitHub-installed plugins are reinstalled via `herdr plugin install`, while locally linked plugins are only fast-forward pulled after verifying remote identity and a clean checkout.

Related Skills

Explore More Software Engineering Skills→
AnsteorraAnsteorra
6

gh-cli

Manage GitHub repositories, issues, pull requests, and Actions via the gh CLI.

Official
Advanced
VIPER-MetricsVIPER-Metrics
1

close-pr

Close pull requests after testing and finalize issues, wiki docs, and worktrees.

Official
Advanced
MatthieuszMatthieusz

herdr

Execute herdr CLI commands to manage workspaces, tabs, and panes.

Community
Intermediate
DimillianDimillian
3.9k

github

Automate GitHub issue, PR, CI, and API tasks via the gh CLI.

Community
Advanced