docx-drift-check

Detects drift between master DOCX and Markdown via SHA256 metadata comparison.

Updated Feb 17, 2026
One-click install
npx skills add https://github.com/daviddatuX25/SecureCAT-v2 --skill docx-drift-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docx-drift-check
Source: https://github.com/daviddatuX25/SecureCAT-v2/tree/main/capstone/manuscript/skills/docx-drift-check
Command: npx skills add https://github.com/daviddatuX25/SecureCAT-v2 --skill docx-drift-check

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python-docx, and includes scripts (resource) components.

What problem does it solve?

Detects drift between a master DOCX and its manuscript MD by comparing the docx-sha256 value stored in the MD's META tag with the actual DOCX SHA256.

Core Features & Use Cases

  • Drift detection: compares docx-sha256 metadata with the current DOCX SHA256 to verify alignment.
  • Pre-flight guard: prevents inconsistent updates by halting work when drift is detected or data is missing.
  • Use Case: before pushing updates to cloud storage, run the drift check to confirm both sources are in sync.

Quick Start

Run the drift check against the manuscript MD and the master DOCX to verify synchronization.

Frequently Asked Questions about docx-drift-check

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

FAQPage Schema
How do I detect drift between a master DOCX and its Markdown source?

Detect DOCX and Markdown drift by comparing the docx-sha256 value stored in the MD's META tag against the actual DOCX SHA256 hash. This verifies synchronization and flags inconsistencies before updates.

How does a pre-flight hash check prevent inconsistent manuscript updates?

A pre-flight hash check prevents inconsistent updates by halting work when drift is detected or metadata is missing. It compares the DOCX SHA256 to the MD META signature, ensuring cloud and local copies remain synchronized.

Do I need python-docx to compute DOCX SHA256 for drift detection?

Yes, you need python-docx to compute the DOCX SHA256 hash and read DOCX text for quick diff hints. This library is required to verify alignment between the master DOCX and the Markdown source.

What is the best way to verify DOCX and Markdown synchronization before pushing to cloud storage?

The best way to verify DOCX and Markdown synchronization is running a drift check before pushing updates. This pre-flight guard confirms both sources are aligned by comparing embedded META signatures to file hashes.

Can I use this drift check for manuscript pipelines with local and cloud copies?

Yes, this drift check applies directly to manuscript pipelines where cloud and local copies must remain synchronized. It detects drift between a master DOCX and its Markdown source before any updates are applied.

Why does my DOCX and MD drift check fail when metadata is missing?

Your drift check fails because the pre-flight guard halts work when data is missing. It requires the docx-sha256 value in the MD's META tag to compare against the actual DOCX SHA256 for successful synchronization verification.