YuanyuanMa03/cot-lint
Chain-of-thought leakage linter: zero-dependency CLI that finds AI-session residue in docs and comments (dead design citations, PR vantage, change narration, review choreography), shipping the cot-trim fixing skill as the installable bundle.
Lints a repository for chain-of-thought leakage — the session-transcript residue AI assistants leave in docs, comments and JSDoc. The README reduces the rule to one test: could a reader at HEAD, with no access to any session transcript, PR thread or uncommitted draft, resolve every reference and verify every claim? Detected classes include dead design-session citations, stack/PR vantage, change narration and version stamps, review choreography, reviewer-addressed justification, control-flow narration, hedge/planning residue and authoring-language slips, with English and Chinese batteries built in. The README stresses that the keep-rules are half the tool: issue references and marked TODO/FIXME/XXX deferrals, §-references on lines citing an external standard, and cot-lint-ignore lines are mechanically exempt, and every finding is a candidate rather than a verdict. The repo also ships the cot-trim agent skill that runs the linter in JSON mode and judges each hit against the same test.
Install
dsh plugin add cot-lintREADME Quick start (DeepSeek Harness) quoted verbatim, then the README's alternative form github:YuanyuanMa03/cot-lint; the cot-trim skill loads through the plugin's skill provider. Registry-verified live 2026-09-15: cot-lint 0.2.1 (published 2026-08-15) with a matching repository field (github.com/YuanyuanMa03/cot-lint). Standalone CLI use is separate and needs no install: npx cot-lint, with --json, --ext ts,py and --hidden flags, zero dependencies and Node >= 20; exit codes are 0 clean / 1 findings / 2 usage error.
Compatibility
CLI requires Node >= 20 and has zero dependencies, so it drops straight into CI. The DSH path installs the cot-trim fixing skill as a plugin; for Claude Code or other agent hosts the README says to copy skills/cot-trim/ into your skills directory instead.
Details
- Repo: YuanyuanMa03/cot-lint
- Category: Skills
- Stars: 2
- Version: npm cot-lint 0.2.1 (registry-verified 2026-09-15)
- Last push: 2026-08-15
- First seen: 2026-08-15
Recent updates
The README documents the rule taxonomy, keep-rules and the paired skill rather than a release table; the registry version when checked on 2026-09-15 was 0.2.1.
FAQ
- How is this different from an AI-slop style linter?
- The README says style detectors flag prose that sounds like AI, while cot-lint flags prose whose vantage is the authoring session — references and narration that only make sense if you were there.
- Will it delete load-bearing comments?
- The README describes findings as candidates, not verdicts, and lists explicit keep-rules: issue references, marked TODO/FIXME/XXX deferrals, §-references to external standards and cot-lint-ignore lines are exempt.
- Does it work for Chinese repos?
- Yes — the README states English and Chinese batteries are both built in, and one detected class is untranslated working-language fragments.
Alternatives
AKS1st/dsh-skill-manager · Cavan-Ou/hermes-dsh-collab · Fectivnfy112357/github-explore