Agent skill

Code Quality Gate Checker

Checks cyclomatic complexity, function and file length, parameter count, nesting depth and naming conventions against fixed thresholds, with a bundled Node.js script and hotspot integration.

MITAuto-check: notesDevelopment

SKILL.md written in Chinese; this summary is our English description.

Install Code Quality Gate Checker

skills CLI

$ npx skills add telagod/code-abyss --skill checking-code-quality -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install telagod/code-abyss checking-code-quality --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/telagod/code-abyss.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/checking-code-quality .claude/skills/checking-code-quality && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "checking-code-quality" agent skill from https://github.com/telagod/code-abyss/tree/main/skills/checking-code-quality into .claude/skills/checking-code-quality/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "checking-code-quality", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/telagod/code-abyss/tree/main/skills/checking-code-quality

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add telagod/code-abyss --skill checking-code-quality -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install telagod/code-abyss checking-code-quality --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/telagod/code-abyss.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/checking-code-quality .agents/skills/checking-code-quality && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "checking-code-quality" agent skill from https://github.com/telagod/code-abyss/tree/main/skills/checking-code-quality into .agents/skills/checking-code-quality/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "checking-code-quality", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add telagod/code-abyss --skill checking-code-quality -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install telagod/code-abyss checking-code-quality --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/telagod/code-abyss.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/checking-code-quality .cursor/skills/checking-code-quality && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "checking-code-quality" agent skill from https://github.com/telagod/code-abyss/tree/main/skills/checking-code-quality into .cursor/skills/checking-code-quality/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "checking-code-quality", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/telagod/code-abyss.git --path skills/checking-code-quality

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add telagod/code-abyss --skill checking-code-quality -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install telagod/code-abyss checking-code-quality --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/telagod/code-abyss.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/checking-code-quality .gemini/skills/checking-code-quality && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "checking-code-quality" agent skill from https://github.com/telagod/code-abyss/tree/main/skills/checking-code-quality into .gemini/skills/checking-code-quality/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "checking-code-quality", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install telagod/code-abyss checking-code-quality

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add telagod/code-abyss --skill checking-code-quality -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/telagod/code-abyss.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/checking-code-quality .github/skills/checking-code-quality && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "checking-code-quality" agent skill from https://github.com/telagod/code-abyss/tree/main/skills/checking-code-quality into .github/skills/checking-code-quality/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "checking-code-quality", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add telagod/code-abyss --skill checking-code-quality -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install telagod/code-abyss checking-code-quality --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/telagod/code-abyss.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/checking-code-quality .opencode/skills/checking-code-quality && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "checking-code-quality" agent skill from https://github.com/telagod/code-abyss/tree/main/skills/checking-code-quality into .opencode/skills/checking-code-quality/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "checking-code-quality", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: checking-code-quality
GitHub stars: 244
Token cost: ~609 tokens
SKILL.md length: 140 words
Files: 3 (incl. scripts)
Skills in repo: 38
Repo updated: Jul 19, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Checks cyclomatic complexity, function and file length, parameter count, nesting depth and naming conventions against fixed thresholds, with a bundled Node.js script and hotspot integration.

Running a quality gate after finishing a refactor
SKILL.md covers 何时使用, abyss 集成, 阈值与处置 and 代码异味, plus 5 more sections
Runs JavaScript scripts from its folder; calls node
Reviewing a complex new module for readability problems early

What it does

This skill, written in Chinese, treats its thresholds as heuristics rather than verdicts, asking the agent to judge which violations are worth splitting and which represent reasonable complexity. It runs after a refactor to confirm the split worked and introduced no new smells, when a complex module is added, before a commit larger than 30 changed lines, and during PR review as an objective measure in place of subjective argument; it is skipped during an urgent fix and only loosely applied on an algorithmic or performance-critical path.

Thresholds cover cyclomatic complexity at 10, function length at 50 lines, file length at 500 lines, parameter count at 5, nesting depth at 4 and line length at 120, each paired with a suggested fix such as extracting a sub-function or wrapping parameters in an object, and each with named exceptions like finite-state machines, generated code or long string literals. A code-smell table rates duplicated code over 10 lines as high severity, magic numbers and excess parameters as medium, and dead code as low, and a naming table fixes PascalCase for classes with snake_case or camelCase for functions depending on the language.

When a separate abyss tool is available, the skill pulls hotspot data to flag files with a hotspot score over 10000 for priority splitting, and the skill's own quality_checker.js script, runnable with a verbose or JSON flag, is the final arbiter: any threshold violation left in place must be explained in DESIGN.md rather than silently ignored. A hard rule blocks refactoring when tests are not already green.

When your agent uses it

Running a quality gate after finishing a refactor
Reviewing a complex new module for readability problems early
Checking a pull request's code quality with objective metrics instead of opinion
Deciding whether a flagged complexity violation is acceptable or needs splitting

Example prompts

“Run the quality checker on src/payments and tell me which functions exceed the complexity threshold.”
“Check this file for nesting depth and parameter count violations before I open the PR.”
“We just refactored the checkout flow. Verify no new code smells were introduced.”
“This function trips the length threshold but it's a state machine. Is that an acceptable exception?”

Requirements

Node.js 18 or later to run the bundled quality_checker.js script
Optionally the abyss hotspot tool for churn and coupling data
Compatibility (from SKILL.md): node>=18
Pre-approved tools (allowed-tools): Bash, Read, Glob

What it can do on your machine

Read from SKILL.md and the folder at commit 2544577. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
- Bash
- Read
- Glob
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 1 file in scripts/ (JavaScript), which the agent can run.
Shell commands in SKILL.md call:
- node
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Compatibility
node>=18
From compatibility in the SKILL.md frontmatter.

Context cost

Code Quality Gate Checker loads about 609 tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 140 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~66
When it runs · the whole SKILL.md, loaded when a task matches: ~609

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
```
allowed-tools: Bash, Read, Glob
```

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from telagod/code-abyss at commit 2544577, republished under its MIT licence (© telagod). 140 words, ~609 tokens.

Download SKILL.mdSave it as .claude/skills/checking-code-quality/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.

name: checking-code-quality
description: Checks code quality metrics including complexity, duplication, naming conventions, and function length. Use when running quality gates, reviewing code smells, or checking lint rules. Automatically triggered on complex modules or post-refactor.
allowed-tools: Bash, Read, Glob
compatibility: node>=18
user-invocable: false
argument-hint: <扫描路径>

代码质量校验关卡

阈值是 heuristic，不是判决。主动判断哪些超标值得拆，哪些是合理复杂度。

何时使用

场景	跑	判据
重构完成	✅	验证拆分有效，未引入新异味
复杂模块新增	✅	早期发现可读性问题
提交前（>30 行变更）	✅	防腐烂
PR review	✅	客观度量替代主观争论
紧急修复	❌	优先稳定，质量在收口阶段补
算法/性能关键路径	⚠	工具阈值不适用，按性能基准判断

abyss 集成

如果 abyss 可用，质量检查时额外使用 hotspot 数据：

bash

abyss map --json  # 获取热点文件列表

hotspot_score > 10000 的文件：标记为「高风险热点」，优先拆分
change_count > 20 且 complexity > 100：建议拆分为更小的文件/函数
coupling_score > 80%：提醒耦合文件需要同步审查

阈值与处置

指标	阈值	超标处置	何时容忍
圈复杂度	≤10	拆分函数、引入策略模式	有限状态机/解析器（结构性复杂）
函数长度	≤50 行	提取子函数	配置/常量声明、大型 switch
文件长度	≤500 行	拆分模块	自动生成代码、protobuf
参数数量	≤5	封装参数对象	构造函数（builder 模式更佳）
嵌套深度	≤4	早返回、提取函数、查表	罕见情况下的状态机
行长度	≤120	换行	长字符串字面量、SQL

例外说明：bin/ 下带 Node shebang 的 CLI 入口按命令编排层处理，不参与文件长度阈值；其业务逻辑仍应优先下沉到 bin/lib/。

代码异味

异味	严重度	处置
重复代码 >10 行	High	提取公共函数；判断是否真重复（结构相似但语义不同时不要强抽）
参数 >5 个	Medium	封装参数对象
魔法数字	Medium	提取常量；常见数（0, 1, 2）可豁免
死代码/注释代码块	Low	删除；用 git history 追溯，不要靠注释保留

命名规范

实体	规则
类	PascalCase
函数	snake_case (Python/Rust) / camelCase (JS/TS/Go)
常量	UPPER_SNAKE
变量	snake_case / camelCase（按语言）

跨语言项目按主语言定，不混搭。

判断式重构

python

# 深嵌套 → 早返回
def process(data):
    if not c1: return
    if not c2: return
    # 主逻辑

# 重复 → 提取
def common(): ...
def f1(): common()
def f2(): common()

重构红线：测试不绿不重构。先把测试补齐，才有改动的安全网。

与其他 skill 联动

重构后 → 同步跑 analyzing-changes（看影响面）+ analyzing-security（防退化）
复杂度爆炸时 → 看是否需要 designing-architectures 的拆分模式

使用

bash

node scripts/quality_checker.js <路径>
node scripts/quality_checker.js <路径> -v       # 详细
node scripts/quality_checker.js <路径> --json   # CI 用

收口

报告以 quality_checker.js 实际输出为准。超标项要么修复，要么在 DESIGN.md 留「为何接受」的说明。不允许悄悄忽略。

Files

SKILL.md and 2 other files (scripts) in skills/checking-code-quality of telagod/code-abyss.

SKILL.md
agents/openai.yaml
scripts/quality_checker.js

Open the folder on GitHubat commit 2544577

Compare with similar skills

Code Quality Gate Checker next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Code Quality Gate Checker compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Code Quality Gate Checker this skilltelagod/code-abyss	244	—	~609	Automated safety check: Notes	MIT	2 mo ago
Sonarclaudeagentculture/culture	113	—	~764	Automated safety check: Pass	Apache-2.0	1 mo ago
Qe Quality Assessmentproffesor-for-testing/agentic-qe	494	—	~1.9k	Automated safety check: Pass	MIT	3 days ago
Systematic Code Refactoringluongnv89/claude-howto	42k	—	~3k	Automated safety check: Pass	MIT	7 days ago
Constraint-Driven Developmentaddyosmani/agent-skills	102k	2 repos	~5.2k	Automated safety check: Pass	MIT	4 days ago
Dignified Python Standardsdocling-project/docling	68k	—	~1.5k	Automated safety check: Pass	Apache-2.0	yesterday

Similar skills

Sonarclaude
agentculture/culture
Query SonarCloud API for code quality data. An agent skill from agentculture/culture.
113 GitHub stars~764 tokensUpdated 1 mo ago
DevelopmentAuto-check passed
Qe Quality Assessment
proffesor-for-testing/agentic-qe
Evaluates code quality through complexity analysis, lint results, code smell detection, and test health metrics.
494 GitHub stars~1.9k tokensUpdated 3 days ago
DevelopmentAuto-check passed
Systematic Code Refactoring
luongnv89/claude-howto
Guides refactoring in phases based on Martin Fowler's method: research, test coverage check, planning and small tested steps, with your approval at each phase.
42k GitHub stars~3k tokensUpdated 7 days ago
DevelopmentAuto-check passed
Constraint-Driven Development
addyosmani/agent-skills
Records a project's quality bar in CONSTRAINTS.md and watches diffs for signs an agent quietly weakened it, such as suppressions, skipped tests or lowered thresholds.
102k GitHub starsUsed in 2 repos~5.2k tokens
DevelopmentAuto-check passed
Dignified Python Standards
docling-project/docling
Applies opinionated production Python conventions chosen by the project's Python version: modern type syntax, pathlib, explicit checks and interface guidance.
68k GitHub stars~1.5k tokensUpdated yesterday
DevelopmentAuto-check passed
Clean Code Guard
amElnagdy/guard-skills
Reviews generated or changed production code against Clean Code, SOLID, DRY, KISS, YAGNI and LLM-specific failure modes before it ships, in any language.
1.3k GitHub starsUsed in 2 repos~4.3k tokens
DevelopmentAuto-check passed

Questions about Code Quality Gate Checker

What does Code Quality Gate Checker do?

Checks cyclomatic complexity, function and file length, parameter count, nesting depth and naming conventions against fixed thresholds, with a bundled Node.js script and hotspot integration. This skill, written in Chinese, treats its thresholds as heuristics rather than verdicts, asking the agent to judge which violations are worth splitting and which represent reasonable complexity. It runs after a refactor to confirm the split worked and introduced no new smells, when a complex module is added, before a commit larger than 30 changed lines, and during PR review as an objective measure in place of subjective argument; it is skipped during an urgent fix and only loosely applied on an algorithmic or performance-critical path.

When should I use Code Quality Gate Checker?

Code Quality Gate Checker fits situations like: running a quality gate after finishing a refactor; reviewing a complex new module for readability problems early; checking a pull request's code quality with objective metrics instead of opinion; deciding whether a flagged complexity violation is acceptable or needs splitting.

How do I install Code Quality Gate Checker in Claude Code?

Run `npx skills add telagod/code-abyss --skill checking-code-quality -a claude-code`. Or copy the skill folder (skills/checking-code-quality in telagod/code-abyss) into .claude/skills/checking-code-quality in your project. Claude Code loads it when a task matches its description.

How do I install Code Quality Gate Checker in Codex?

Run `npx skills add telagod/code-abyss --skill checking-code-quality -a codex`. Or copy the skill folder (skills/checking-code-quality in telagod/code-abyss) into .agents/skills/checking-code-quality in your project. Codex loads it when a task matches its description.

Can I use Code Quality Gate Checker in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add telagod/code-abyss --skill checking-code-quality -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/checking-code-quality, .gemini/skills/checking-code-quality, .github/skills/checking-code-quality and .opencode/skills/checking-code-quality in your project.

What does Code Quality Gate Checker need to run?

Going by SKILL.md and its folder, Code Quality Gate Checker needs JavaScript for the scripts in its folder and the command-line tools its instructions call (node). Our summary lists: Node.js 18 or later to run the bundled quality_checker.js script; Optionally the abyss hotspot tool for churn and coupling data. Its frontmatter pre-approves these tools: Bash, Read, Glob. Compatibility (from SKILL.md): node>=18.

Does Code Quality Gate Checker access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Code Quality Gate Checker safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Code Quality Gate Checker use?

Code Quality Gate Checker is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Code Quality Gate Checker use?

About 609 tokens (SKILL.md is roughly 2.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Code Quality Gate Checker?

Skills that share tags, products or a category with Code Quality Gate Checker: Sonarclaude (agentculture/culture, 113 stars), Qe Quality Assessment (proffesor-for-testing/agentic-qe, 494 stars), Systematic Code Refactoring (luongnv89/claude-howto, 42k stars) and Constraint-Driven Development (addyosmani/agent-skills, 102k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Code Quality Gate Checker?

telagod (a GitHub user) maintains it in telagod/code-abyss, which has 244 GitHub stars. The repository holds 38 skills in this directory. The repository was last updated on July 19, 2026.

Source: telagod/code-abyss on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Code Quality Gate Checker

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Compatibility

Context cost

Safety

SKILL.md

代码质量校验关卡

何时使用

abyss 集成

阈值与处置

代码异味

命名规范

判断式重构

与其他 skill 联动

使用

收口

Files

Compare with similar skills

Similar skills

More from telagod/code-abyss

Related

Questions about Code Quality Gate Checker