SkillsAdd

openharmonyinsight/openharmony-skills

cpp-include-sorter

Automatically sorts C/C++ header files (#include statements) with full support for conditional compilation blocks. Use when Claude needs to organize #include statements in .cpp/.h files. Handles: (1) Corresponding header placement first (e.g., file.cpp includes file.h), (2) System headers (<>) sorted alphabetically, (3) Local headers ("") sorted alphabetically, (4) Conditional compilation blocks (#ifdef/#ifndef/#if defined) where headers participate in global sort while preserving block structu…

First seen Feb 10, 2026

Installation

$ npx skills add openharmonyinsight/openharmony-skills --skill cpp-include-sorter
View on skills.sh ↗ GitHub repository ↗

Summary

  • Automatically sorts C/C++ header files (#include statements) with full support for conditional compilation blocks.
  • Use when Claude needs to organize #include statements in .cpp/.h files.
  • Handles: (1) Corresponding header placement first (e.g., file.cpp includes file.h), (2) System headers (<>) sorted alphabetically, (3) Local headers ("") sorted alphabetically, (4) Conditional compilation blocks (#ifdef/#ifndef/#if defined) where headers participate in global sort while preserving block structure.
  • Key features: prefers longer paths for duplicate includes, preserves inline/preceding comments, handles #elif/#else blocks, validates no headers are lost.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

include Similar name
ghaida/intent

Design for everyone by treating accessibility as a first-class design discipline, not a complia…

1.6K installs
include-what-you-use Similar name
mohitmishra786/low-level-dev-skills

Include What You Use (IWYU) skill for optimizing C/C++ header includes. Use when reducing compi…

339 installs

Also in this package

Other skills from openharmonyinsight/openharmony-skills · top by installs.

npx skills add openharmonyinsight/openharmony-skills
openharmony-cpp 124 openharmony-security-review 120 openharmony-build 100 oh-ut-generator 99 cpp-core-guidelines-review 92 android-to-harmonyos-migration-workflow 91 arkui-api-design 87 ai-generated-business-code-review 83 openharmony-download 81 openharmony-ut 79

Browse all from openharmonyinsight/openharmony-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 33
Default branch main
Open issues 2
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,629 B
  • docs SUMMARY.md 683 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 72 installs

SKILL.md

C/C++ Include Sorter

Automatically sorts #include statements in C/C++ source files with intelligent handling of conditional compilation blocks.

Quick Start

Sort all .cpp files in a directory:

python scripts/sort_includes.py <directory-path>

Preview changes without modifying files:

python scripts/sort_includes.py <directory-path> --dry-run

Sorting Rules

Includes are organized into 3 categories with blank lines between each group:

  1. Corresponding header - For file.cpp, file.h is placed first (prefers longest path if duplicates exist)
  2. System headers - Headers with angle brackets <> (sorted alphabetically)
  3. Local headers - Headers with double quotes "" (sorted alphabetically)

Conditional Compilation Blocks

#ifdef/#ifndef/#if defined blocks are treated as units:

  • Blocks participate in global sorting based on their first include
  • Headers inside each block are also sorted (system headers first, then local headers)
  • Block structure (#ifdef...#endif) is preserved
  • #elif and #else blocks are supported

Example

Before:

#include "common/rs_log.h"
#include "rs_trace.h"
#include <memory>
#ifdef RS_ENABLE_GPU
#include "feature/uifirst/rs_sub_thread_manager.h"
#include "feature/capture/rs_ui_capture_task_parallel.h"
#endif
#include "platform/common/rs_system_properties.h"

After:

#include "rs_trace.h"        // 1. Corresponding header (longest path preferred)

#include <memory>             // 2. System headers (alphabetical)

#include "common/rs_log.h"    // 3. Local headers (alphabetical)
#ifdef RS_ENABLE_GPU
#include "feature/capture/rs_ui_capture_task_parallel.h"
#include "feature/uifirst/rs_sub_thread_manager.h"
#endif
#include "platform/common/rs_system_properties.h"

Features

  • Duplicate include handling: When multiple includes with same filename but different paths exist (e.g., "file.h" and "path/to/file.h"), the longest path is used as the corresponding header and placed first
  • Comment preservation: Inline comments (// comment) and preceding comments are preserved
  • Nested conditional blocks: Handles #elif and #else within #ifdef blocks
  • Validation: Verifies no headers are lost during sorting

Script Reference

See scripts/sort_includes.py for implementation details.

Key functions:

  • extractincludeswith_ifdef() - Parses includes and conditional blocks
  • sortincludeswith_ifdef() - Sorts with 3-category rule
  • formatifdefblock() - Formats conditional blocks with sorted includes

Verification

After sorting, verify:

  1. All #ifdef blocks contain same number of headers as before
  2. Corresponding header has complete path (not shortened)
  3. Total include count unchanged
  4. Comments preserved

Use git diff to compare before/after:

git diff <file.cpp> | grep "^[-+]" | grep "include"