skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
openharmonyinsight/openharmony-skills104 installs

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-checker
view source ↗

Is 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

  1. 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 issues
  5. 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:

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

Refactoring Guidance

Issue TypeReference
Large functionsreferences/refactoring.md
Circular dependenciesSee references/circular-deps.md

What Counts as "Large"?

CategoryDefault ThresholdRationale
Files2000 effective linesHard to navigate, understand
Functions50 effective linesBeyond 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

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>