GitHub - Higangssh/yocto-agent-skills: Official-doc-first Yocto Project and BitBake skills for AI coding agents · GitHub

/" data-turbo-transient="true" />

Skip to content

Search or jump to...

Search code, repositories, users, issues, pull requests...

-->

Search

Clear

Search syntax tips

Provide feedback

--><br>We read every piece of feedback, and take your input very seriously.

Include my email address so I can be contacted

Cancel

Submit feedback

Saved searches

Use saved searches to filter your results more quickly

-->

Name

Query

To see all available qualifiers, see our documentation.

Cancel

Create saved search

Sign in

/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up

Appearance settings

Resetting focus

You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.

Dismiss alert

{{ message }}

Higangssh

yocto-agent-skills

Public

Notifications<br>You must be signed in to change notification settings

Fork

Star

main

BranchesTags

Go to file

CodeOpen more actions menu

Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit

History<br>6 Commits<br>6 Commits

.github

.github

agents

agents

evals

evals

examples

examples

references

references

skills

skills

CHANGELOG.md

CHANGELOG.md

CONTRIBUTING.md

CONTRIBUTING.md

LICENSE

LICENSE

README.ko.md

README.ko.md

README.md

README.md

SKILL.md

SKILL.md

View all files

Repository files navigation

Yocto Agent Skills

Official-doc-first Yocto Project and BitBake skills for AI coding agents.

Yocto 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.

Korean documentation: README.ko.md

Skills

skills/yocto-doc-router: release-aware routing to the right Yocto, OpenEmbedded, and BitBake official documentation.

skills/bitbake-debug: task/log/rootfs/package/provider debugging for BitBake build failures.

skills/yocto-recipe-review: recipe, bbappend, bbclass, dependency, packaging, licensing, and override syntax review.

skills/yocto-layer-review: layer.conf, layer compatibility, priority, dependency, provider, and bbappend matching review.

skills/yocto-image-rootfs: image recipes, package names, IMAGE_INSTALL, IMAGE_FEATURES, do_rootfs, pkgdata, and package manager issues.

skills/yocto-bsp-kernel: machine config, BSP layers, kernel providers, devicetree, defconfig, U-Boot, and deploy artifacts.

skills/yocto-security-sbom: license metadata, CVE checks, SPDX/SBOM, archiver/copyleft flows, and compliance artifacts.

The root SKILL.md remains as a compatibility router for hosts that install a repository as a single skill.

What It Helps With

Debugging BitBake task failures: do_fetch, do_unpack, do_patch, do_configure, do_compile, do_install, do_package, do_package_qa, do_rootfs, do_image

Writing and reviewing .bb, .bbappend, .bbclass, image recipes, machine config, distro config, and layer.conf

Modernizing BitBake override syntax: VAR:append, FILES:${PN}, RDEPENDS:${PN}, task overrides, and package overrides

Reviewing layers, bbappends, provider selection, package splitting, rootfs failures, QA messages, kernel/BSP metadata, and image composition

Reducing common AI mistakes around DEPENDS vs RDEPENDS, recipe names vs package names, SRCREV, LIC_FILES_CHKSUM, INSANE_SKIP, host contamination, and sstate cleanup

Installation

For collection-aware agents, install the individual folders under skills/.

mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"<br>for skill in yocto-doc-router bitbake-debug yocto-recipe-review yocto-layer-review yocto-image-rootfs yocto-bsp-kernel yocto-security-sbom; do<br>ln -s "$(pwd)/skills/$skill" "${CODEX_HOME:-$HOME/.codex}/skills/$skill"<br>done

For hosts that install one folder as one skill, install the repository root:

mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"<br>ln -s "$(pwd)" "${CODEX_HOME:-$HOME/.codex}/skills/yocto-agent-skills"

Example Prompts

Use bitbake-debug to diagnose this do_rootfs failure.

Use yocto-recipe-review to review this recipe and modernize the override syntax.

Use yocto-layer-review to explain why this bbappend is not being applied.

Use yocto-image-rootfs to find why my package is not in the final image.

Use yocto-bsp-kernel to debug why my devicetree is missing from deploy/images.

Use yocto-security-sbom to review this license checksum and SBOM setup.

Contents

SKILL.md: root compatibility router

skills/*/SKILL.md: focused installable skills

references/shared/official-doc-map.md: official Yocto/BitBake documentation routing by problem type

references/shared/yocto-field-guide.md: compact field guide for...