insights-share

Use this skill when the user wants to force-finalize the in-flight session buffer immediately, instead of waiting for the 30-min idle threshold. Triggered by "/insight-flush", "flush insights", "push my insight buffer now", "publish lessons now", "force-sync the mirror". Reads the local buffer, runs the two-layer PII filter, and pushes any surviving lessons to the mirror repo.

Use this skill when the user (or another Claude instance) wants to rate a previously injected insight as good / bad / irrelevant for the current task. Triggered by "/insight-rate", "rate this insight", "this lesson saved me time", "this lesson was wrong", "thumbs up the insight", or similar phrasings. Writes a single rating record to the per-repo ratings.jsonl. Used at Gate 1 to compute "≥1 cross-engineer relevant retrieval / week" and detect drift in topic-tag inference.

Use this skill when the user has just installed the insights-share plugin and asks any onboarding question — "what next", "where is the README", "how do I use this plugin", "/insight-help", "show me the insights-share quickstart", "what does this plugin do for me". The skill prints a compact onboarding card pointing to the README on disk, the four slash commands, statusline wiring, and the optional self-host stub server.

Use this skill when a Claude instance has just hit, fixed, or learned about a non-obvious trap that another teammate (or another Claude instance) would benefit from knowing. Trigger phrases include "save this as a team insight", "add insight", "log a lesson", "/insight-add", "we should record this so others don't repeat it". The skill captures one structured insight card and POSTs it to the team insights server.

Use this skill when a Claude instance is bootstrapping a new repository or onboarding a project that is not yet wired into the team insights system. Trigger phrases include "install insights into this repo", "wire insights-share here", "/insight-install", "wire this repo so teammates inherit insights". The skill idempotently appends a force-install block to the project CLAUDE.md (append-only) and verifies hook registration so any future Claude instance entering this repo is guided to install the plugin.

Use this skill when a Claude instance wants to manually look up team insights before acting on a non-trivial task — e.g. before changing build configuration, touching auth, writing a migration, or wiring a hook. Trigger phrases include "search insights", "any team lesson on X", "/insight-search", "have we hit this before". The skill performs a keyword search against the team insights server and renders the top hits as a compact briefing.

Use this skill when a Claude instance needs to start, stop, ping, or run the nightly automation cycle of the self-host insights server. Trigger phrases include "start insights server", "ping the insights server", "run nightly insights sync", "/insight-server start|stop|ping|nightly", "is the team insights backend up". The skill is a thin operator over the self-host server stub documented in references/self-host.md; the production backend is intentionally deferred.