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.
How do I install this agent skill?
npx skills add https://github.com/openharmonyinsight/openharmony-skills --skill code-checkerIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The code-checker skill is a static analysis utility for C/C++ projects that identifies large files, oversized functions, and circular dependencies. The skill operates locally using Python scripts to parse source code and generates markdown reports. No malicious patterns, network exfiltration, or dangerous command execution were detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
5/5 files flagged
What does this agent skill do?
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/andinclude/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
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/openharmonyinsight/openharmony-skills/code-checker">View code-checker on skillZs</a>