Remove Unused Includes
Developmentremove-unused-includesRemove Unused Includes is an Agent Skill for development published in the chromium/chromium repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Look through a given folder to find and safely remove unused includes specifically for Clang-compiled code (using clang-include-cleaner), verifying that referencing targets compile.
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.
Inspect the Agent Skill at https://github.com/chromium/chromium/blob/HEAD/agents/skills/remove-unused-includes/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/remove-unused-includes, 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.
🧹 Remove Unused Includes Skill
This skill provides a workflow and script to look through a given folder,
identify unused includes using clang-include-cleaner, and safely remove them
only if the affected targets continue to compile successfully.
Prerequisites
- Compilation Database (
compile_commands.json): Ensure your compilation database is up-to-date. If not, generate a fresh compilation database using:python3 tools/clang/scripts/generate_compdb.py -p out/Default -o compile_commands.json
Workflow Steps
1. Run the Cleanup Script
Run the automated cleanup script located inside this skill's directory (resolve
the absolute <skill_directory_path> from the skill metadata):
python3 <skill_directory_path>/scripts/remove_unused_includes.py --src-root . --folder <relative_or_absolute_folder_path>
2. Verify Compilation
The script automatically:
- Finds all
.ccfiles in the specified folder. - Detects unused includes using
clang-include-cleaner. - Locates all referencing GN targets for each modified file via
gn refs. - Edits the file and compiles each referencing target.
- Reverts the edit if any compilation errors occur.
3. Review Git Status
Once execution is complete, verify the final changes using git:
git status
git diff