Preserve the complete Layout while adding a standalone Mod named skillshare. Generate both packages from one canonical mod and protect custom layouts and usage meters during installation and updates. Keep release versions aligned and route native Herdr instructions separately within existing context budgets.
6.2 KiB
sidebar_position
| sidebar_position |
|---|
| 8 |
Using skillshare in Herdr
A skillshare panel beside your agents: see what needs an update or a sync, and act on it without leaving Herdr.
Prerequisites
- Herdr 0.1.12 or later
- skillshare installed on each machine Herdr connects to, in
~/.local/bin,~/go/bin,/opt/homebrew/binor/usr/local/bin
Setup
Mod: keep your current layout (recommended)
Use the standalone Mod package to add the panel without replacing your window. Paste this prompt into an agent in Herdr:
Read ~/.config/herdr-app/AGENTS.md, then add this mod from https://github.com/runkids/skillshare/tree/main/herdr/skillshare-mod. Follow its RECIPE.md: add only the skillshare toggle and panel to my current layout, preserving my status bar, usage meters and all other customizations. Reuse existing skillshare nodes instead of duplicating them.
The package has no layouts/ folder. Its recipe adds or reuses only the skillshare toggle and panel, preserving your status bar, CLI usage meters, theme and other customizations. A Herdr-shipped layout is cloned before editing.
From Herdr layouts
The layout is listed at Herdr layouts. Paste this prompt into an agent in Herdr:
Read ~/.config/herdr-app/AGENTS.md, then add this layout: herdr.dev/layouts/runkids/skillshare--herdr--skillshare
The agent reads every file before it adds the layout, and your own layout stays as it is. Switch layouts with ctrl-shift-l.
By hand
The panel ships in the skillshare repository under herdr/skillshare.
- Copy
mods/skillshare/to~/.config/herdr-app/mods/skillshare/. - Copy
layouts/herdr-skillshare.jsonandlayouts/herdr-skillshare.pngto~/.config/herdr-app/layouts/, then switch to theherdr-skillsharelayout in Herdr's settings. To keep your own layout instead, add the two blocks listed in the folder'sREADME.md. - Run
herdr-app check ~/.config/herdr-app/mods/skillshare.
A skillshare button appears in the tab bar. It shows and hides the panel, and the panel stays open or closed as you switch spaces.
Updating the Panel
For either installation option, an agent-assisted update should back up and replace only the installed skillshare mod. Keep the current layout selected; preserve every layout, custom status bar, usage meter, setting, key binding and unrelated mod. If a layout adjustment is necessary, merge only skillshare's own nodes instead of reapplying the complete layout.
While it is shown, the panel asks GitHub once an hour for the latest skillshare release. When a newer one is published, its header shows Update panel. It asks first, replaces the files in ~/.config/herdr-app/mods/skillshare/ with the ones that release ships, and Herdr reloads the panel. The files it replaced are kept in that folder's .bak-update-<version>; changes you made to them are not carried over. Your layout is not touched.
A panel installed before this button existed has no update check. Copy mods/skillshare/ from the latest release over ~/.config/herdr-app/mods/skillshare/ once by hand; later updates come from the button.
What the Panel Does
The panel follows the space Herdr shows. It runs skillshare on that space's machine, in the focused terminal's folder.
- Overview answers first: Everything is in sync, or how many targets need one, with a single Sync button. Under it, a count of each kind in the source and a line to every target show which ones are waiting. The rest of the tab lists only what needs you: what waits for a sync, what has an update, and hook notices. In a project with
.skillshare/config.yaml, an All · Project · Global switch beside the tabs picks the scope. - Library lists skills, agents, MCP servers, plugins and hooks, grouped into Needs sync, Update available, In sync and Off for disabled entries. For skills and agents, In sync groups entries from the same repository into collapsible rows; switch to List for a flat list.
- Rows open a preview. A skill shows its
SKILL.mdand files, an MCP server its settings with secret values hidden, and the preview's Targets tab shows the state per target. Skills and agents offer Update, Diff, Disable (or Enable for a disabled one; the next sync applies it), Uninstall, and Ask <agent> to audit…, which sends the item to the focused Herdr agent after you confirm. Top-level declared hooks offer Enable, Disable and Remove, each after confirmation; Sync applies the saved changes. - Hook counts include named entries and pending cleanup; diagnostic notices get rows of their own. Hook conflicts block syncing all resource kinds until resolved in the CLI or dashboard. If the plan cannot be read, entries show unknown sync status outside the groups.
- Install takes a repository URL. A repository with several skills shows a pick list. The panel clones it, runs
skillshare auditon the clone, and installs only when the audit passes. A blocked audit shows the findings, with Install anyway (--force) and Ask <agent> to review…. - Source shows your source repository's state. Its dialog offers Pull, Commit and push, and Sync both ways. When a pull stops on files both machines changed, you pick a version per file from a side-by-side preview.
.metadata.jsonmerges per entry, the wayskillshare pulldoes. - Machines shows each Herdr machine's skillshare version, its remote, source and targets, and doctor warnings, with Pull and sync and, when a newer release exists, Update. A machine with uncommitted or unpushed changes offers Sync both ways instead, because a plain pull would refuse.
The panel refreshes every 20 seconds while it is shown, runs skillshare check every 10 minutes, and does nothing while hidden.
