skills.rest
edercnj
edercnjCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

x-migrate-frontmatter

Migrate Markdown frontmatter from v2 to v3.0 with a four-stage pipeline.

Updated Aug 23, 2026
Search Tags:#markdown#validation#governance#capabilities#frontmatter#migrate#ai-inference
One-click install
npx skills add https://github.com/edercnj/ia-dev-environment --skill x-migrate-frontmatter
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: x-migrate-frontmatter
Source: https://github.com/edercnj/ia-dev-environment/tree/main/src/main/resources/claude/skills/x-migrate-frontmatter
Command: npx skills add https://github.com/edercnj/ia-dev-environment --skill x-migrate-frontmatter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Migrates artifact frontmatter from v2 to v3.0, automatically adding requires-capabilities while preserving existing data and respecting governance rules.

Core Features & Use Cases

  • Four-stage frontmatter migration: path heuristic, keyword scan, AI fallback, and write/validate against the v3.0 schema.
  • AI-assisted inference when heuristics are inconclusive, with a safety warning for manual review.
  • Preserves existing fields and optional visibility/user-invocation flags; supports batch migration across files or directories.

Quick Start

Run the migration on a file or directory to update frontmatter to v3.0.

Frequently Asked Questions about x-migrate-frontmatter

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

FAQPage Schema
How do I migrate markdown frontmatter to a new schema version?▼

Migrate markdown frontmatter to v3.0 by running the Skill on individual files or directories. It processes artifacts through a four-stage pipeline, applying path heuristics, keyword scanning, and AI inference to update metadata.

What is frontmatter capability inference and when is it needed?▼

Frontmatter capability inference automatically determines required capabilities for markdown artifacts. It is triggered during v3.0 migration when path heuristics and keyword scans are inconclusive, using AI fallback to suggest metadata with a safety warning for manual review.

Can I batch migrate a directory of markdown files to v3.0 frontmatter?▼

Batch migrate markdown frontmatter across directories by running the Skill on a folder path. It processes files one by one through the migration pipeline, validates output against the governance frontmatter schema, and preserves existing visibility or user-invocation flags.

Does frontmatter migration preserve existing metadata fields?▼

Frontmatter migration preserves existing metadata fields during the v2 to v3.0 update. The pipeline validates output against governance schema rules and retains optional visibility and user-invocation flags while adding required capabilities.

What are the limitations of AI-assisted frontmatter migration?▼

AI-assisted frontmatter migration limitations include inconclusive heuristic results requiring manual review. The pipeline issues a safety warning when using AI fallback to infer capabilities, ensuring users validate automatically generated v3.0 metadata changes.

Related Skills

Explore More Software Engineering Skills→
hyperb1isshyperb1iss
5

moon

Configure and orchestrate Moon monorepo workspaces, tasks, and toolchains.

Community
Advanced
ShiienShiien
7

code-commit

Stage files, run tests, and commit with a standardized prefix and diff summary.

Community
Advanced
vladm3105vladm3105
16

doc-req

Decompose BRD, PRD, and EARS inputs into atomic REQ v3.0 documents.

Community
Advanced
Icebane84Icebane84

[skill-name]

Document AI capabilities in SKILL.md files with YAML frontmatter and instructions.

Community
Basic