mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-20 20:34:19 +00:00
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
Website
Documentation site for skillshare, built with Docusaurus.
Install
npm install
Local Development
npm start
Quality Checks
npm run typecheck
npm run clear
Build and Preview
npm run build
npm run serve
Deployment
npm run deploy
If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the gh-pages branch.