f2s-kb-migrate

Migrates legacy knowledge bases into the .Knowledge directory structure with staged confirmation.

4|Updated Aug 4, 2026
One-click install
npx skills add https://github.com/double-coding-lab/PixelPrint --skill f2s-kb-migrate-double-coding-lab
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: f2s-kb-migrate
Source: https://github.com/double-coding-lab/PixelPrint/tree/main/.dsh/skills/f2s-kb-migrate
Command: npx skills add https://github.com/double-coding-lab/PixelPrint --skill f2s-kb-migrate-double-coding-lab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Projects using the legacy knowledge organization (docs-index.md, rules/main.md, scattered business skills, and stock-docs/req-docs folders) need a controlled, one-time migration into the new .Knowledge architecture without losing files or leaving dual entry points behind. ## Core Features & Use Cases - Full Inventory and Mapping: Reads docs-index.md and rules entry files to build topic, business rule, business skill, and document migration queues, excluding f2s-* package skills. - Staged Migration with State Recovery: Migrates topics, stock-docs, and req-docs one item at a time with user confirmation, tracked in .Knowledge/.migrate-state.json for pause and resume. - Mandatory Report and Cleanup: Writes .Knowledge/migration-report.md with a migration mapping table and deletion checklist, then deletes confirmed legacy rules, skills, and index files while preserving baseline f2s-* rules. - Use Case: A team upgrading an old Flow2Spec project runs this skill to move all legacy rules and docs into .Knowledge, review the deletion checklist, and finish with a clean single-entry knowledge base. ## Quick Start Ask the agent to migrate the legacy knowledge base to .Knowledge by running the f2s-kb-migrate skill on this repository.

Frequently Asked Questions about f2s-kb-migrate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate a legacy knowledge base to .Knowledge?▼

Run the f2s-kb-migrate skill, which inventories docs-index.md, rules entry files, business skills, and stock-docs/req-docs, then migrates them topic by topic and file by file into .Knowledge with your confirmation at each step.

What is the difference between f2s-kb-migrate and f2s-kb-upgrade?▼

f2s-kb-migrate performs the one-time structural move from legacy indexes and folders into .Knowledge. f2s-kb-upgrade handles ongoing template upgrades and runs flow2spec init to align routing manifests and agent rules; V1 projects must migrate first.

Can I resume an interrupted knowledge base migration?▼

Yes. Progress is persisted in .Knowledge/.migrate-state.json after every migrated item. Reply 'continue' to resume from the pending queues, 'retry <item>' to redo one entry, or 'stop' to pause with status recorded.

Does the migration delete f2s-* skills or baseline rules?▼

No. skills/f2s-* package skills are never migrated into .Knowledge and never deleted. The three baseline rules (f2s-flow2spec-unified-entry, f2s-implement-tech-design, f2s-stock-docs-vs-req-docs) are also always preserved.

How are legacy files deleted after migration?▼

After migration acceptance, the skill writes .Knowledge/migration-report.md containing a default fully-selected deletion checklist. You reply 'confirm list' or 'exclude: <path>'; only confirmed paths are physically deleted, and a deletion execution record is appended to the report.