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

# 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

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

# If working in apollos-ui
.claude/skills/lint-service/lint-typescript.sh apollos-ui --staged-only

Check if linting will pass before committing

# 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:

cd apollos-ui
pnpm lint:fix

Python:

cd mercury-clustering
uv run ruff check --fix .
uv run ruff format .

Rust:

cd flora-clustering-rust
cargo fmt --all
cargo clippy --all-targets --all-features --fix