Reference: refactor_okf.py

Batch refactoring script for Open Knowledge Format (OKF) frontmatter structures.

Description

The refactor_okf.py tool processes files across the repository, strips leading UTF-8 Byte Order Marks (BOM), and enforces proper ordering of YAML variables (such as placing topics immediately after description in skill schemas).

Script path

tools/refactor_okf.py

CLI signature

# Preview expected changes without executing in-place writes

uv run python tools/refactor_okf.py --dry-run

# Refactor and overwrite files with standardised compliance

uv run python tools/refactor_okf.py

Internal Python API

This script imports logic from tools/apply_okf_frontmatter.py to preserve consistency:

FRONTMATTER_RE: Pattern identifying Markdown fences.
process_file(filepath, root_dir, dry_run): Main orchestrator implementing parsing, normalisation, and atomic replacement.

Excluded directories

The tool ignores these directories to prevent unnecessary modifications:

.git
node_modules
.pytest_cache
.venv

Deep State of Mind (DSOM) For My AI Protocol | Harisfazillah Jamel (LinuxMalaysia) | 2026-08-14 Standard: UK English | DBP-standard Bahasa Melayu Malaysia (Piawai) | GNU General Public License v3.0

Reference

Explanation

Governance

Description

Script path

CLI signature

Internal Python API

Excluded directories

​Description

​Script path

​CLI signature

​Internal Python API

​Excluded directories

Description

Script path

CLI signature

Internal Python API

Excluded directories