←Leaderboard/Code Quality/smell-check
Last commit on August 29, 2026·Created on January 17, 2026

Zhen-Bo/smell-check

“A smell-first audit tool for diagnosing maintainability warnings and technical debt.”
Combined rank
#686
across all skills
In Code Quality
#37
category rank
Stars
239
+0.8% in last 7d
Forks
18
0.0% in last 7d
Watchers
0
0 watchers in last 7d
Traction scoreGitHub stars can be faked, so popularity alone can be misleading. Traction Score looks for broader signs of recent attention, adoption, and active maintenance.
TL;DR

Smell-check conducts structured audits of selected code paths to identify code and test smells. By measuring structure metrics and applying size profiles, it provides findings with evidence strength to help technical leads and architects diagnose maintainability issues without altering the subject code.

The tool focuses on identifying patterns with known cleanup moves rather than searching for bugs. It separates the diagnosis of technical debt from the implementation of fixes, leaving the final judgment and strategy to the codebase owner.

WHO IT'S FOR
Technical leads / architects
conducting maintainability audits and tech debt scans
QA / test automation engineers
identifying test smells and improving test suite health
Platform / DevEx teams
establishing codebase quality baselines and size profiles
AI agent / automation builders
integrating static analysis audits into AI workflows
Repository contents

1 skill file

Compatible AgentsThe repository documents support for these agents. The skills may also work with other agents that can load SKILL.md files, but they may need some setup or small changes.

Use this skill

Follow the documented setup, then try a first task.

Install smell-check with the skills CLI

Installs: Complete Zhen-Bo/smell-check skill bundle · AI coding agents

Before you start
  • git
  • wc
  • Python 3
  • An environment capable of running the documented npx command
  1. In a terminal, run the documented installation command.

    npx skills add Zhen-Bo/smell-check
README.md ↗ · Checked Sep 29, 2026docs/README.zh-TW.md ↗ · Checked Sep 29, 2026

Give it something to do.

Suggested first task

Audit a small code path for maintainability smells

Uses smell-check

  • A git repository containing the code to inspect
  • A small, explicit path or glob replacing `[path-to-source-directory]`
  • git, wc, and Python 3
Use the smell-check skill to audit `[path-to-source-directory]` for code smells and test smells. Treat `[path-to-source-directory]` as a placeholder that I will replace with a small repository path such as `src/`. Use the default or automatically selected size profile, perform the documented static audit only, and report the generated index.html path when validation is complete.
SKILL.md ↗ · Checked Sep 29, 2026README.md ↗ · Checked Sep 29, 2026