fastapi-precommit

Solid

Use when reviewing a staged diff or an about-to-commit/push change for last-mile issues — silent failures, leaked secrets, debug leftovers, blatant correctness landmines, and excessive/narrating comments. Reports findings on the changed lines only; it does not refactor or rewrite code. This is the canonical source for the Klaussy desktop pre-commit gate, which inlines the diff and adds its own machine-readable output contract.

Code & Development 11 stars 0 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 79/100

Stars 20%
36
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

Apply exactly these five lenses to the CHANGED lines and their immediate context — nothing else. If no diff is inlined for you, read the staged change with `git diff --cached` first. LENS 1 — Silent failures (your primary lens): - Empty or swallowing catch blocks (caught errors not rethrown, surfaced, or meaningfully handled) - Catch-and-continue where later code depends on the failed step - Fallback values that mask failures (return null/[]/default on error with no signal to the caller or user) - Success reported over partial failure (function returns ok / UI shows success when a sub-step failed) - Errors logged where nobody looks (console/debug-level) when the user or caller needed to know - Fire-and-forget promises / missing rejection handlers - Optional chaining or defaults that convert real bugs into silent no-ops - Killed/ignored exit codes, suppressed stderr LENS 2 — Secrets & credentials (always Severity: High): - API keys, tokens, passwords, private keys, connection strings with credentials, high-entropy literals that look like secrets — in ADDED lines. Placeholder values that are obviously fake (e.g. "YOUR_API_KEY", "xxx") are NOT findings. LENS 3 — Debug leftovers (Severity: Low): - Added print-debugging (console.log/print/dbg!) that is clearly scaffolding rather than intentional logging per this repo's conventions - Newly commented-out blocks of code - Added TODO/FIXME/HACK markers with no ticket reference LENS 4 — Blatant correctness landmines (Severity: High...

Details

Author
steph-dove
Repository
steph-dove/klaussy-agents
Created
4 months ago
Last Updated
yesterday
Language
Python
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category