# Code Quality

> Fix lint errors, format code, run type checking, check code quality. Use when fixing linting issues, formatting Python, running ruff, running ty, checking TypeScript types, or ensuring code quality. Use when this capability is needed.

- Skill: `tomevault-io/code-quality-24` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/code-quality-24`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/code-quality-24/raw
- Safety review: pending
- 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/code-quality-24

---


# Code Quality

Handles all code quality tasks for the CCBell Sound Generator project including linting, formatting, and type checking.

## Project Stack

- **Backend (Python)**: FastAPI with ruff for linting/formatting and ty for type checking
- **Frontend (TypeScript)**: React 19 with ESLint and TypeScript compiler

## Available Commands

### Backend Linting (ruff)
```bash
cd backend && source venv/bin/activate && ruff check .
```

To auto-fix issues:
```bash
cd backend && source venv/bin/activate && ruff check --fix .
```

### Backend Formatting (ruff)
Check formatting:
```bash
cd backend && source venv/bin/activate && ruff format --check .
```

Apply formatting:
```bash
cd backend && source venv/bin/activate && ruff format .
```

### Backend Type Checking (ty)
```bash
cd backend && source venv/bin/activate && ty check .
```

### Frontend Linting (ESLint)
```bash
cd frontend && npm run lint
```

To auto-fix:
```bash
cd frontend && npm run lint -- --fix
```

### Frontend Type Checking (TypeScript)
```bash
cd frontend && npx tsc --noEmit
```

## Full Quality Check

Run all checks in sequence:
```bash
cd backend && source venv/bin/activate && ruff check . && ruff format --check . && ty check .
cd frontend && npm run lint && npx tsc --noEmit
```

## Important Notes

- Virtual environment is at `backend/venv` (created by `uv sync --group dev`)
- Backend uses ruff with 100 char line length and double quotes
- Always run quality checks before committing
- These checks are enforced in the CI pipeline

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