What problem does it solve? When the Flow2Spec package releases a new knowledge base template, existing projects fall out of sync: routing manifests, matcher shards, topic metadata, and index files drift from the package version. This Skill runs the full upgrade workflow so the agent aligns the project's .Knowledge/ directory with the current package template instead of leaving stale routing facts in place. ## Core Features & Use Cases - Version precheck and branching: Runs flow2spec version and flow2spec update --check, then branches on CLI/Core/Template state and verifies project-side alignment before stopping. - Fast path vs full flow: Compares the project's projectRev against the package's pkgRev in manifest-routing.json to skip topic-layer work when nothing changed, or run the full cleanup, metadata audit, and index fusion when it did. - Template fusion and audit: Cleans legacy topic files, audits topicMetadata, backfills topic frontmatter and summaries via flow2spec kb build --fix-topics and kb check --strict, and fuses .Knowledge/index.md with the package template while preserving the project-maintained topic list. - Use Case: After upgrading the Flow2Spec npm package, ask the agent to run f2s-kb-upgrade; it re-runs flow2spec init, detects whether topic-layer changes exist, audits and repairs topic metadata, and writes back the aligned projectRev with a validation summary. ## Quick Start Ask the agent to run f2s-kb-upgrade to align this project's knowledge base with the latest Flow2Spec template.
