share-scan

Run the scan in history mode to collect recent commits by time window or branch delta, score them by teaching value, and review the top candidates. The output is a digest file with ready-to-paste share-code prompts for each selected entry.

Use the --codebase flag with a path to switch from git history mode to codebase mode. The scan globs source files excluding node_modules, build output, and lock files, then scores files by patterns like documented exports, algorithms, and custom hooks.

Yes, every candidate passes through a mandatory security-scrub step that cannot be skipped. Candidates with a BLOCKED verdict are excluded entirely, while WARN candidates appear in the digest with a warning label.

Yes, add a SOCIAL.md file at the project root with a Focus section to boost matching candidate scores and an Avoid section to filter out unwanted patterns. The scoring weights themselves live in references/interesting-patterns.md and can be tuned without editing the skill.

History mode stops with a message telling you to run from a git repo root or use --codebase with a path instead. Codebase mode works without git since it reads files directly from the given path.