[{"data":1,"prerenderedAt":475},["Reactive",2],{"VEb9Nnn1YX":3,"cli,agent-skill":26},{"items":4,"meta":23},[5,8,11,14,17,20],{"title":6,"titleUrl":7},"MQTT Topics and Wildcards: A Beginner's Guide","advanced-features-of-mqtt-topics",{"title":9,"titleUrl":10},"MQTT on ESP32: A Beginner's Guide","esp32-connects-to-the-free-public-mqtt-broker",{"title":12,"titleUrl":13},"MQTT QoS 0, 1, 2 Explained: A Quickstart Guide","introduction-to-mqtt-qos",{"title":15,"titleUrl":16},"MQTT in Python with Paho Client: Beginner's Guide 2026","how-to-use-mqtt-in-python",{"title":18,"titleUrl":19},"MQTT Broker: How It Works, Popular Options, and Quickstart","the-ultimate-guide-to-mqtt-broker-comparison",{"title":21,"titleUrl":22},"CAN Bus Uncovered: Basics and Applications in Vehicles","can-bus-how-it-works-pros-and-cons",{"count":24,"limit":24,"page":25},6,1,{"_path":27,"_dir":28,"_draft":29,"_partial":29,"_locale":30,"title":31,"description":32,"body":33,"_type":470,"_id":471,"_source":472,"_file":473,"_extension":474},"/en/cli/agent-skill","cli",false,"","AI Agent Skill","MQTTX CLI ships with an Agent Skill that teaches AI coding agents how to operate the mqttx command correctly and safely. The skill lives in the MQTTX repository at skills/mqttx-cli and covers connection checks, publishing and subscribing, MQTT 5 features, TLS and SCRAM authentication, payload codecs and schemas, benchmarks, data simulation, configuration, and troubleshooting.",{"type":34,"children":35,"toc":463},"root",[36,44,75,82,94,111,117,131,143,184,190,202,204,444,450,455],{"type":37,"tag":38,"props":39,"children":41},"element","h1",{"id":40},"ai-agent-skill",[42],{"type":43,"value":31},"text",{"type":37,"tag":45,"props":46,"children":47},"p",{},[48,50,57,59,73],{"type":43,"value":49},"MQTTX CLI ships with an Agent Skill that teaches AI coding agents how to operate the ",{"type":37,"tag":51,"props":52,"children":54},"code",{"className":53},[],[55],{"type":43,"value":56},"mqttx",{"type":43,"value":58}," command correctly and safely. The skill lives in the MQTTX repository at ",{"type":37,"tag":60,"props":61,"children":66},"a",{"href":62,"rel":63,"target":65},"https://github.com/emqx/MQTTX/tree/main/skills/mqttx-cli",[64,64],"noopener","_blank",[67],{"type":37,"tag":51,"props":68,"children":70},{"className":69},[],[71],{"type":43,"value":72},"skills/mqttx-cli",{"type":43,"value":74}," and covers connection checks, publishing and subscribing, MQTT 5 features, TLS and SCRAM authentication, payload codecs and schemas, benchmarks, data simulation, configuration, and troubleshooting.",{"type":37,"tag":76,"props":77,"children":79},"h2",{"id":78},"install-or-update-mqttx-cli-with-an-agent",[80],{"type":43,"value":81},"Install or Update MQTTX CLI with an Agent",{"type":37,"tag":45,"props":83,"children":84},{},[85,92],{"type":37,"tag":60,"props":86,"children":89},{"href":87,"rel":88,"target":65},"https://github.com/emqx/MQTTX/blob/main/INSTALL.md",[64,64],[90],{"type":43,"value":91},"INSTALL.md",{"type":43,"value":93}," provides installation and update instructions written for agents, including environment detection, package selection, and version verification. Give your agent this prompt:",{"type":37,"tag":95,"props":96,"children":97},"blockquote",{},[98],{"type":37,"tag":45,"props":99,"children":100},{},[101,103,109],{"type":43,"value":102},"Read ",{"type":37,"tag":60,"props":104,"children":107},{"href":105,"rel":106,"target":65},"https://raw.githubusercontent.com/emqx/MQTTX/main/INSTALL.md",[64,64],[108],{"type":43,"value":105},{"type":43,"value":110}," and follow its instructions to install or update MQTTX CLI for this environment. Verify the executable path and version.",{"type":37,"tag":76,"props":112,"children":114},{"id":113},"install-the-skill",[115],{"type":43,"value":116},"Install the Skill",{"type":37,"tag":45,"props":118,"children":119},{},[120,122,129],{"type":43,"value":121},"Install it with the ",{"type":37,"tag":60,"props":123,"children":126},{"href":124,"rel":125,"target":65},"https://github.com/vercel-labs/skills",[64,64],[127],{"type":43,"value":128},"Skills CLI",{"type":43,"value":130},":",{"type":37,"tag":132,"props":133,"children":138},"pre",{"className":134,"code":136,"language":137,"meta":30},[135],"language-shell","npx skills add emqx/MQTTX --skill mqttx-cli\n","shell",[139],{"type":37,"tag":51,"props":140,"children":141},{"__ignoreMap":30},[142],{"type":43,"value":136},{"type":37,"tag":45,"props":144,"children":145},{},[146,148,154,156,161,163,169,171,182],{"type":43,"value":147},"To install from a local checkout, run ",{"type":37,"tag":51,"props":149,"children":151},{"className":150},[],[152],{"type":43,"value":153},"npx skills add . --skill mqttx-cli",{"type":43,"value":155}," from the repository root. You can also copy the entire ",{"type":37,"tag":51,"props":157,"children":159},{"className":158},[],[160],{"type":43,"value":72},{"type":43,"value":162}," directory (including ",{"type":37,"tag":51,"props":164,"children":166},{"className":165},[],[167],{"type":43,"value":168},"references",{"type":43,"value":170},") into your agent's supported skills directory, or ask the agent to read its ",{"type":37,"tag":60,"props":172,"children":175},{"href":173,"rel":174,"target":65},"https://github.com/emqx/MQTTX/blob/main/skills/mqttx-cli/SKILL.md",[64,64],[176],{"type":37,"tag":51,"props":177,"children":179},{"className":178},[],[180],{"type":43,"value":181},"SKILL.md",{"type":43,"value":183}," directly.",{"type":37,"tag":76,"props":185,"children":187},{"id":186},"what-the-skill-covers",[188],{"type":43,"value":189},"What the Skill Covers",{"type":37,"tag":45,"props":191,"children":192},{},[193,195,200],{"type":43,"value":194},"The skill's ",{"type":37,"tag":51,"props":196,"children":198},{"className":197},[],[199],{"type":43,"value":181},{"type":43,"value":201}," routes the agent to a dedicated reference document per task, so the agent only reads what it needs:",{"type":43,"value":203},"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",{"type":37,"tag":205,"props":206,"children":207},"table",{},[208,227],{"type":37,"tag":209,"props":210,"children":211},"thead",{},[212],{"type":37,"tag":213,"props":214,"children":215},"tr",{},[216,222],{"type":37,"tag":217,"props":218,"children":219},"th",{},[220],{"type":43,"value":221},"Task",{"type":37,"tag":217,"props":223,"children":224},{},[225],{"type":43,"value":226},"Reference",{"type":37,"tag":228,"props":229,"children":230},"tbody",{},[231,271,289,307,325,377,408,426],{"type":37,"tag":213,"props":232,"children":233},{},[234,261],{"type":37,"tag":235,"props":236,"children":237},"td",{},[238,244,246,252,253,259],{"type":37,"tag":51,"props":239,"children":241},{"className":240},[],[242],{"type":43,"value":243},"conn",{"type":43,"value":245},", ",{"type":37,"tag":51,"props":247,"children":249},{"className":248},[],[250],{"type":43,"value":251},"pub",{"type":43,"value":245},{"type":37,"tag":51,"props":254,"children":256},{"className":255},[],[257],{"type":43,"value":258},"sub",{"type":43,"value":260},", bounded checks and round trips",{"type":37,"tag":235,"props":262,"children":263},{},[264],{"type":37,"tag":60,"props":265,"children":268},{"href":266,"rel":267,"target":65},"https://github.com/emqx/MQTTX/blob/main/skills/mqttx-cli/references/workflows.md",[64,64],[269],{"type":43,"value":270},"Basic workflows",{"type":37,"tag":213,"props":272,"children":273},{},[274,279],{"type":37,"tag":235,"props":275,"children":276},{},[277],{"type":43,"value":278},"Transport, TLS/mTLS, WebSocket headers, credentials, SCRAM",{"type":37,"tag":235,"props":280,"children":281},{},[282],{"type":37,"tag":60,"props":283,"children":286},{"href":284,"rel":285,"target":65},"https://github.com/emqx/MQTTX/blob/main/skills/mqttx-cli/references/connections.md",[64,64],[287],{"type":43,"value":288},"Connections and authentication",{"type":37,"tag":213,"props":290,"children":291},{},[292,297],{"type":37,"tag":235,"props":293,"children":294},{},[295],{"type":43,"value":296},"MQTT 3/5, QoS, retained messages, sessions, wills, request/response, subscription properties",{"type":37,"tag":235,"props":298,"children":299},{},[300],{"type":37,"tag":60,"props":301,"children":304},{"href":302,"rel":303,"target":65},"https://github.com/emqx/MQTTX/blob/main/skills/mqttx-cli/references/mqtt-features.md",[64,64],[305],{"type":43,"value":306},"MQTT features",{"type":37,"tag":213,"props":308,"children":309},{},[310,315],{"type":37,"tag":235,"props":311,"children":312},{},[313],{"type":43,"value":314},"Text/binary input, interactive line mode, files, codecs, Protobuf/Avro, random payloads",{"type":37,"tag":235,"props":316,"children":317},{},[318],{"type":37,"tag":60,"props":319,"children":322},{"href":320,"rel":321,"target":65},"https://github.com/emqx/MQTTX/blob/main/skills/mqttx-cli/references/payloads.md",[64,64],[323],{"type":43,"value":324},"Payloads and files",{"type":37,"tag":213,"props":326,"children":327},{},[328,367],{"type":37,"tag":235,"props":329,"children":330},{},[331,337,338,344,345,351,352,358,359,365],{"type":37,"tag":51,"props":332,"children":334},{"className":333},[],[335],{"type":43,"value":336},"bench conn",{"type":43,"value":245},{"type":37,"tag":51,"props":339,"children":341},{"className":340},[],[342],{"type":43,"value":343},"bench pub",{"type":43,"value":245},{"type":37,"tag":51,"props":346,"children":348},{"className":347},[],[349],{"type":43,"value":350},"bench sub",{"type":43,"value":245},{"type":37,"tag":51,"props":353,"children":355},{"className":354},[],[356],{"type":43,"value":357},"simulate",{"type":43,"value":245},{"type":37,"tag":51,"props":360,"children":362},{"className":361},[],[363],{"type":43,"value":364},"ls --scenarios",{"type":43,"value":366},", custom generators",{"type":37,"tag":235,"props":368,"children":369},{},[370],{"type":37,"tag":60,"props":371,"children":374},{"href":372,"rel":373,"target":65},"https://github.com/emqx/MQTTX/blob/main/skills/mqttx-cli/references/benchmarks-and-simulation.md",[64,64],[375],{"type":43,"value":376},"Benchmarks and simulation",{"type":37,"tag":213,"props":378,"children":379},{},[380,398],{"type":37,"tag":235,"props":381,"children":382},{},[383,389,390,396],{"type":37,"tag":51,"props":384,"children":386},{"className":385},[],[387],{"type":43,"value":388},"init",{"type":43,"value":245},{"type":37,"tag":51,"props":391,"children":393},{"className":392},[],[394],{"type":43,"value":395},"check",{"type":43,"value":397},", help/version, INI defaults, JSON/YAML options",{"type":37,"tag":235,"props":399,"children":400},{},[401],{"type":37,"tag":60,"props":402,"children":405},{"href":403,"rel":404,"target":65},"https://github.com/emqx/MQTTX/blob/main/skills/mqttx-cli/references/configuration.md",[64,64],[406],{"type":43,"value":407},"Configuration and utilities",{"type":37,"tag":213,"props":409,"children":410},{},[411,416],{"type":37,"tag":235,"props":412,"children":413},{},[414],{"type":43,"value":415},"Exact flag availability by command and version-specific caveats",{"type":37,"tag":235,"props":417,"children":418},{},[419],{"type":37,"tag":60,"props":420,"children":423},{"href":421,"rel":422,"target":65},"https://github.com/emqx/MQTTX/blob/main/skills/mqttx-cli/references/capabilities.md",[64,64],[424],{"type":43,"value":425},"Capability map",{"type":37,"tag":213,"props":427,"children":428},{},[429,434],{"type":37,"tag":235,"props":430,"children":431},{},[432],{"type":43,"value":433},"Failures and diagnosis",{"type":37,"tag":235,"props":435,"children":436},{},[437],{"type":37,"tag":60,"props":438,"children":441},{"href":439,"rel":440,"target":65},"https://github.com/emqx/MQTTX/blob/main/skills/mqttx-cli/references/troubleshooting.md",[64,64],[442],{"type":43,"value":443},"Troubleshooting",{"type":37,"tag":76,"props":445,"children":447},{"id":446},"try-it",[448],{"type":43,"value":449},"Try It",{"type":37,"tag":45,"props":451,"children":452},{},[453],{"type":43,"value":454},"Once installed, give your agent a task such as:",{"type":37,"tag":95,"props":456,"children":457},{},[458],{"type":37,"tag":45,"props":459,"children":460},{},[461],{"type":43,"value":462},"Use the mqttx-cli skill to verify a publish/subscribe round trip against my local broker at 127.0.0.1:1883. Use a unique topic under mqttx-test/, finish within 15 seconds, and report the result.",{"title":30,"searchDepth":464,"depth":464,"links":465},2,[466,467,468,469],{"id":78,"depth":464,"text":81},{"id":113,"depth":464,"text":116},{"id":186,"depth":464,"text":189},{"id":446,"depth":464,"text":449},"markdown","content:en:cli:agent-skill.md","content","en/cli/agent-skill.md","md",1789895726944]