skills.rest
liqunx
liqunxCOMMUNITY
Explore all skills by this author →
GitHub

wf-migrate-openspec

Migrate OpenSpec repositories into WikiFlow docs/wiki/current and specs/spec.md formats.

2|Updated Apr 23, 2026
Search Tags:#migration#openspec#spec conversion#wikiflow#wiki frontmatter#config update
One-click install
npx skills add https://github.com/liqunx/wikiflow --skill wf-migrate-openspec
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wf-migrate-openspec
Source: https://github.com/liqunx/wikiflow/tree/main/skills/wf-migrate-openspec
Command: npx skills add https://github.com/liqunx/wikiflow --skill wf-migrate-openspec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the painful, error-prone manual work of migrating an existing OpenSpec-based project into the WikiFlow document-and-specs structure so your workflow can continue in a consistent format.

Core Features & Use Cases

  • OpenSpec detection and inventory: Scans for an openspec/ directory, reads openspec/config.yaml, and summarizes detected content (wiki pages, specs, raw docs) before proceeding.
  • Wiki and specs transformation: Migrates wiki pages into WikiFlow’s docs/wiki/current/ layout with added frontmatter, and converts openspec/specs/ into WikiFlow spec.md format under the correct active/archive paths.
  • Raw and archive handling: Merges openspec/docs/raw/ into WikiFlow raw storage and compiles openspec/changes/archive/ into the current wiki history.
  • One-way configuration conversion: Updates .wikiflow/config.json fields based on openspec/config.yaml, supporting a clean transition without back-migration.

Quick Start

Ask the AI to run /wf-migrate-openspec and complete the one-time migration from your existing OpenSpec directory into WikiFlow.

Frequently Asked Questions about wf-migrate-openspec

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

FAQPage Schema
How do I migrate OpenSpec to WikiFlow format?▼

Migrating OpenSpec to WikiFlow involves scanning the openspec directory, transforming wiki frontmatter, converting specs into spec.md files, and updating .wikiflow/config.json to complete the structural transition.

Can I convert OpenSpec config.yaml to WikiFlow config.json?▼

Yes, OpenSpec config.yaml is converted to WikiFlow config.json. The migration reads your existing OpenSpec configuration and updates the .wikiflow/config.json fields to support a clean, one-way transition without back-migration.

What is the process for moving OpenSpec specs into WikiFlow spec.md files?▼

Moving OpenSpec specs into WikiFlow spec.md files requires converting openspec/specs/ using the wf-plan template. The migration places these converted files under the correct active or archive paths within the WikiFlow specs structure.

Does the OpenSpec to WikiFlow migration support raw docs and archived changes?▼

Yes, the OpenSpec to WikiFlow migration supports raw docs and archived changes. It merges openspec/docs/raw/ into WikiFlow raw storage and compiles openspec/changes/archive/ into the current wiki history layout.

What do I need to scan before converting an OpenSpec repository to WikiFlow?▼

Before converting an OpenSpec repository to WikiFlow, you need an OpenSpec inventory. The migration scans for an openspec/ directory, reads openspec/config.yaml, and summarizes detected wiki pages, specs, and raw docs before proceeding.

Can I migrate backwards from WikiFlow to OpenSpec?▼

No, you cannot migrate backwards from WikiFlow to OpenSpec. The conversion is strictly a one-way configuration transition designed to move OpenSpec project structures into the WikiFlow format without supporting back-migration.

Related Skills

Explore More Software Engineering Skills→
josemartinrodriguezmortalonijosemartinrodriguezmortaloni

sdd-init

Initialize Spec-Driven Development directories and generate a tailored openspec/config.yaml.

Community
Intermediate
liqunxliqunx
2

wf-search

Search WikiFlow documentation repositories and return ranked summaries.

Community
Basic
liqunxliqunx
2

wf-status

List active WikiFlow plans with task progress and completion percentages.

Community
Intermediate
lewislululewislulu
645

llm-wiki

Ingest sources and compile them into a cross-linked Markdown wiki.

Community
Advanced