Header Self Containment
Developmentheader-self-containmentHeader Self Containment is an Agent Skill for development published in the google/filament repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Enforce strict header self-containment so that every header file compiles independently. Use this skill when creating or modifying C++ header files.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/google/filament/blob/HEAD/skills/header_self_containment/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/header-self-containment, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Strict Header Self-Containment
Every header file (.h) in Filament must be fully self-contained and compile independently.
- Rule: Never assume a header's type dependencies (like
FrameGraphHandle) are pre-declared by preceding includes in a.cppfile. - Action: Always explicitly
#includethe declaring header (e.g.,fg/FrameGraphId.h) inside the header itself.