add files

.codex/skills/markdown-quality/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: markdown-quality
+description: Plan and review Markdown output quality for PDFtoMD. Use when Codex needs tests or policies for headings, tables, HTML fallback, image links, captions, frontmatter, chunk integrity, and deterministic output.
+---
+
+# Markdown Quality
+
+## Workflow
+
+1. Read `AGENTS.md`, `docs/PRD.md`, `docs/ARCHITECTURE.md`, and `docs/CONVERSION_POLICY.md`.
+2. Prefer focused assertions over full snapshots.
+3. Validate:
+   - heading hierarchy
+   - table parseability
+   - limited HTML table fallback
+   - image link existence
+   - figure/table captions
+   - internal references
+   - chunk frontmatter
+   - deterministic filenames and anchors
+4. Use Markdown or HTML parsers when practical.
+
+## Guardrails
+
+- Do not inject runtime warnings into generated Markdown.
+- Do not rely only on brittle whole-file snapshots.
+- Do not lose complex table content without linking a fallback asset.