[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7A03A9B23YA6FCQFCTQ40RX":3,"skill-same:01M7A03A9B23YA6FCQFCTQ40RX":80},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":29,"install":30,"resources":43},"01M7A03A9B23YA6FCQFCTQ40RX","dpdk-dataplane-engineering",null,"DPDK (Data Plane Development Kit) dataplane engineering in C\u002FC++: write hot-path packet-processing code, review it for mbuf-ownership and performance bugs, size mempools\u002Fqueues\u002Fdescriptors, tune systems that miss their packets-per-second target evidence-first (counters before config changes), and answer DPDK questions (API semantics, EAL options, version porting, mempool\u002FNUMA\u002Fhugepage setup). Use whenever the user works with DPDK APIs or tools (rte_*, mbuf, mempool, lcore, EAL, PMD, testpmd, l3fwd), mentions kernel bypass or poll-mode drivers, Mpps rates, hugepages or NUMA placement for a NIC, RX\u002FTX queues, RSS, imissed\u002Frx_nombuf drops, VFIO, mlx5, ice\u002FE810 or netvsc, or asks to write, review, optimize or debug packet-forwarding, NFV, vSwitch, UPF or dataplane code, even without saying DPDK. NOT for eBPF\u002FXDP programs, kernel network-stack tuning (sysctl, irqbalance on plain servers), pcap\u002FWireshark analysis, P4\u002Fswitch ASICs, lock-free or io_uring code with no NIC, or OVS\u002FVM networking without DPDK code.","SyukPublic\u002Fai-dev-toolkit","SyukPublic","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F211482903?v=4","01M799WENGJRH924NQACAF41WB","Roman","01M7A037ZP1Z7TM9RR30JJJYN1",0,"MIT","https:\u002F\u002Fgithub.com\u002FSyukPublic\u002Fai-dev-toolkit\u002Fblob\u002Fmain\u002Fplugins\u002Fdataplane-engineering\u002Fskills\u002Fdpdk-dataplane-engineering\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: dpdk-dataplane-engineering\ndescription: \"DPDK (Data Plane Development Kit) dataplane engineering in C\u002FC++: write hot-path packet-processing code, review it for mbuf-ownership and performance bugs, size mempools\u002Fqueues\u002Fdescriptors, tune systems that miss their packets-per-second target evidence-first (counters before config changes), and answer DPDK questions (API semantics, EAL options, version porting, mempool\u002FNUMA\u002Fhugepage setup). Use whenever the user works with DPDK APIs or tools (rte_*, mbuf, mempool, lcore, EAL, PMD, testpmd, l3fwd), mentions kernel bypass or poll-mode drivers, Mpps rates, hugepages or NUMA placement for a NIC, RX\u002FTX queues, RSS, imissed\u002Frx_nombuf drops, VFIO, mlx5, ice\u002FE810 or netvsc, or asks to write, review, optimize or debug packet-forwarding, NFV, vSwitch, UPF or dataplane code, even without saying DPDK. NOT for eBPF\u002FXDP programs, kernel network-stack tuning (sysctl, irqbalance on plain servers), pcap\u002FWireshark analysis, P4\u002Fswitch ASICs, lock-free or io_uring code with no NIC, or OVS\u002FVM networking without DPDK code.\"\n---\n\n# DPDK Dataplane Engineering\n\nOperate as a senior dataplane engineer: skeptical of averages, obsessed with the per-packet\ncycle budget, and exact about who owns every mbuf. DPDK code reads like ordinary C, but the\nrules that make it correct and fast are invisible in the syntax. This skill makes them explicit\nand makes you prove them.\n\n## Core rule\n\nTreat every DPDK task as a contract over three things, and write them down before changing code:\n\n1. **Ownership** - who owns each packet buffer (mbuf) at every step, and which call transfers it.\n2. **Topology** - which lcore polls which (port, queue), on which NUMA socket, from which mempool.\n3. **Budget** - how many cycles one packet may cost on one core at the target rate, and where they go.\n\nPlus the evidence that will prove the result: a counter, a profile, a benchmark. Never \"it ran\".\n\n## First pass: classify the task, then read\n\n| Task | Read first |\n| --- | --- |\n| Write or modify per-packet (hot-path) code | [references\u002Fdatapath-code.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fdatapath-code.md) |\n| Mempool, mbuf, hugepages, NUMA, EAL memory, VFIO\u002FIOVA | [references\u002Fmemory-numa.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fmemory-numa.md) |\n| \"Too slow\", \"drops\", \"only X Mpps\", \"does not scale\": tune or debug | [references\u002Ftuning-methodology.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Ftuning-methodology.md) |\n| Review existing DPDK code | [references\u002Freview-checklist.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Freview-checklist.md), then datapath-code.md |\n| Vendor, NIC or cloud specifics (Intel ice\u002Fi40e, AMD EPYC, Arm, mlx5, Azure, virtio) | [references\u002Fplatforms-and-nics.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fplatforms-and-nics.md) |\n\nA mixed task (\"review and fix\") takes the review checklist first, then datapath-code.md before\nwriting replacement code. A \"which datapath should we use\" question (DPDK vs AF_XDP vs the\nkernel stack) is in scope: answer it from the cost model below, and say plainly when DPDK is\nthe wrong tool (connection-heavy workloads that need kernel TCP, no dedicated cores, no\nownership of hugepages and NIC binding).\n\n### Facts to establish first\n\nAsk only when the answer changes the work; otherwise state the assumption and proceed.\n\n- **DPDK version.** API churn is real (see \"Version notes\"). Default: the current LTS.\n- **NIC \u002F PMD, link speed, packet size.** These set the budget (see \"Numbers\").\n- **Machine shape.** Sockets, which socket the NIC sits on, isolated cores, hugepages per node.\n- **Deployment.** Bare metal, VM with SR-IOV, cloud (Azure, AWS), container. Virtualised paths\n  have their own ceilings and their own failure modes (VF revocation, steal time).\n- **Target.** Mpps at a packet size, p99 latency, drop-free at rate X, CPU budget. \"Fast\" is\n  not a target; without one, every tuning step is unfalsifiable.\n\n## Bundled scripts\n\nDeterministic helpers: run them instead of re-deriving by hand, and treat their output as\ncandidates to inspect, not verdicts.\n\n- `python ${CLAUDE_SKILL_DIR}\u002Fscripts\u002Fdpdk_static_scan.py \u003Cpath>`: heuristic scan of C\u002FC++\n  sources for hot-path anti-patterns, ownership hazards and deprecated APIs. Run it first in\n  every review; then read the code around each hit.\n- `python ${CLAUDE_SKILL_DIR}\u002Fscripts\u002Fdpdk_budget.py budget|mempool|descriptors ...`: cycles per\n  packet at a given link speed and packet size, mempool demand from the port\u002Fqueue\u002Flcore shape\n  (`--n` checks an existing pool against it), RX descriptor depth from the bandwidth-delay model.\n  Quote its output in the answer.\n- `sh ${CLAUDE_SKILL_DIR}\u002Fscripts\u002Fdpdk_env_probe.sh`: read-only Linux host probe (hugepages per\n  node, NIC NUMA node and driver binding, kernel-cmdline isolation, IOMMU, governor, DPDK\n  version). Nothing is modified.\n\n## The hot-path contract\n\nWhy the rules exist: at 10 GbE line rate with 64-byte frames one core sees 14.88 Mpps, a\nbudget of about 67 ns (roughly 200 cycles at 3 GHz) per packet. At 100 GbE it is 6.7 ns. One\nLLC miss costs 30-40 ns, one DRAM access 60-100 ns, a syscall hundreds of ns, a contended\ncache line worse. A single careless line in the loop halves throughput. Hence, on the\nper-packet path:\n\n1. **No syscalls, no heap allocation, no printf\u002Flogging.** Counters are per-lcore; a control\n   thread reads and prints them.\n2. **Batch everything.** RX\u002FTX bursts of 32-64, mempool get\u002Fput in bulk, ring enqueue\u002Fdequeue\n   in bulk. Per-call overhead is amortised across the burst, and vector PMD paths only engage\n   on bursts. Shrinking a burst is a latency decision; make it on purpose and measure it.\n3. **Per-lcore everything.** Each worker owns its queues, counters, caches and state. Writable\n   state shared between lcores is a design smell.\n4. **No locks on the datapath.** Cross-core handoff goes through `rte_ring`; read-mostly tables\n   use RCU (`rte_rcu_qsbr`) or an atomically swapped pointer, never a rwlock. A counter that\n   must be shared needs only a relaxed atomic.\n5. **Stay NUMA-local.** Mempools, rings and queues on the socket of the NIC and of the lcore\n   that uses them. Cross-socket access adds 50-100% latency and saturates the interconnect\n   before the NIC saturates.\n6. **Keep the code predictable.** `likely`\u002F`unlikely` on exception paths, no integer division\n   or modulo by a variable (power-of-two masks), no floating point, prefetch the next packets'\n   data while processing the current ones, cold paths out of line.\n7. **Respect mbuf ownership.** `rte_eth_tx_burst()` takes ownership only of the packets it\n   reports sent; the remainder is still yours: free it or retry it. After a successful TX or\n   ring enqueue the mbuf is gone; touching it is a use-after-free with delayed symptoms.\n\n## Anti-patterns to flag on sight\n\n| Anti-pattern | Why it hurts | Fix |\n| --- | --- | --- |\n| `rte_eth_rx_burst(..., 1)` or a burst that is not a multiple of 8 | No amortisation; vector RX paths stay off | Burst 32-64 into an array |\n| Per-packet `rte_pktmbuf_alloc` + `memcpy` \"for safety\" | Allocation plus a full copy per packet; RX already gave you exclusive ownership | Forward the RX mbuf itself; clone or copy only when the packet really goes two places |\n| Lock or `fetch_add` on shared stats in the loop | Cache-line ping-pong serialises every core | Per-lcore counters, aggregated off the hot path |\n| Adjacent per-core counters in one array | False sharing costs as much as a lock | One `__rte_cache_aligned` struct per lcore, plus `RTE_CACHE_GUARD` |\n| Mempool `cache_size = 0` | Every alloc\u002Ffree hits the shared ring with a CAS | Cache 256-512 (sizing rules in memory-numa.md) |\n| Hardcoded `socket_id = 0`, or `SOCKET_ID_ANY` on a 2-socket box | Remote-socket mbufs and descriptors for every core on the other socket | `rte_eth_dev_socket_id(port)` \u002F `rte_lcore_to_socket_id()`, one pool per socket |\n| `rte_eth_tx_burst` return value ignored | Every unsent mbuf leaks, and `rx_nombuf` climbs under load only | Free or retry `pkts[sent..n-1]` |\n| `%` or `\u002F` by a variable in the loop | 20-90 cycles per integer division | Power-of-two sizes and `& (n - 1)` |\n| printf \u002F RTE_LOG per packet or \"every N packets\" | Syscall and formatting inside the budget | Counters plus a reporting thread |\n| `while (!stop)` on a plain `int` | Compiler may hoist the load; also a data race | C11 atomic flag, relaxed load |\n| `usleep` \u002F `sched_yield` \"to save CPU\" in the poll loop | Latency spikes, cold caches, missed bursts | PMD power management (`rte_power_ethdev_pmgmt_queue_enable`) or interrupt mode |\n| A poll-mode core showing less than ~100% CPU in `top` | A busy-polling lcore spins whatever the load; anything lower means the thread floats, something in the loop blocks, or the hypervisor preempts it | Treat it as a finding: pin the thread, remove the blocking call, measure poll gaps with `rte_rdtsc()` |\n| Mempool sized by a magic number (`8192`) | Descriptors alone pin `ports x rxq x rxd + ports x txq x txd` mbufs; a pool that only covers them is empty before the first packet | `n >= descriptors + lcores x burst x stages + lcores x cache_size`, plus headroom |\n| Two lcores polling one RX queue, or queue id derived from `rte_lcore_id()` | Queues are not thread-safe; lcore ids are not dense | Explicit (port, queue) per worker, assigned at init |\n| More RX queues than polling lcores (two or more per core) | Each extra queue halves the burst the others fill and adds a fixed poll cost per iteration; descriptor and mbuf demand double | One RX queue per polling lcore; add lcores, not queues, unless NIC-side counters prove the RX path is the limit |\n| Hardcoded offload mask | Silently drops the driver to the scalar path, or fails on another PMD | Intersect with `rte_eth_dev_info_get()` capabilities |\n| Legacy API: `rte_atomicNN_*`, KNI, master\u002Fslave lcore names, `rte_eth_stats.q_ipackets`, `-c` coremask | Deprecated or removed; breaks on upgrade | C11 atomics, virtio-user\u002Ftap, main\u002Fworker, xstats, `-l`\u002F`--lcores` |\n\n## Verification gates\n\nName each gate before claiming a task is done. A gate you cannot name is a finding.\n\n1. **Ownership gate.** Every mbuf from `rx_burst` ends in exactly one of: `tx_burst` (counted\n   as sent), a successful ring enqueue, or `rte_pktmbuf_free`, on every path including errors.\n   The unsent remainder of every burst is handled. Nothing is touched after handoff. Clones\n   are never written through.\n2. **Topology gate.** A (port, queue) -> lcore -> socket -> mempool table exists. One RX queue\n   per polling lcore is the default; more queues per lcore only when NIC-side counters show\n   the RX path, not the core, is the limit. No queue is polled by two lcores. RSS spreads the\n   real flow mix (verified per queue, not assumed). NIC, lcores, hugepages and pools share a\n   socket.\n3. **Budget gate.** Cycles per packet at the target rate are stated. The loop passes the\n   anti-pattern table. Burst, cache, pool and descriptor sizes come with the formula that\n   produced them, not magic numbers: a pool covers every descriptor on every queue that uses\n   it plus in-flight bursts and per-lcore caches (`8 queues x 512 descriptors` is already\n   `4096` before a single packet is in flight), and descriptor depth is the packet rate times\n   the longest service gap divided by the queues.\n4. **Evidence gate.** Every \"slow\" diagnosis names the counter or profile that proves it\n   (`imissed` vs `rx_nombuf` vs `ierrors` vs NIC-side discards; perf\u002FPMU). Every\n   recommendation names the measurement that will confirm it. A tuning plan puts measurement\n   before any configuration change: read the counters, then run a testpmd (or l3fwd) baseline\n   on the same cores and queues; if the baseline also misses the target the limit is the\n   platform, otherwise it is the application. \"Try hugepages\" without evidence is cargo cult.\n5. **Lifecycle gate.** `rte_eal_init` return checked and argc\u002Fargv shifted; descriptor counts\n   adjusted to device limits; offloads intersected with capabilities; link waited for;\n   signal -> atomic flag -> workers exit -> `rte_eth_dev_stop`\u002F`close` -> `rte_eal_cleanup`;\n   device removal and reset events handled wherever a VF can be revoked (cloud, SR-IOV).\n\nDo not claim correctness from a passing run, and do not claim a speedup without a before\u002Fafter\nmeasurement on the same traffic.\n\n## Numbers to reason with\n\n- Line rate at 64 B (frame + 20 B preamble\u002FIFG): 10G = 14.88 Mpps (67 ns\u002Fpkt), 25G = 37.2 Mpps,\n  40G = 59.5 Mpps, 100G = 148.8 Mpps (6.7 ns), 200G = 297.6 Mpps, 400G = 595 Mpps.\n- Memory: L1 ~1 ns, L2 ~3-5 ns, LLC ~10-20 ns, DRAM 60-100 ns, remote socket +50-100%. A cache\n  line bouncing between cores costs on the order of 100 ns per bounce.\n- An MMIO doorbell write is ~40 ns (measured on Arm Neoverse V2); at 148 Mpps that is 5-6\n  packets of arrival time. Bursts and free thresholds exist to amortise it.\n- A well-written forwarding core does 10-30+ Mpps bare metal at 64 B; vendor l3fwd numbers go\n  far beyond with more cores and queues. 1-2 Mpps per core is almost always an anti-pattern or\n  a misconfiguration, not \"DPDK overhead\". Virtio inside a VM: single-digit Mpps per core is\n  normal.\n- Descriptor depth is a bandwidth-delay product: descriptors ~= packet rate x worst-case\n  service gap \u002F cores. A 1 ms scheduler preemption at 10 Mpps is 10 000 packets, more than a\n  4096-entry ring absorbs; that is what core isolation is for.\n\n## Version notes (verified October 2026; re-check when the user pins a version)\n\n- Releases: 25.11 is the current LTS (25.11.4), 26.07 the latest, 26.11 due November 2026.\n- Build: meson + ninja only since 20.11; apps link with `pkg-config --cflags --libs libdpdk`.\n  Makefile-era examples are obsolete.\n- EAL: `-l`\u002F`--lcores` and `-S` replace the deprecated `-c`\u002F`-s` coremasks (deprecated 25.11).\n  `--numa-mem`\u002F`--numa-limit` are the documented names (`--socket-mem`\u002F`--socket-limit` still\n  parse as aliases). Gone from the option table: `-w` (use `-a`\u002F`--allow`, `-b`\u002F`--block`) and\n  `--master-lcore` (use `--main-lcore`). `--remap-lcore-ids` (25.11) gives contiguous lcore ids.\n- Lcore naming is main\u002Fworker since 20.11: `rte_get_main_lcore`, `RTE_LCORE_FOREACH_WORKER`.\n- Removed: KNI (23.11; use virtio-user or tap), the queue-stats fields `q_ipackets`,\n  `q_opackets`, `q_errors` of `struct rte_eth_stats` (25.11; read xstats `rx_qN_packets`\n  instead), the `enable_kmods` build option (25.11; igb_uio lives in the separate dpdk-kmods\n  repository).\n- Deprecated: `rte_atomicNN_*` legacy atomics (use C11 `\u003Cstdatomic.h>` or DPDK's\n  `rte_atomic_*_explicit` wrappers from `rte_stdatomic.h`), VXLAN-GPE flow items, the legacy\n  flow director API (removal targeted for 26.11).\n- Newer tools worth using: lcore variables `RTE_LCORE_VAR_*` for per-lcore state (24.11,\n  experimental), `RTE_CACHE_GUARD` against prefetcher-induced false sharing, the mbuf history\n  debug field (25.11), `rte_pmu_read()` for in-process PMU counters.\n- Mempool cache semantics changed in 26.07: the effective cache size now equals the requested\n  size (it used to be 1.5x), and lcores that only put or only get should double their cache.\n  Up to 25.11 the API documented `cache_size \u003C= n \u002F 1.5` and advised `n % cache_size == 0`;\n  26.07 requires only `cache_size \u003C= n`. `RTE_MEMPOOL_CACHE_MAX_SIZE` is 512 in both.\n\n## Output standard\n\nLead with the finding that explains the user's symptom (for new code: with the topology and\nownership model). Then state assumptions (version, NIC, machine), the code or plan, the\nevidence behind each claim (counter, profile, formula), the commands to run, and the residual\nrisks (platform, driver, untested paths). Reviews group findings as **Bugs** (will misbehave),\n**Performance** (cycles left on the table, with the order of magnitude) and **Hygiene**\n(portability, deprecations), each with file:line, consequence and fix.\n\nThe bundled scripts are your instruments, not the user's: quote the numbers and formulas they\nproduce, and give the user commands that run on the target host (testpmd, `rte_eth_stats`,\n`perf`, sysfs). A deliverable meant for other people does not mention the scripts by path.\n\n## Canonical sources\n\n- DPDK Programmer's Guide, \"Writing Efficient Code\":\n  https:\u002F\u002Fdoc.dpdk.org\u002Fguides\u002Fprog_guide\u002Fwriting_efficient_code.html\n- DPDK Programmer's Guide: Profile Your Application; Mempool, Mbuf, Ring, RCU, EAL and Ethernet\n  Device chapters: https:\u002F\u002Fdoc.dpdk.org\u002Fguides\u002Fprog_guide\u002F\n- DPDK Linux Getting Started Guide: System Requirements, Linux Drivers, \"How to get best\n  performance with NICs on Intel platforms\", \"How to get best performance on AMD platform\".\n- Intel, \"DPDK Performance Optimization Guidelines\" white paper: the profile -> classify\n  (memory-, I\u002FO- or CPU-bound) -> fix -> re-profile loop and the platform checklist.\n- Arm, \"DPDK Tuning Guide\" (109701) and \"DPDK scalability analysis on Neoverse V2\" (the\n  descriptor bandwidth-delay model).\n- AMD, EPYC DPDK tuning guides (58017 for 9004, 58468 for 9005).\n- Microsoft, \"Set up DPDK in a Linux virtual machine\" (Azure netvsc PMD); the DPDK netvsc, mlx5\n  and ice PMD guides.\n","# DPDK Dataplane Engineering\n\nOperate as a senior dataplane engineer: skeptical of averages, obsessed with the per-packet\ncycle budget, and exact about who owns every mbuf. DPDK code reads like ordinary C, but the\nrules that make it correct and fast are invisible in the syntax. This skill makes them explicit\nand makes you prove them.\n\n## Core rule\n\nTreat every DPDK task as a contract over three things, and write them down before changing code:\n\n1. **Ownership** - who owns each packet buffer (mbuf) at every step, and which call transfers it.\n2. **Topology** - which lcore polls which (port, queue), on which NUMA socket, from which mempool.\n3. **Budget** - how many cycles one packet may cost on one core at the target rate, and where they go.\n\nPlus the evidence that will prove the result: a counter, a profile, a benchmark. Never \"it ran\".\n\n## First pass: classify the task, then read\n\n| Task | Read first |\n| --- | --- |\n| Write or modify per-packet (hot-path) code | [references\u002Fdatapath-code.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fdatapath-code.md) |\n| Mempool, mbuf, hugepages, NUMA, EAL memory, VFIO\u002FIOVA | [references\u002Fmemory-numa.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fmemory-numa.md) |\n| \"Too slow\", \"drops\", \"only X Mpps\", \"does not scale\": tune or debug | [references\u002Ftuning-methodology.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Ftuning-methodology.md) |\n| Review existing DPDK code | [references\u002Freview-checklist.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Freview-checklist.md), then datapath-code.md |\n| Vendor, NIC or cloud specifics (Intel ice\u002Fi40e, AMD EPYC, Arm, mlx5, Azure, virtio) | [references\u002Fplatforms-and-nics.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fplatforms-and-nics.md) |\n\nA mixed task (\"review and fix\") takes the review checklist first, then datapath-code.md before\nwriting replacement code. A \"which datapath should we use\" question (DPDK vs AF_XDP vs the\nkernel stack) is in scope: answer it from the cost model below, and say plainly when DPDK is\nthe wrong tool (connection-heavy workloads that need kernel TCP, no dedicated cores, no\nownership of hugepages and NIC binding).\n\n### Facts to establish first\n\nAsk only when the answer changes the work; otherwise state the assumption and proceed.\n\n- **DPDK version.** API churn is real (see \"Version notes\"). Default: the current LTS.\n- **NIC \u002F PMD, link speed, packet size.** These set the budget (see \"Numbers\").\n- **Machine shape.** Sockets, which socket the NIC sits on, isolated cores, hugepages per node.\n- **Deployment.** Bare metal, VM with SR-IOV, cloud (Azure, AWS), container. Virtualised paths\n  have their own ceilings and their own failure modes (VF revocation, steal time).\n- **Target.** Mpps at a packet size, p99 latency, drop-free at rate X, CPU budget. \"Fast\" is\n  not a target; without one, every tuning step is unfalsifiable.\n\n## Bundled scripts\n\nDeterministic helpers: run them instead of re-deriving by hand, and treat their output as\ncandidates to inspect, not verdicts.\n\n- `python ${CLAUDE_SKILL_DIR}\u002Fscripts\u002Fdpdk_static_scan.py \u003Cpath>`: heuristic scan of C\u002FC++\n  sources for hot-path anti-patterns, ownership hazards and deprecated APIs. Run it first in\n  every review; then read the code around each hit.\n- `python ${CLAUDE_SKILL_DIR}\u002Fscripts\u002Fdpdk_budget.py budget|mempool|descriptors ...`: cycles per\n  packet at a given link speed and packet size, mempool demand from the port\u002Fqueue\u002Flcore shape\n  (`--n` checks an existing pool against it), RX descriptor depth from the bandwidth-delay model.\n  Quote its output in the answer.\n- `sh ${CLAUDE_SKILL_DIR}\u002Fscripts\u002Fdpdk_env_probe.sh`: read-only Linux host probe (hugepages per\n  node, NIC NUMA node and driver binding, kernel-cmdline isolation, IOMMU, governor, DPDK\n  version). Nothing is modified.\n\n## The hot-path contract\n\nWhy the rules exist: at 10 GbE line rate with 64-byte frames one core sees 14.88 Mpps, a\nbudget of about 67 ns (roughly 200 cycles at 3 GHz) per packet. At 100 GbE it is 6.7 ns. One\nLLC miss costs 30-40 ns, one DRAM access 60-100 ns, a syscall hundreds of ns, a contended\ncache line worse. A single careless line in the loop halves throughput. Hence, on the\nper-packet path:\n\n1. **No syscalls, no heap allocation, no printf\u002Flogging.** Counters are per-lcore; a control\n   thread reads and prints them.\n2. **Batch everything.** RX\u002FTX bursts of 32-64, mempool get\u002Fput in bulk, ring enqueue\u002Fdequeue\n   in bulk. Per-call overhead is amortised across the burst, and vector PMD paths only engage\n   on bursts. Shrinking a burst is a latency decision; make it on purpose and measure it.\n3. **Per-lcore everything.** Each worker owns its queues, counters, caches and state. Writable\n   state shared between lcores is a design smell.\n4. **No locks on the datapath.** Cross-core handoff goes through `rte_ring`; read-mostly tables\n   use RCU (`rte_rcu_qsbr`) or an atomically swapped pointer, never a rwlock. A counter that\n   must be shared needs only a relaxed atomic.\n5. **Stay NUMA-local.** Mempools, rings and queues on the socket of the NIC and of the lcore\n   that uses them. Cross-socket access adds 50-100% latency and saturates the interconnect\n   before the NIC saturates.\n6. **Keep the code predictable.** `likely`\u002F`unlikely` on exception paths, no integer division\n   or modulo by a variable (power-of-two masks), no floating point, prefetch the next packets'\n   data while processing the current ones, cold paths out of line.\n7. **Respect mbuf ownership.** `rte_eth_tx_burst()` takes ownership only of the packets it\n   reports sent; the remainder is still yours: free it or retry it. After a successful TX or\n   ring enqueue the mbuf is gone; touching it is a use-after-free with delayed symptoms.\n\n## Anti-patterns to flag on sight\n\n| Anti-pattern | Why it hurts | Fix |\n| --- | --- | --- |\n| `rte_eth_rx_burst(..., 1)` or a burst that is not a multiple of 8 | No amortisation; vector RX paths stay off | Burst 32-64 into an array |\n| Per-packet `rte_pktmbuf_alloc` + `memcpy` \"for safety\" | Allocation plus a full copy per packet; RX already gave you exclusive ownership | Forward the RX mbuf itself; clone or copy only when the packet really goes two places |\n| Lock or `fetch_add` on shared stats in the loop | Cache-line ping-pong serialises every core | Per-lcore counters, aggregated off the hot path |\n| Adjacent per-core counters in one array | False sharing costs as much as a lock | One `__rte_cache_aligned` struct per lcore, plus `RTE_CACHE_GUARD` |\n| Mempool `cache_size = 0` | Every alloc\u002Ffree hits the shared ring with a CAS | Cache 256-512 (sizing rules in memory-numa.md) |\n| Hardcoded `socket_id = 0`, or `SOCKET_ID_ANY` on a 2-socket box | Remote-socket mbufs and descriptors for every core on the other socket | `rte_eth_dev_socket_id(port)` \u002F `rte_lcore_to_socket_id()`, one pool per socket |\n| `rte_eth_tx_burst` return value ignored | Every unsent mbuf leaks, and `rx_nombuf` climbs under load only | Free or retry `pkts[sent..n-1]` |\n| `%` or `\u002F` by a variable in the loop | 20-90 cycles per integer division | Power-of-two sizes and `& (n - 1)` |\n| printf \u002F RTE_LOG per packet or \"every N packets\" | Syscall and formatting inside the budget | Counters plus a reporting thread |\n| `while (!stop)` on a plain `int` | Compiler may hoist the load; also a data race | C11 atomic flag, relaxed load |\n| `usleep` \u002F `sched_yield` \"to save CPU\" in the poll loop | Latency spikes, cold caches, missed bursts | PMD power management (`rte_power_ethdev_pmgmt_queue_enable`) or interrupt mode |\n| A poll-mode core showing less than ~100% CPU in `top` | A busy-polling lcore spins whatever the load; anything lower means the thread floats, something in the loop blocks, or the hypervisor preempts it | Treat it as a finding: pin the thread, remove the blocking call, measure poll gaps with `rte_rdtsc()` |\n| Mempool sized by a magic number (`8192`) | Descriptors alone pin `ports x rxq x rxd + ports x txq x txd` mbufs; a pool that only covers them is empty before the first packet | `n >= descriptors + lcores x burst x stages + lcores x cache_size`, plus headroom |\n| Two lcores polling one RX queue, or queue id derived from `rte_lcore_id()` | Queues are not thread-safe; lcore ids are not dense | Explicit (port, queue) per worker, assigned at init |\n| More RX queues than polling lcores (two or more per core) | Each extra queue halves the burst the others fill and adds a fixed poll cost per iteration; descriptor and mbuf demand double | One RX queue per polling lcore; add lcores, not queues, unless NIC-side counters prove the RX path is the limit |\n| Hardcoded offload mask | Silently drops the driver to the scalar path, or fails on another PMD | Intersect with `rte_eth_dev_info_get()` capabilities |\n| Legacy API: `rte_atomicNN_*`, KNI, master\u002Fslave lcore names, `rte_eth_stats.q_ipackets`, `-c` coremask | Deprecated or removed; breaks on upgrade | C11 atomics, virtio-user\u002Ftap, main\u002Fworker, xstats, `-l`\u002F`--lcores` |\n\n## Verification gates\n\nName each gate before claiming a task is done. A gate you cannot name is a finding.\n\n1. **Ownership gate.** Every mbuf from `rx_burst` ends in exactly one of: `tx_burst` (counted\n   as sent), a successful ring enqueue, or `rte_pktmbuf_free`, on every path including errors.\n   The unsent remainder of every burst is handled. Nothing is touched after handoff. Clones\n   are never written through.\n2. **Topology gate.** A (port, queue) -> lcore -> socket -> mempool table exists. One RX queue\n   per polling lcore is the default; more queues per lcore only when NIC-side counters show\n   the RX path, not the core, is the limit. No queue is polled by two lcores. RSS spreads the\n   real flow mix (verified per queue, not assumed). NIC, lcores, hugepages and pools share a\n   socket.\n3. **Budget gate.** Cycles per packet at the target rate are stated. The loop passes the\n   anti-pattern table. Burst, cache, pool and descriptor sizes come with the formula that\n   produced them, not magic numbers: a pool covers every descriptor on every queue that uses\n   it plus in-flight bursts and per-lcore caches (`8 queues x 512 descriptors` is already\n   `4096` before a single packet is in flight), and descriptor depth is the packet rate times\n   the longest service gap divided by the queues.\n4. **Evidence gate.** Every \"slow\" diagnosis names the counter or profile that proves it\n   (`imissed` vs `rx_nombuf` vs `ierrors` vs NIC-side discards; perf\u002FPMU). Every\n   recommendation names the measurement that will confirm it. A tuning plan puts measurement\n   before any configuration change: read the counters, then run a testpmd (or l3fwd) baseline\n   on the same cores and queues; if the baseline also misses the target the limit is the\n   platform, otherwise it is the application. \"Try hugepages\" without evidence is cargo cult.\n5. **Lifecycle gate.** `rte_eal_init` return checked and argc\u002Fargv shifted; descriptor counts\n   adjusted to device limits; offloads intersected with capabilities; link waited for;\n   signal -> atomic flag -> workers exit -> `rte_eth_dev_stop`\u002F`close` -> `rte_eal_cleanup`;\n   device removal and reset events handled wherever a VF can be revoked (cloud, SR-IOV).\n\nDo not claim correctness from a passing run, and do not claim a speedup without a before\u002Fafter\nmeasurement on the same traffic.\n\n## Numbers to reason with\n\n- Line rate at 64 B (frame + 20 B preamble\u002FIFG): 10G = 14.88 Mpps (67 ns\u002Fpkt), 25G = 37.2 Mpps,\n  40G = 59.5 Mpps, 100G = 148.8 Mpps (6.7 ns), 200G = 297.6 Mpps, 400G = 595 Mpps.\n- Memory: L1 ~1 ns, L2 ~3-5 ns, LLC ~10-20 ns, DRAM 60-100 ns, remote socket +50-100%. A cache\n  line bouncing between cores costs on the order of 100 ns per bounce.\n- An MMIO doorbell write is ~40 ns (measured on Arm Neoverse V2); at 148 Mpps that is 5-6\n  packets of arrival time. Bursts and free thresholds exist to amortise it.\n- A well-written forwarding core does 10-30+ Mpps bare metal at 64 B; vendor l3fwd numbers go\n  far beyond with more cores and queues. 1-2 Mpps per core is almost always an anti-pattern or\n  a misconfiguration, not \"DPDK overhead\". Virtio inside a VM: single-digit Mpps per core is\n  normal.\n- Descriptor depth is a bandwidth-delay product: descriptors ~= packet rate x worst-case\n  service gap \u002F cores. A 1 ms scheduler preemption at 10 Mpps is 10 000 packets, more than a\n  4096-entry ring absorbs; that is what core isolation is for.\n\n## Version notes (verified October 2026; re-check when the user pins a version)\n\n- Releases: 25.11 is the current LTS (25.11.4), 26.07 the latest, 26.11 due November 2026.\n- Build: meson + ninja only since 20.11; apps link with `pkg-config --cflags --libs libdpdk`.\n  Makefile-era examples are obsolete.\n- EAL: `-l`\u002F`--lcores` and `-S` replace the deprecated `-c`\u002F`-s` coremasks (deprecated 25.11).\n  `--numa-mem`\u002F`--numa-limit` are the documented names (`--socket-mem`\u002F`--socket-limit` still\n  parse as aliases). Gone from the option table: `-w` (use `-a`\u002F`--allow`, `-b`\u002F`--block`) and\n  `--master-lcore` (use `--main-lcore`). `--remap-lcore-ids` (25.11) gives contiguous lcore ids.\n- Lcore naming is main\u002Fworker since 20.11: `rte_get_main_lcore`, `RTE_LCORE_FOREACH_WORKER`.\n- Removed: KNI (23.11; use virtio-user or tap), the queue-stats fields `q_ipackets`,\n  `q_opackets`, `q_errors` of `struct rte_eth_stats` (25.11; read xstats `rx_qN_packets`\n  instead), the `enable_kmods` build option (25.11; igb_uio lives in the separate dpdk-kmods\n  repository).\n- Deprecated: `rte_atomicNN_*` legacy atomics (use C11 `\u003Cstdatomic.h>` or DPDK's\n  `rte_atomic_*_explicit` wrappers from `rte_stdatomic.h`), VXLAN-GPE flow items, the legacy\n  flow director API (removal targeted for 26.11).\n- Newer tools worth using: lcore variables `RTE_LCORE_VAR_*` for per-lcore state (24.11,\n  experimental), `RTE_CACHE_GUARD` against prefetcher-induced false sharing, the mbuf history\n  debug field (25.11), `rte_pmu_read()` for in-process PMU counters.\n- Mempool cache semantics changed in 26.07: the effective cache size now equals the requested\n  size (it used to be 1.5x), and lcores that only put or only get should double their cache.\n  Up to 25.11 the API documented `cache_size \u003C= n \u002F 1.5` and advised `n % cache_size == 0`;\n  26.07 requires only `cache_size \u003C= n`. `RTE_MEMPOOL_CACHE_MAX_SIZE` is 512 in both.\n\n## Output standard\n\nLead with the finding that explains the user's symptom (for new code: with the topology and\nownership model). Then state assumptions (version, NIC, machine), the code or plan, the\nevidence behind each claim (counter, profile, formula), the commands to run, and the residual\nrisks (platform, driver, untested paths). Reviews group findings as **Bugs** (will misbehave),\n**Performance** (cycles left on the table, with the order of magnitude) and **Hygiene**\n(portability, deprecations), each with file:line, consequence and fix.\n\nThe bundled scripts are your instruments, not the user's: quote the numbers and formulas they\nproduce, and give the user commands that run on the target host (testpmd, `rte_eth_stats`,\n`perf`, sysfs). A deliverable meant for other people does not mention the scripts by path.\n\n## Canonical sources\n\n- DPDK Programmer's Guide, \"Writing Efficient Code\":\n  https:\u002F\u002Fdoc.dpdk.org\u002Fguides\u002Fprog_guide\u002Fwriting_efficient_code.html\n- DPDK Programmer's Guide: Profile Your Application; Mempool, Mbuf, Ring, RCU, EAL and Ethernet\n  Device chapters: https:\u002F\u002Fdoc.dpdk.org\u002Fguides\u002Fprog_guide\u002F\n- DPDK Linux Getting Started Guide: System Requirements, Linux Drivers, \"How to get best\n  performance with NICs on Intel platforms\", \"How to get best performance on AMD platform\".\n- Intel, \"DPDK Performance Optimization Guidelines\" white paper: the profile -> classify\n  (memory-, I\u002FO- or CPU-bound) -> fix -> re-profile loop and the platform checklist.\n- Arm, \"DPDK Tuning Guide\" (109701) and \"DPDK scalability analysis on Neoverse V2\" (the\n  descriptor bandwidth-delay model).\n- AMD, EPYC DPDK tuning guides (58017 for 9004, 58468 for 9005).\n- Microsoft, \"Set up DPDK in a Linux virtual machine\" (Azure netvsc PMD); the DPDK netvsc, mlx5\n  and ice PMD guides.\n",{"name":5,"description":7},"main","ea14fd47c2127bf21f1edd83a9ffb39040f322f2","plugins\u002Fdataplane-engineering\u002Fskills\u002Fdpdk-dataplane-engineering","https:\u002F\u002Fgithub.com\u002FSyukPublic\u002Fai-dev-toolkit","https:\u002F\u002Fgithub.com\u002FSyukPublic","2026-10-22 11:45:11",{"source":8,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add SyukPublic\u002Fai-dev-toolkit --skill dpdk-dataplane-engineering",{"tool":36,"command":37},"bunx","bunx skills add SyukPublic\u002Fai-dev-toolkit --skill dpdk-dataplane-engineering",{"tool":39,"command":40},"pnpm","pnpm dlx skills add SyukPublic\u002Fai-dev-toolkit --skill dpdk-dataplane-engineering","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FSyukPublic\u002Fai-dev-toolkit\u002Fblob\u002Fmain\u002Fplugins\u002Fdataplane-engineering\u002Fskills\u002Fdpdk-dataplane-engineering\u002FSKILL.md",true,[44,50,54,58,62,66,72,76],{"path":45,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":48,"sourceHtmlUrl":49},"references\u002Fdatapath-code.md","REFERENCE","参考文档",18837,"https:\u002F\u002Fgithub.com\u002FSyukPublic\u002Fai-dev-toolkit\u002Fblob\u002Fmain\u002Fplugins\u002Fdataplane-engineering\u002Fskills\u002Fdpdk-dataplane-engineering\u002Freferences\u002Fdatapath-code.md",{"path":51,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":52,"sourceHtmlUrl":53},"references\u002Fmemory-numa.md",10941,"https:\u002F\u002Fgithub.com\u002FSyukPublic\u002Fai-dev-toolkit\u002Fblob\u002Fmain\u002Fplugins\u002Fdataplane-engineering\u002Fskills\u002Fdpdk-dataplane-engineering\u002Freferences\u002Fmemory-numa.md",{"path":55,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":56,"sourceHtmlUrl":57},"references\u002Fplatforms-and-nics.md",11649,"https:\u002F\u002Fgithub.com\u002FSyukPublic\u002Fai-dev-toolkit\u002Fblob\u002Fmain\u002Fplugins\u002Fdataplane-engineering\u002Fskills\u002Fdpdk-dataplane-engineering\u002Freferences\u002Fplatforms-and-nics.md",{"path":59,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":60,"sourceHtmlUrl":61},"references\u002Freview-checklist.md",6389,"https:\u002F\u002Fgithub.com\u002FSyukPublic\u002Fai-dev-toolkit\u002Fblob\u002Fmain\u002Fplugins\u002Fdataplane-engineering\u002Fskills\u002Fdpdk-dataplane-engineering\u002Freferences\u002Freview-checklist.md",{"path":63,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":64,"sourceHtmlUrl":65},"references\u002Ftuning-methodology.md",13392,"https:\u002F\u002Fgithub.com\u002FSyukPublic\u002Fai-dev-toolkit\u002Fblob\u002Fmain\u002Fplugins\u002Fdataplane-engineering\u002Fskills\u002Fdpdk-dataplane-engineering\u002Freferences\u002Ftuning-methodology.md",{"path":67,"resourceType":68,"resourceTypeDesc":69,"sizeBytes":70,"sourceHtmlUrl":71},"scripts\u002Fdpdk_budget.py","SCRIPT","脚本",15436,"https:\u002F\u002Fgithub.com\u002FSyukPublic\u002Fai-dev-toolkit\u002Fblob\u002Fmain\u002Fplugins\u002Fdataplane-engineering\u002Fskills\u002Fdpdk-dataplane-engineering\u002Fscripts\u002Fdpdk_budget.py",{"path":73,"resourceType":68,"resourceTypeDesc":69,"sizeBytes":74,"sourceHtmlUrl":75},"scripts\u002Fdpdk_env_probe.sh",7326,"https:\u002F\u002Fgithub.com\u002FSyukPublic\u002Fai-dev-toolkit\u002Fblob\u002Fmain\u002Fplugins\u002Fdataplane-engineering\u002Fskills\u002Fdpdk-dataplane-engineering\u002Fscripts\u002Fdpdk_env_probe.sh",{"path":77,"resourceType":68,"resourceTypeDesc":69,"sizeBytes":78,"sourceHtmlUrl":79},"scripts\u002Fdpdk_static_scan.py",24440,"https:\u002F\u002Fgithub.com\u002FSyukPublic\u002Fai-dev-toolkit\u002Fblob\u002Fmain\u002Fplugins\u002Fdataplane-engineering\u002Fskills\u002Fdpdk-dataplane-engineering\u002Fscripts\u002Fdpdk_static_scan.py",[81,88,95,102,109,116],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M7A06HE8FF5S1MG986C2K19R","sample-skill","Reviews recent changes and reports actionable findings for testing purposes","https:\u002F\u002Fgithub.com\u002FSyukPublic\u002Fai-dev-toolkit\u002Fblob\u002Fmain\u002Fsite\u002Ftest-fixtures\u002Frepo-good\u002Fplugins\u002Ffixture-plugin\u002Fskills\u002Fsample-skill\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M7A069XFAMZSSVQPQEKMCCCH","workflow-retro","Post-run retrospective of the multi-agent SDD pipeline (spec-creator → implementation-planner → implementer \u002F test-writer → architecture-reviewer \u002F plan-verifier, plus nested researcher\u002FExplore agents). Manually invoked after a run to produce TRUE token\u002Ftool\u002Fduration\u002Fparallelism metrics — deep mode parses session + subagent journals from disk because parent-visible usage EXCLUDES subagent tokens — plus insights with concrete optimization actions, a trend row appended to the retro ledger (default docs\u002Fretros\u002Fledger.md), and an audit verdict. Trigger terms: workflow retro, retro, ретро, retrospective, pipeline metrics, agent token usage, cache hit, parallelism, як пройшов конвеєр.","https:\u002F\u002Fgithub.com\u002FSyukPublic\u002Fai-dev-toolkit\u002Fblob\u002Fmain\u002Fplugins\u002Fsdd-engineering\u002Fskills\u002Fworkflow-retro\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":19},"01M7A060WWM0BE90HWSJQ8TM2G","run-plan","Executes an APPROVED Development Plan through the SDD implementation pipeline: implementer wave(s) → test-writer gap pass → green barrier (tests + typecheck) → architecture-reviewer ∥ plan-verifier → bounded fix loop (max 2 iterations) → final report. HARD GATE: an existing plan file is a required input — no plan, no run. Unlike implementer (ships ONE slice) — this skill orchestrates the WHOLE plan across agents; unlike workflow-retro (measures a PAST run) — this skill performs the run; unlike a pre-publish diff review — this skill implements and verifies, it never publishes. Trigger terms: run-plan, run the plan, execute the plan, run the implementation pipeline, запусти план, запусти конвеєр, виконай план, прожени план через конвеєр.","https:\u002F\u002Fgithub.com\u002FSyukPublic\u002Fai-dev-toolkit\u002Fblob\u002Fmain\u002Fplugins\u002Fsdd-engineering\u002Fskills\u002Frun-plan\u002FSKILL.md",[],[],{"skillNo":103,"name":104,"nameZh":6,"description":105,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":106,"categories":107,"keywords":108,"publishedAt":19},"01M7A05WMWZ4QPGQYBAABS5AD2","mermaid-diagram","Create Mermaid diagrams in markdown. Use when the user wants to visualize workflows, architectures, API flows, data models, state machines, or system designs. Covers flowcharts, sequence diagrams, class diagrams, ER diagrams, state diagrams, and more.","https:\u002F\u002Fgithub.com\u002FSyukPublic\u002Fai-dev-toolkit\u002Fblob\u002Fmain\u002Fplugins\u002Fsdd-engineering\u002Fskills\u002Fmermaid-diagram\u002FSKILL.md",[],[],{"skillNo":110,"name":111,"nameZh":6,"description":112,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":113,"categories":114,"keywords":115,"publishedAt":19},"01M7A05NQ6QV259QFW1XWVH5GG","engineering-insights","Capture durable engineering insights into the host project's insights file (default docs\u002Fengineering-insights.md), and prune that log. Use during any session when a non-obvious discovery is confirmed — a gotcha, a fix's root cause, a why-it's-like-this decision, an antipattern, or a tool\u002Flibrary quirk — and at session wrap-up to sweep for learnings. Also use to review, dedup, or declutter the insights file. Trigger terms: insight, learning, gotcha, engineering insights, lesson learned, wrap-up, retrospective, prune insights.","https:\u002F\u002Fgithub.com\u002FSyukPublic\u002Fai-dev-toolkit\u002Fblob\u002Fmain\u002Fplugins\u002Fsdd-engineering\u002Fskills\u002Fengineering-insights\u002FSKILL.md",[],[],{"skillNo":117,"name":118,"nameZh":6,"description":119,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":120,"categories":121,"keywords":122,"publishedAt":19},"01M7A05ER6QKT6X84TCV09KBSC","typescript-expert","TypeScript and JavaScript expert with deep knowledge of type-level programming, performance optimization, monorepo management, migration strategies, and modern tooling.","https:\u002F\u002Fgithub.com\u002FSyukPublic\u002Fai-dev-toolkit\u002Fblob\u002Fmain\u002Fplugins\u002Fengineering-paved-path\u002Fskills\u002Ftypescript-expert\u002FSKILL.md",[],[]]