Diagnose MX and cube matmul failures across shapes, layouts, and writeback.
npx skills add https://github.com/hw-native-sys/PTOAS --skill debug-matmul-mx
Please help me install this Agent Skill. Skill: debug-matmul-mx Source: https://github.com/hw-native-sys/PTOAS/tree/main/.codex/skills/debug-matmul-mx Command: npx skills add https://github.com/hw-native-sys/PTOAS --skill debug-matmul-mx
This Skill diagnoses and resolves MX and cube matmul failures caused by shape mismatches, fractal layout errors, wrapper lowering defects, scale packing issues, FP4 byte staging, writeback bugs, or simulator behavior.
Use the debug-matmul-mx skill to investigate the failing MX matmul case, synchronize its kernel, host, and golden shapes, and identify the first incorrect execution layer.
High-intent search queries and answers about installing and using this skill.
To debug incorrect A5 FP4 or FP8 matmul output, synchronize kernel, host, and golden shapes, then isolate failures layer by layer using all-ones checks and simulator log correlation to find the first incorrect execution layer.
Handwritten VPTO micro-op matmul failures often stem from physical byte-layout validation errors or wrapper lowering defects; isolate data and scale patterns independently and inspect expanded operations against simulator middle-layer logs to localize the issue.
Resolve TileLang matmul fractal layout and scale packing errors by separating logical shapes from physical layouts, inspecting the authoring IR, and validating padded packed-byte buffers and physical byte layouts against expected controls.
The best way to isolate MX matmul shape mismatches when logical and physical K dimensions differ is performing systematic shape synchronization across kernel, host, and golden arrays, followed by targeted all-ones sanity checks.
Yes, this debugging approach applies to handwritten VPTO micro-ops and TileLang or PTODSL generated cases running in both simulators and validation environments, covering MTE transfers, emitter control packing, and output writeback.
Check wrapper lowering and emission controls during cube matmul debugging when initial shape synchronization passes but computation fails, using IR inspection to compare expanded operations with final hardware controls.
cloudrift-aiRe-tune and validate GPU matmul golden configuration YAMLs via the emmy CLI.
openeuler-mirrorAnalyze iBMC, InfoCollect, and OS logs to localize physical CPU faults.
hw-native-sysRewrite AscendC or CCE kernels into PTODSL implementations preserving ABI and synchronization.
hw-native-sysVerify PTO-ISA instruction behavior and output correctness via CA model simulator tests and log analysis.
