| name | asm-analysis |
| description | Use when the user asks Codex to inspect, annotate, profile, or optimise
generated assembly for C/C++ or raw .s/object/binary inputs. Triggers
include "look at the asm", "inspect codegen", "why is this loop slow",
"vectorise this", "make this faster", "tune this loop", "use AVX-512",
"make this faster on Zen4/Skylake-X/Apple M2", or requests for
intrinsic-level replacements with cited latency/CPI. Do not use for
pure source-level refactoring, style changes, or C++ semantics questions
that do not require generated code. |
asm-analysis
Entrypoint for the shared simdref assembly analysis workflow.
Before doing any assembly analysis, read and follow
references/workflow.md. Treat that file as the source of truth for the
compile → objdump/-S → simdref annotate → simdref llm batch → proposal
pipeline.
Codex install and updates
Preferred (marketplace one-liner, from a Codex CLI prompt):
codex plugin marketplace add DiamonDinoia/simdref
/plugins
Pick asm-analysis and enable it.
Manual install — Codex discovers skills from .agents/skills/ (repo)
or ~/.agents/skills/ (user). See the
Codex skills docs.
git clone https://github.com/DiamonDinoia/simdref.git ~/src/simdref
mkdir -p ~/.agents/skills
ln -sf ~/src/simdref/codex-skills/asm-analysis/skills/asm-analysis \
~/.agents/skills/asm-analysis
Refresh by updating the checkout: (cd ~/src/simdref && git pull).