{"slug": "show-hn-yocto-bitbake-skills-that-make-ai-agents-check-official-docs", "title": "Show HN: Yocto/BitBake skills that make AI agents check official docs", "summary": "A developer released a set of Yocto Project and BitBake skills for AI coding agents that route to official documentation and help debug build failures, review recipes and layers, and handle security workflows. The skills aim to reduce hallucinations by general LLMs on Yocto's release-sensitive and deeply configurable system.", "body_md": "Official-doc-first Yocto Project and BitBake skills for AI coding agents.\n\nYocto is release-sensitive, deeply configurable, and easy for general LLMs to hallucinate. This repository gives agents focused skills for routing to official documentation, debugging BitBake failures, reviewing recipes, reviewing layers, diagnosing image/rootfs problems, working through BSP/kernel issues, and handling security/SBOM workflows.\n\nKorean documentation: [README.ko.md](/Higangssh/yocto-agent-skills/blob/main/README.ko.md)\n\n`skills/yocto-doc-router`\n\n: release-aware routing to the right Yocto, OpenEmbedded, and BitBake official documentation.`skills/bitbake-debug`\n\n: task/log/rootfs/package/provider debugging for BitBake build failures.`skills/yocto-recipe-review`\n\n: recipe, bbappend, bbclass, dependency, packaging, licensing, and override syntax review.`skills/yocto-layer-review`\n\n: layer.conf, layer compatibility, priority, dependency, provider, and bbappend matching review.`skills/yocto-image-rootfs`\n\n: image recipes, package names,`IMAGE_INSTALL`\n\n,`IMAGE_FEATURES`\n\n,`do_rootfs`\n\n, pkgdata, and package manager issues.`skills/yocto-bsp-kernel`\n\n: machine config, BSP layers, kernel providers, devicetree, defconfig, U-Boot, and deploy artifacts.`skills/yocto-security-sbom`\n\n: license metadata, CVE checks, SPDX/SBOM, archiver/copyleft flows, and compliance artifacts.\n\nThe root `SKILL.md`\n\nremains as a compatibility router for hosts that install a repository as a single skill.\n\n- Debugging BitBake task failures:\n`do_fetch`\n\n,`do_unpack`\n\n,`do_patch`\n\n,`do_configure`\n\n,`do_compile`\n\n,`do_install`\n\n,`do_package`\n\n,`do_package_qa`\n\n,`do_rootfs`\n\n,`do_image`\n\n- Writing and reviewing\n`.bb`\n\n,`.bbappend`\n\n,`.bbclass`\n\n, image recipes, machine config, distro config, and`layer.conf`\n\n- Modernizing BitBake override syntax:\n`VAR:append`\n\n,`FILES:${PN}`\n\n,`RDEPENDS:${PN}`\n\n, task overrides, and package overrides - Reviewing layers, bbappends, provider selection, package splitting, rootfs failures, QA messages, kernel/BSP metadata, and image composition\n- Reducing common AI mistakes around\n`DEPENDS`\n\nvs`RDEPENDS`\n\n, recipe names vs package names,`SRCREV`\n\n,`LIC_FILES_CHKSUM`\n\n,`INSANE_SKIP`\n\n, host contamination, and sstate cleanup\n\nFor collection-aware agents, install the individual folders under `skills/`\n\n.\n\n```\nmkdir -p \"${CODEX_HOME:-$HOME/.codex}/skills\"\nfor skill in yocto-doc-router bitbake-debug yocto-recipe-review yocto-layer-review yocto-image-rootfs yocto-bsp-kernel yocto-security-sbom; do\n  ln -s \"$(pwd)/skills/$skill\" \"${CODEX_HOME:-$HOME/.codex}/skills/$skill\"\ndone\n```\n\nFor hosts that install one folder as one skill, install the repository root:\n\n```\nmkdir -p \"${CODEX_HOME:-$HOME/.codex}/skills\"\nln -s \"$(pwd)\" \"${CODEX_HOME:-$HOME/.codex}/skills/yocto-agent-skills\"\nUse bitbake-debug to diagnose this do_rootfs failure.\nUse yocto-recipe-review to review this recipe and modernize the override syntax.\nUse yocto-layer-review to explain why this bbappend is not being applied.\nUse yocto-image-rootfs to find why my package is not in the final image.\nUse yocto-bsp-kernel to debug why my devicetree is missing from deploy/images.\nUse yocto-security-sbom to review this license checksum and SBOM setup.\n```\n\n`SKILL.md`\n\n: root compatibility router`skills/*/SKILL.md`\n\n: focused installable skills`references/shared/official-doc-map.md`\n\n: official Yocto/BitBake documentation routing by problem type`references/shared/yocto-field-guide.md`\n\n: compact field guide for recipes, layers, tasks, QA, images, providers, and BSP/kernel work`references/bitbake/variables-core.md`\n\n: variables agents often confuse`references/bitbake/classes-core.md`\n\n: common classes and review rules`references/bitbake/tasks-reference.md`\n\n: task-level debugging reference`references/yocto/qa-errors.md`\n\n: common QA error patterns`references/yocto/migration.md`\n\n: release-aware migration checks`references/yocto/image-rootfs.md`\n\n: image and rootfs troubleshooting`references/yocto/bsp-kernel.md`\n\n: BSP and kernel troubleshooting`references/yocto/security-sbom.md`\n\n: security, license, CVE, and SBOM workflows`examples/`\n\n: realistic failure examples and expected answer patterns`evals/prompts.md`\n\n: manual forward-test prompts`agents/openai.yaml`\n\n: UI metadata for compatible skill hosts\n\nMIT", "url": "https://wpnews.pro/news/show-hn-yocto-bitbake-skills-that-make-ai-agents-check-official-docs", "canonical_source": "https://github.com/Higangssh/yocto-agent-skills", "published_at": "2026-06-29 23:52:46+00:00", "updated_at": "2026-06-30 00:21:20.738733+00:00", "lang": "en", "topics": ["ai-agents", "developer-tools"], "entities": ["Yocto Project", "BitBake", "OpenEmbedded"], "alternates": {"html": "https://wpnews.pro/news/show-hn-yocto-bitbake-skills-that-make-ai-agents-check-official-docs", "markdown": "https://wpnews.pro/news/show-hn-yocto-bitbake-skills-that-make-ai-agents-check-official-docs.md", "text": "https://wpnews.pro/news/show-hn-yocto-bitbake-skills-that-make-ai-agents-check-official-docs.txt", "jsonld": "https://wpnews.pro/news/show-hn-yocto-bitbake-skills-that-make-ai-agents-check-official-docs.jsonld"}}