Yocto layer review
Skill Higangssh/yocto-agent-skills/skills/yocto-layer-review
Official-doc-first Yocto Project and BitBake skills for AI coding agents
npx -y skills add Higangssh/yocto-agent-skills --skill yocto-layer-reviewAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 5 stars5 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Review Yocto/OpenEmbedded layer structure, layer.conf, BBFILE collections and patterns, LAYERSERIES_COMPAT, LAYERDEPENDS, BBFILE_PRIORITY, BBFILES_DYNAMIC, bbappend matching, overlayed recipes, provider selection, and layer compatibility. Use for layer creation, layer migration, layer review, or when a bbappend/recipe is not being applied.
SKILL.md
2.5 KB, as published. Nobody here has run it
Yocto Layer Review
Use this skill to review layers and diagnose metadata visibility problems. Layer issues often look like recipe, provider, or package failures; prove whether BitBake sees the metadata first.
Required Evidence
Ask for or inspect:
conf/layer.conf
conf/bblayers.conf
bitbake-layers show-layers
bitbake-layers show-recipes <recipe>
bitbake-layers show-appends
bitbake-layers show-overlayed
Layer Checklist
Review:
BBPATH .= ":${LAYERDIR}"
BBFILES += "${LAYERDIR}/recipes-*/*/*.bb ${LAYERDIR}/recipes-*/*/*.bbappend"
BBFILE_COLLECTIONS += "mylayer"
BBFILE_PATTERN_mylayer = "^${LAYERDIR}/"
BBFILE_PRIORITY_mylayer = "6"
LAYERSERIES_COMPAT_mylayer = "scarthgap walnascar"
LAYERDEPENDS_mylayer = "core"
Check:
- collection name is unique and stable
LAYERSERIES_COMPAT_*matches the target release- required layers are declared with
LAYERDEPENDS_* - recipe and append globs cover intended files
BBFILE_PRIORITY_*is not used to hide provider/version policy problems- optional bbappends use
BBFILES_DYNAMICwhen the target layer may be absent .bbappendfilename matches an existing recipe version or intentionally uses%
Common Problems
- layer is present in the tree but missing from
bblayers.conf .bbappendsilently not applied due to recipe version mismatch- collection name in
BBFILES_DYNAMICdoes not match target layer collection - layer priority causes a recipe to win unexpectedly
- vendor BSP layer pins an older release and rejects modern syntax
- dependency layer missing even though a recipe path exists locally
References
- Read ../../references/shared/official-doc-map.md for official layer docs.
- Read ../../references/shared/yocto-field-guide.md for layer and provider basics.
- Read ../../references/yocto/migration.md for release compatibility checks.
Output
Answer with:
- whether BitBake sees the layer and append
- exact layer.conf or filename issue
- metadata visibility command to prove it
- minimal fix
- validation command