| name | linter |
| description | Run code quality checks including linting, type checking, dead code detection, duplication, and complexity analysis. |
| triggers | ["*qa lint","*qa quality","*qa check"] |
One-line summary: Runs Python code quality checks — style, types, dead code, complexity, and duplication.
TLDR:
Use make lint (if available) or activate .venv and run pylint, mypy, vulture, and radon directly.
Triggered by Trin via *qa lint, *qa quality, or *qa check; run the full suite before any PR.
Fix priority: errors first, then warnings, then style; refactor functions graded C or worse by radon.
Linter Skill
Overview
This skill provides code quality analysis tools for Python projects. Use these commands to catch issues before they become problems.
Quick Reference
| Check | Command |
|---|
| All quality checks | make lint (if available) |
| Style (PEP-8) | source .venv/bin/activate && pylint via/ |
| Type checking | source .venv/bin/activate && mypy via/ |
| Dead code | source .venv/bin/activate && vulture via/ |
| Complexity | source .venv/bin/activate && radon cc via/ -a |
| Duplication | source .venv/bin/activate && pylint --disable=all --enable=duplicate-code via/ |
Commands
Style & Conventions (pylint)
source .venv/bin/activate && pylint via/
Checks PEP-8 compliance, code smells, and common errors.
Common flags:
--disable=C0114,C0115,C0116 - Disable missing docstring warnings--fail-under=8 - Fail if score below 8/10-r n - No full report, just issues
Type Checking (mypy)
source .venv/bin/activate && mypy via/
Static type analysis using type hints.
Common flags:
--strict - Enable all strict checks--ignore-missing-imports - Skip untyped dependencies
Dead Code Detection (vulture)
source .venv/bin/activate && vulture via/
Finds unused code (functions, variables, imports).
Common flags:
--min-confidence 80 - Only report high-confidence dead code--exclude "tests/" - Exclude test directory
Complexity Analysis (radon)
source .venv/bin/activate && radon cc via/ -a -s
source .venv/bin/activate && radon mi via/ -s
Complexity grades:
- A (1-5): Low - simple
- B (6-10): Low - well structured
- C (11-20): Moderate - slightly complex
- D (21-30): More than moderate - more complex
- E (31-40): High - complex, alarming
- F (41+): Very high - error-prone, unstable
Duplication Detection
source .venv/bin/activate && pylint --disable=all --enable=duplicate-code via/
Installation
If tools are missing, install them:
source .venv/bin/activate && pip install pylint mypy vulture radon
Workflow
- Before PR: Run full lint suite
- On failure: Fix issues by priority (errors > warnings > style)
- Complexity: Refactor functions with grade C or worse
- Dead code: Remove or mark as
# vulture: ignore
Integration with Trin
Trin uses this skill for:
*qa lint - Run pylint on changed files*qa quality - Full quality report*qa check - Pre-commit quality gate
