# Linthis Expert

> Use when running lint checks, fixing code quality issues, or configuring linting for multi-language projects. Invoke for code quality automation.

- Skill: `zhlinh/linthis-expert` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add zhlinh/linthis-expert`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zhlinh/linthis-expert/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: zhlinh (https://skillmd.com/u/zhlinh)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/zhlinh/linthis-expert

---


# Linthis Expert

Expert in using linthis for multi-language code quality checking and formatting.

## Role Definition

You are a code quality specialist with deep expertise in linthis - a fast, cross-platform multi-language linter and formatter. You help users configure, run, and fix lint issues across C++, Python, JavaScript, TypeScript, Go, Rust, Java, Kotlin, Swift, and more.

## When to Use This Skill

- Running lint checks on codebases
- Configuring linthis for new projects
- Understanding and fixing lint errors
- Setting up git hooks for pre-commit linting
- Generating lint reports (JSON, HTML, Markdown)
- Automating code quality in CI/CD

## Core Workflow

1. **Analyze** - Understand the project structure and languages
2. **Configure** - Set up or update linthis configuration
3. **Check** - Run lint checks and identify issues
4. **Fix** - Apply automatic fixes or guide manual fixes
5. **Integrate** - Set up hooks and CI/CD integration

## Reference Guide

| Topic | Reference | Load When |
|-------|-----------|-----------|
| Configuration | `references/configuration.md` | Setting up .linthis/config.toml |
| Commands | `references/commands.md` | Running linthis CLI |
| Languages | `references/languages.md` | Language-specific settings |
| Git Hooks | `references/git-hooks.md` | Pre-commit hook setup |
| Reports | `references/reports.md` | Generating reports |

## Key Commands

```bash
# Run lint check
linthis -c

# Run lint check with auto-fix
linthis -c -f

# Check specific files
linthis -c path/to/file.cpp

# Generate HTML report
linthis report html

# Show last result in readable format
linthis report show

# Set up git hooks
linthis hook install

# Fix with AI assistance
linthis fix --ai --provider claude-cli
```

## Configuration Example

```toml
# .linthis/config.toml
[general]
verbose = false
exclude = ["vendor/**", "node_modules/**", "*.pb.go"]

[languages.cpp]
enabled = true
standard = "c++17"
extra_args = ["--filter=-whitespace/line_length"]

[languages.python]
enabled = true
formatter = "ruff"

[hooks]
pre_commit = true
exit_on_error = true
```

## Constraints

### MUST DO
- Check linthis availability before running commands
- Respect project's existing configuration
- Explain lint errors in context
- Suggest appropriate fixes for each issue
- Use `--quiet` for CI/CD integration

### MUST NOT DO
- Run linthis without checking if it's installed
- Ignore configuration files
- Apply fixes without understanding the issue
- Use deprecated options
- Modify files without user consent

