Menu
Test harness for validating converter outputs with 284 assertions across all converter muscles
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/fabioc-aloha/ChessCoach --skill converter-qaThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Based on SOC occupation classification
Showing SKILL.md
| type | skill |
| lifecycle | stable |
| inheritance | inheritable |
| name | converter-qa |
| description | Test harness for validating converter outputs with 284 assertions across all converter muscles |
| tier | extended |
| applyTo | **/*converter*,**/*qa*,**/*test*harness* |
| muscle | null |
| currency | 2026-04-22T00:00:00.000Z |
Trust your converters -- 284 assertions prove they work
Test harness that validates all converter outputs: md-to-word regression tests, md-to-eml structure validation, shared module unit tests, file size bounds, and output format verification.
| Suite | Covers | Assertions |
|---|---|---|
| Shared module tests | All 8 shared modules (preprocessor, mermaid, config, etc.) | ~120 |
| md-to-word smoke | End-to-end Word conversion with multiple style presets | ~40 |
| md-to-word OOXML | Visual regression (XML structure, table styling) | ~30 |
| md-to-eml structure | Email HTML, CID images, frontmatter mapping | ~20 |
| markdown-lint | All 19 lint rules with positive and negative cases | ~30 |
| md-scaffold | Template generation for all 5 template types | ~15 |
| nav-inject | Navigation injection, dry-run, init | ~10 |
| CLI flag parsing | All CLI flags for md-to-word (new flags) | ~15 |
| Lua filter syntax | Pandoc Lua filter validation | ~4 |
# Run all tests
node .github/muscles/converter-qa.cjs
# Run a specific suite
node .github/muscles/converter-qa.cjs --suite=word
node .github/muscles/converter-qa.cjs --suite=shared
# Verbose output (show passing tests)
node .github/muscles/converter-qa.cjs --verbose
Tests use a minimal zero-dependency framework:
suite('My test suite', () => {
assert(condition, 'description of what is being tested');
();
});
This muscle is part of the pre-publish quality gate:
converter-qa.cjs runs all 284 assertionsTests use direct boolean assertions with descriptive messages:
suite('preprocessor', () => {
const result = preprocessMarkdown(input);
assert(result.includes('expected'), 'preprocessor should transform X to Y');
assert(!result.includes('bad'), 'preprocessor should strip bad patterns');
});
OOXML tests compare generated Word document XML structure against known-good snapshots:
.docx from a known markdown input.docx and extract document.xmlSome tests depend on external tools (Pandoc, Mermaid CLI). Use skip() when the tool is unavailable:
if (!hasPandoc()) {
skip('Pandoc Lua filter syntax (pandoc not installed)');
} else {
suite('Lua filter', () => { /* ... */ });
}
| Issue | Fix |
|---|---|
| Assertion count mismatch | New tests added — update the expected count in docs |
| OOXML regression failure | Intentional style change — regenerate snapshot |
| Pandoc tests skipped | Install Pandoc: winget install JohnMacFarlane.Pandoc |
| Mermaid render tests fail | Install @mermaid-js/mermaid-cli globally |