Agent skill

Herdr Kit Workflows

by mastra-ai in mastra-ai/mastra

Set up and operate Herdr Kit safely: install and configure the plugin and Mastra Code integration, manage Review and Work repository scope, open primary repository workspaces, synchronize managers…

Custom licenceAuto-check passedDevelopment

Install Herdr Kit Workflows

skills CLI
$ npx skills add mastra-ai/mastra --skill herdr-kit-workflows -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mastra-ai/mastra herdr-kit-workflows --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mastra-ai/mastra.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.mastracode/skills/herdr-kit-workflows .claude/skills/herdr-kit-workflows && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
herdr-kit-workflows
GitHub stars
29k
Token cost
~3.9k tokens
SKILL.md length
1,366 words
Files
1
Skills in repo
44
Repo updated
First seen
Licence
Custom licence

At a glance

Set up and operate Herdr Kit safely: install and configure the plugin and Mastra Code integration, manage Review and Work repository scope, open primary repository workspaces, synchronize managers…

  • Works in 6 steps: Install the plugin and official Mastra… → Resolve the installed plugin as above… → Configure required launcher commands in… → …
  • Tasks that involve Git worktrees
  • SKILL.md covers Safety and authority, Discover and negotiate the…, Detect and update an outdated… and New-user setup, plus 9 more sections
  • Calls python3 and git; reaches github.com; needs AUTHORITATIVE_MANAGER_KEY

What it does

Herdr Kit Workflows is an agent skill from mastra-ai/mastra. Set up and operate Herdr Kit safely: install and configure the plugin and Mastra Code integration, manage Review and Work repository scope, open primary repository workspaces, synchronize managers, materialize or dematerialize managed worktrees, and update Herdr Kit settings or shortcuts.

Its SKILL.md is about 3.9k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Git worktrees. It works with Mastra. The repository describes itself as: Mastra is the modern TypeScript framework for AI-powered applications and agents.

When your agent uses it

  • Tasks that involve Git worktrees

Example prompts

  • “/herdr-kit-workflows”

Requirements

  • Python 3
  • A credential in AUTHORITATIVE_MANAGER_KEY

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Install the plugin and official Mastra Code integration
  2. Resolve the installed plugin as above and inspect its current README.md for the exact supported launcher settings and suggested…
  3. Configure required launcher commands in the Herdr-managed plugin integrations.env documented by that installed version. Preserve mode…
  4. Add only the shortcuts the user requests to ~/.config/herdr/config.toml. Plugin installation intentionally does not edit personal…
  5. Validate and apply configuration
  6. Start new Mastra Code sessions through the official Herdr integration before relying on lifecycle state or PR labels.

What it can do on your machine

Read from SKILL.md and the folder at commit b98829a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python3
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • AUTHORITATIVE_MANAGER_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Herdr Kit Workflows loads about 3.9k tokens when it runs. Until then it costs about 77 tokens; SKILL.md has 1,366 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~77
When it runs · the whole SKILL.md, loaded when a task matches
~3.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,366 words (~3,903 tokens).

“Use Herdr Kit's supported Herdr and protocol-1 interfaces for setup, configuration, repository scope, synchronization, and worktree lifecycle operations.”

— opening of SKILL.md by mastra-ai, Custom licence
name
herdr-kit-workflows

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .mastracode/skills/herdr-kit-workflows of mastra-ai/mastra.

Open the folder on GitHubat commit b98829a

Compare with similar skills

Herdr Kit Workflows next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Herdr Kit Workflows compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Herdr Kit Workflows this skillmastra-ai/mastra29k—~3.9kAutomated safety check: PassCustom licence
Finishing a Development Branchobra/superpowers297k5 repos~1.9kAutomated safety check: PassMIT
Migrate Core Code to Submodulestinyhumansai/openhuman42k—~2.6kAutomated safety check: PassGPL-3.0
Finishing A Development Branchfarm-fe/farm5.6k35 repos~1.8kAutomated safety check: PassMIT
Git Worktree Cleanuplobehub/lobehub83k—~2.8kAutomated safety check: PassCustom licence
Keep Codex Fastvibeforge1111/keep-codex-fast1.6k—~3.1kAutomated safety check: PassMIT

Similar skills

  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    297k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Migrate Core Code to Submodules

    tinyhumansai/openhuman

    Plans and carries out moving non-host-specific code and its tests from the OpenHuman core into vendored tiny submodule libraries, then releases the submodule and re-pins the host.

    42k GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed
  • A skill your agent uses when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for…

    5.6k GitHub starsUsed in 35 repos~1.8k tokens
    DevelopmentAuto-check passed
  • Git Worktree Cleanup

    lobehub/lobehub

    Audits stale Git worktrees and branches with a bundled script, classifies each one, and deletes only after you approve the exact candidates.

    83k GitHub stars~2.8k tokensUpdated today
    DevelopmentAuto-check passed
  • Keep Codex Fast

    vibeforge1111/keep-codex-fast

    A skill your agent uses when Codex feels slow or bloated, when local sessions/logs/worktrees/config have grown over time, or when a user wants safe maintenance for Codex Desktop/CLI state.

    1.6k GitHub stars~3.1k tokensUpdated 5 mo ago
    DevelopmentAuto-check passed
  • Pre-Release PR Triage

    jamiepine/voicebox

    Sorts a backlog of open pull requests into must-merge, candidate, superseded and deferred, writes a triage doc and works the merge loop before a release.

    57k GitHub stars~3.1k tokensUpdated 4 days ago
    DevelopmentAuto-check passed

More from mastra-ai/mastra

All 44 skills in this repo
  • Docs Audit

    mastra-ai/mastra

    Autonomous, report-only documentation review for Mastra docs.

    29k GitHub stars~3k tokensUpdated today
    Auto-check passed
  • Builder Smoke Test

    mastra-ai/mastra

    Smoke test the Agent Builder feature branch end-to-end against a hermetic project scaffolded by the skill (linked to the current worktree).

    29k GitHub stars~11k tokensUpdated today
    Auto-check: notes
  • Mastra Smoke Test

    mastra-ai/mastra

    Smoke test Mastra projects locally or deploy to staging/production.

    29k GitHub stars~4k tokensUpdated today
    Auto-check: notes
  • React Best Practices

    mastra-ai/mastra

    React performance optimization guidelines from Mastra Engineering.

    29k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Agent Prompt Quality Bar

    mastra-ai/mastra

    Universal quality bar and final audit rubric for any agent system prompt.

    29k GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Coding Agent

    mastra-ai/mastra

    Authoring playbook for building agents that write, edit, review, or refactor code.

    29k GitHub stars~2.3k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Herdr Kit Workflows

What does Herdr Kit Workflows do?

Set up and operate Herdr Kit safely: install and configure the plugin and Mastra Code integration, manage Review and Work repository scope, open primary repository workspaces, synchronize managers…. Herdr Kit Workflows is an agent skill from mastra-ai/mastra. Set up and operate Herdr Kit safely: install and configure the plugin and Mastra Code integration, manage Review and Work repository scope, open primary repository workspaces, synchronize managers, materialize or dematerialize managed worktrees, and update Herdr Kit settings or shortcuts.

When should I use Herdr Kit Workflows?

Herdr Kit Workflows fits situations like: tasks that involve Git worktrees.

How do I install Herdr Kit Workflows in Claude Code?

Run `npx skills add mastra-ai/mastra --skill herdr-kit-workflows -a claude-code`. Or copy the skill folder (.mastracode/skills/herdr-kit-workflows in mastra-ai/mastra) into .claude/skills/herdr-kit-workflows in your project. Claude Code loads it when a task matches its description.

How do I install Herdr Kit Workflows in Codex?

Run `npx skills add mastra-ai/mastra --skill herdr-kit-workflows -a codex`. Or copy the skill folder (.mastracode/skills/herdr-kit-workflows in mastra-ai/mastra) into .agents/skills/herdr-kit-workflows in your project. Codex loads it when a task matches its description.

Can I use Herdr Kit Workflows in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mastra-ai/mastra --skill herdr-kit-workflows -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/herdr-kit-workflows, .gemini/skills/herdr-kit-workflows, .github/skills/herdr-kit-workflows and .opencode/skills/herdr-kit-workflows in your project.

What does Herdr Kit Workflows need to run?

Going by SKILL.md and its folder, Herdr Kit Workflows needs the command-line tools its instructions call (python3 and git) and credentials named AUTHORITATIVE_MANAGER_KEY. Our summary lists: Python 3; A credential in AUTHORITATIVE_MANAGER_KEY.

Does Herdr Kit Workflows access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Herdr Kit Workflows safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Herdr Kit Workflows use?

Herdr Kit Workflows has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Herdr Kit Workflows use?

About 3.9k tokens (SKILL.md is roughly 16k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Herdr Kit Workflows?

Skills that share tags, products or a category with Herdr Kit Workflows: Finishing a Development Branch (obra/superpowers, 297k stars), Migrate Core Code to Submodules (tinyhumansai/openhuman, 42k stars), Finishing A Development Branch (farm-fe/farm, 5.6k stars) and Git Worktree Cleanup (lobehub/lobehub, 83k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Herdr Kit Workflows?

mastra-ai (a GitHub organization) maintains it in mastra-ai/mastra, which has 28,698 GitHub stars. The repository holds 44 skills in this directory. The repository was last updated on October 11, 2026.

Source: mastra-ai/mastra on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.