executorch-kb

Searches a curated ExecuTorch knowledge base covering backends, quantization, export pitfalls, and runtime errors.

5.0k|1.1k|Updated Feb 25, 2022
One-click install
npx skills add https://github.com/pytorch/executorch --skill executorch-kb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: executorch-kb
Source: https://github.com/pytorch/executorch/tree/main/.claude/skills/executorch-kb
Command: npx skills add https://github.com/pytorch/executorch --skill executorch-kb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debugging ExecuTorch deployment issues often requires digging through thousands of scattered GitHub issues and discussions. This Skill provides a synthesized tribal knowledge base covering QNN, XNNPACK, Vulkan, CoreML, Arm, and Cadence backends so you can find proven answers to export, quantization, and runtime problems quickly.

Core Features & Use Cases

  • Backend-Specific Knowledge: Query curated articles on QNN/HTP SoC compatibility, XNNPACK CPU delegation, Vulkan shader bugs, CoreML behavior, Arm Ethos-U, and Cadence Xtensa.
  • Quantization & Export Guidance: Find quantization recipes, accuracy debugging steps, and torch.export pitfalls for LLM and vision models.
  • Troubleshooting with Citations: Get answers for build failures, runtime crashes, and performance issues with source issue citations and confidence flags for single-source workarounds.
  • Use Case: You hit an HTP error when delegating a quantized model to a Snapdragon V68 SoC. Query the knowledge base to find the known cause, the reported workaround, and whether to verify against the official QNN op support documentation.

Quick Start

Ask the executorch-kb skill a question such as why your QNN delegation fails on a V68 HTP or which quantization recipe to use for a Llama model.

Frequently Asked Questions about executorch-kb

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug ExecuTorch QNN backend errors on Snapdragon?

Query the knowledge base with your error message or SoC details. It routes QNN questions to dedicated articles on HTP errors, debugging, profiling, and SoC compatibility for V68/V73 architectures, with citations to the original GitHub issues.

What quantization recipe should I use for ExecuTorch models?

The knowledge base includes a quantization recipes article covering recipe selection per backend, plus a debugging article for accuracy loss after quantization. Ask about your model type and target backend to get the relevant guidance.

Does ExecuTorch support my hardware backend like CoreML or Ethos-U?

The knowledge base covers CoreML, Arm Ethos-U, XNNPACK, Vulkan, QNN, and Cadence backends with op support and compatibility notes. For hardware constraints or SDK claims, it can cross-reference official vendor documentation to verify currency.

Why does my ExecuTorch model crash at runtime with missing ops?

Runtime crashes and missing operator errors are covered in the troubleshooting runtime-errors article. The knowledge base maps symptoms to known issues and reported workarounds, flagging any single-source fixes as lower confidence.

Can I trust the workarounds from the ExecuTorch knowledge base?

Entries cite source issue numbers, and single-source or synthesis-derived workarounds are explicitly flagged as unverified. For hardware constraints or SDK compatibility claims, the skill recommends verifying against official Qualcomm, Apple, or Arm documentation.