Files
skillshare/website/docs/learn
Eirik Corneliussen cbc3614b71 feat(herdr): show extras and memory notes in the panel (#961)
The panel read skills, agents, MCP servers, plugins and hooks, but not
extras, which `sync --all` also syncs. An extra waiting for a sync was
not shown, so Overview could say everything was in sync when it wasn't.

Extras are now a sixth kind, read per scope with `extras list --json`
and `extras memory list --json`. Overview counts them, and an extra
whose target is not `synced` waits for a sync like an MCP server, so
the existing Sync button covers it. Library has an Extras tab with file
extras, folder extras and memory notes. A preview shows the file, or a
folder's files, with its frontmatter, and the targets with their mode
and status. Nothing new can be changed from the panel.

An extra's target is named by the target whose skills folder shares
its parent folder, as the dashboard names it, else by its path. In a
project, `status` reports absolute target paths while extras keep the
config's relative ones, so those are resolved against the project
folder first. Targets that share a skills folder, such as codex and
universal at ~/.agents/skills, come from `status` in no fixed order, so
the first by name names the extra's target.

An extra whose source is missing (`source_exists` is false, or a target
reports `no source`) is not something a sync can fix: `doctor` reports
it as an error, `diff` marks it failed and the dashboard shows it in
red. It goes under Need a look as "source missing", which now holds
more than hook notices, so Overview's title for it is "NEED A LOOK".
With nothing waiting, Overview says how many extras need a look instead
of "Everything is in sync", and the preview says the source is missing
instead of offering a Try again that can't help.

Memory notes never wait for a sync, so a failed memory read, as on a
CLI before 0.24, leaves the sync state confirmed and Sync available.
When that read has never answered, the Extras count is the extras that
were read.

The memory folder also appears as an extra of its own, as it does in
the dashboard's Folders & files.

Refs #930


* fix(herdr): keep missing-source extras on Overview and list only synced files

Review of #961 found two gaps. While extras were read again, or after
`extras list` failed, a missing-source extra turned "unknown" and was
shown neither under Need a look nor under Sync status unconfirmed. It
now waits under Sync status unconfirmed, like other rows whose read is
pending.

A folder extra's preview listed its files with the skill reader, which
skips only the top-level .git. Extras sync skips every .git folder and
every .metadata.json (DiscoverExtraFiles), and .metadata.json sorted
first, so it could open as the default document. The preview now lists
the folder as extras sync sees it.

Refs #930
2026-11-20 21:39:53 +08:00
..