How do I install the Code Checker skill?

Run npx skillmds@latest add openharmonyinsight/code-checker in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Code Checker safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Code Checker?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Code Checker free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Code Checker?

openharmonyinsight (@openharmonyinsight) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Code Checker by openharmonyinsight — Agent Skill

Name: Code Checker
Author: openharmonyinsight

Code Checker

Scan C/C++ codebases for code quality issues including extra large files/functions and circular dependencies. Use when the user asks to check file sizes, find oversized functions, detect circular dependencies, analyze code complexity, find code smells, or identify maintainability issues in C/C++ code. Supports scanning individual files or entire directories with configurable thresholds.

openharmonyinsight fd478bc 5 files · 43.2 KB Updated Sep 17, 2026

File contents

C/C++ Code Checker

Analyzes C/C++ code for maintainability issues: extra large files/functions and circular dependencies between modules.

Workflow

Identify scan target - If the user doesn't specify a file or directory, ask: "Which directory or file should I scan?"
Determine check type - Ask or infer which checks to run:
- File/Function size analysis
- Circular dependency detection
- Both (default for full analysis)
Run the scan - Execute the appropriate script(s)
Present findings - Show the report and summarize key issues
Offer help - Ask if the user wants refactoring assistance

Size Analysis

Scan for extra large files and functions:

scripts/scan_cpp_size.py <path> [options]

Options:

-o, --output <file> - Write report to file
-f, --file-threshold <n> - Large file threshold (default: 2000 effective lines)
-F, --function-threshold <n> - Large function threshold (default: 50 effective lines)

Example:

scripts/scan_cpp_size.py ./src --file-threshold 1500 --function-threshold 40 -o size_report.md

Circular Dependency Detection

Detect circular dependencies between directory modules:

scripts/circular_header_check.py <path> [options]

Options:

-o, --output <file> - Write report to file
-v, --verbose - Verbose output
--no-gn - Skip GN build file parsing

Example:

scripts/circular_header_check.py ./src -o circular_report.md

The circular dependency checker:

Parses GN build files (BUILD.gn, *.gni) for include paths
Groups files by directory modules (handles src/ and include/ as one component)
Detects when module A includes files from module B, which includes A

After Finding Issues

When issues are found:

Prioritize by impact - Start with the largest issues first
Understand context - Read the code to understand responsibility
Ask the user - "Would you like help refactoring this?"

Refactoring Guidance

Issue Type	Reference
Large functions	references/refactoring.md
Circular dependencies	See references/circular-deps.md

What Counts as "Large"?

Category	Default Threshold	Rationale
Files	2000 effective lines	Hard to navigate, understand
Functions	50 effective lines	Beyond cognitive fit, hard to test

Effective lines exclude blank lines, comments, and preprocessor directives.

File Extensions Scanned

.c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++, .inl, .inc

---name: code-checkerdescription: Scan C/C++ codebases for code quality issues including extra large files/functions and circular dependencies. Use when the user asks to check file sizes, find oversized functions, detect circular dependencies, analyze code complexity, find code smells, or identify maintainability issues in C/C++ code. Supports scanning individual files or entire directories with configurable thresholds.---# C/C++ Code CheckerAnalyzes C/C++ code for maintainability issues: extra large files/functions and circular dependencies between modules.## Workflow1. **Identify scan target** - If the user doesn't specify a file or directory, ask: "Which directory or file should I scan?"2. **Determine check type** - Ask or infer which checks to run: - File/Function size analysis - Circular dependency detection - Both (default for full analysis)3. **Run the scan** - Execute the appropriate script(s)4. **Present findings** - Show the report and summarize key issues5. **Offer help** - Ask if the user wants refactoring assistance## Size AnalysisScan for extra large files and functions:```bashscripts/scan_cpp_size.py <path> [options]```**Options:**- `-o, --output <file>` - Write report to file- `-f, --file-threshold <n>` - Large file threshold (default: 2000 effective lines)- `-F, --function-threshold <n>` - Large function threshold (default: 50 effective lines)**Example:**```bashscripts/scan_cpp_size.py ./src --file-threshold 1500 --function-threshold 40 -o size_report.md```## Circular Dependency DetectionDetect circular dependencies between directory modules:```bashscripts/circular_header_check.py <path> [options]```**Options:**- `-o, --output <file>` - Write report to file- `-v, --verbose` - Verbose output- `--no-gn` - Skip GN build file parsing**Example:**```bashscripts/circular_header_check.py ./src -o circular_report.md```The circular dependency checker:- Parses GN build files (`BUILD.gn`, `*.gni`) for include paths- Groups files by directory modules (handles `src/` and `include/` as one component)- Detects when module A includes files from module B, which includes A## After Finding IssuesWhen issues are found:1. **Prioritize by impact** - Start with the largest issues first2. **Understand context** - Read the code to understand responsibility3. **Ask the user** - "Would you like help refactoring this?"## Refactoring Guidance| Issue Type | Reference ||------------|-----------|| Large functions | [references/refactoring.md](references/refactoring.md) || Circular dependencies | See [references/circular-deps.md](references/circular-deps.md) |## What Counts as "Large"?| Category | Default Threshold | Rationale ||----------|-------------------|-----------|| Files | 2000 effective lines | Hard to navigate, understand || Functions | 50 effective lines | Beyond cognitive fit, hard to test |*Effective lines* exclude blank lines, comments, and preprocessor directives.## File Extensions Scanned`.c`, `.cpp`, `.cc`, `.cxx`, `.c++`, `.h`, `.hpp`, `.hh`, `.hxx`, `.h++`, `.inl`, `.inc`

Frequently asked questions