CachiBot: Skill for Claude Code

Lint Fix — Full Project Lint & Type Sweep

Run every linter the project uses, collect all violations, and fix them in a single pass. Handles Python (ruff + mypy) and TypeScript (eslint) together.

Instructions

Phase 0 — Run All Linters

Run all four checks in parallel and collect their output:

1. ruff check cachibot/ — lint errors (E501, F841, etc.)
2. ruff format --check cachibot/ — formatting drift
3. mypy cachibot/ — type errors (only in cachibot/, NOT transitive errors from prompture or other installed packages)
4. cd frontend && npx eslint src/ — TypeScript lint (errors only, warnings are informational)

Parse each tool's output into a list of { tool, file, line, code, message } findings.

Important: When parsing mypy output, discard any finding whose file path is outside cachibot/ (e.g., errors in installed packages like prompture). Also discard import-not-found errors for prompture.* and tukuy.* modules — those are expected when the editable installs are out of sync and are not CachiBot bugs.

If zero findings remain after filtering, tell the user everything is clean and stop.

Phase 1 — Auto-Fix What Tools Can

Run the auto-fixers first to knock out the easy ones:

1. ruff check --fix cachibot/ — auto-fix simple lint issues
2. ruff format cachibot/ — reformat any drifted files
3. cd frontend && npx eslint src/ --fix — auto-fix simple TS issues

Phase 2 — Fix Remaining Violations

Re-run the linters from Phase 0 to see what remains after auto-fix.

For each remaining finding, apply the appropriate fix strategy:

ruff E501 (line too long)

• If the long line is a string literal inside a dict/list, wrap it with implicit string concatenation using parentheses:

  "description": (
      "First part of the string"
      " second part of the string"
  ),
  

• If the long line is a function call or dict literal, break it into multi-line format.
• If the long line is an import, use multi-line import with parentheses.
• Never shorten user-facing strings by removing words — prefer wrapping.