# Lint Service

> Unified linting scripts for all services in the monorepo. Use when the user wants to lint code, check formatting, or run type checks. Use when this capability is needed.

- Skill: `tomevault-io/lint-service` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/lint-service`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/lint-service/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/lint-service

---


# Lint Service Skill

Unified linting scripts for all services in the Saturn's Oracle monorepo.

## Services

### TypeScript (2 services)
- apollos-ui
- polling-service

### Python (3 services)
- mercury-clustering
- terra-local-gpu
- apollo-video-distillation

### Rust (3 services)
- flora-clustering-rust
- hercules-local-algo
- vulcan-gpu-sdk (also has Python)

## Usage

### From Anywhere in the Repo

```bash
# TypeScript
.claude/skills/lint-service/lint-typescript.sh apollos-ui
.claude/skills/lint-service/lint-typescript.sh apollos-ui --staged-only

# Python
.claude/skills/lint-service/lint-python.sh mercury-clustering
.claude/skills/lint-service/lint-python.sh terra-local-gpu --staged-only

# Rust
.claude/skills/lint-service/lint-rust.sh flora-clustering-rust
.claude/skills/lint-service/lint-rust.sh hercules-local-algo --staged-only
```

### What Each Script Does

**lint-typescript.sh:**
- ESLint with --max-warnings=-1 (errors only)
- TypeScript type checking (tsc --noEmit)
- Staged-only: Lints only staged .ts/.tsx files

**lint-python.sh:**
- Ruff check (linting)
- Ruff format --check (formatting)
- mypy (type checking, full mode only)
- Staged-only: Lints only staged .py files

**lint-rust.sh:**
- cargo clippy (linting)
- cargo fmt --check (formatting)
- cargo test (only in CI, not precommit)
- Staged-only: Skips if no .rs files staged

## Exit Codes

- 0: Success
- 1: Linting failed (blocking)

## Integration

These scripts are called by:
1. **Precommit hook** (.husky/pre-commit) with --staged-only
2. **GitHub Actions** (without --staged-only, full service)
3. **Manual invocation** by developers or Claude

## Examples

### Lint all Python services
```bash
for service in mercury-clustering terra-local-gpu apollo-video-distillation; do
  .claude/skills/lint-service/lint-python.sh $service
done
```

### Lint only staged files in current service
```bash
# If working in apollos-ui
.claude/skills/lint-service/lint-typescript.sh apollos-ui --staged-only
```

### Check if linting will pass before committing
```bash
# TypeScript
.claude/skills/lint-service/lint-typescript.sh apollos-ui --staged-only

# Python
.claude/skills/lint-service/lint-python.sh mercury-clustering --staged-only

# Rust
.claude/skills/lint-service/lint-rust.sh flora-clustering-rust --staged-only
```

## Linting Config Location

All services extend root configs:
- **Python**: `/pyproject.toml` (ruff + mypy)
- **Rust**: `/rustfmt.toml` + `/.clippy.toml`
- **TypeScript**: `/.eslintrc.monorepo.js`

Services can override with local configs if needed.

## Auto-fix Commands

If linting fails, use these commands to auto-fix:

**TypeScript:**
```bash
cd apollos-ui
pnpm lint:fix
```

**Python:**
```bash
cd mercury-clustering
uv run ruff check --fix .
uv run ruff format .
```

**Rust:**
```bash
cd flora-clustering-rust
cargo fmt --all
cargo clippy --all-targets --all-features --fix
```

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/gar-ai) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->