plugins/code-quality/skills/ruff-check/SKILL.md
Lints and formats all Python files in the project using Ruff. Activates when the user asks to "lint my Python", "fix Python code style", "run ruff", "format my Python files", "check Python quality", or "fix linting errors". Installs Ruff if not present, auto-fixes resolvable issues, and reports remaining violations.
npx skillsauth add talent-factory/claude-plugins ruff-checkInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Lint and auto-format all Python files in the project using Ruff — the fast, all-in-one Python linter and formatter that replaces flake8, isort, and black.
# Preferred: uv dev dependency
uv add --dev ruff 2>/dev/null || \
# Fallback: pip
pip install ruff
ruff check .
Report the number of violations found and their categories.
ruff check --fix .
ruff format .
ruff check . && ruff format --check .
Report outcome:
✓ No violations — all files clean.| Flag | Purpose |
|---|---|
| ruff check --select E,W | Errors and warnings only |
| ruff check --fix --unsafe-fixes | Apply unsafe fixes as well |
| ruff format --diff | Preview formatting changes without applying |
| ruff check --statistics | Show count per rule |
For each violation that could not be auto-fixed:
documentation
Creates comprehensive handoff documentation before a /compact operation, enabling a new agent with fresh context to seamlessly continue the work. Activate when the user says "prepare a handoff", "document before compact", "context is getting too large", "I need to hand this off", "create a handoff document", "end of session notes", or "document the current state for tomorrow". Supports --output and --linear-issue options.
documentation
Collects completed tasks, GitHub activity, calendar meetings, wiki learnings, and Linear progress for the past week, then writes a structured retrospective to the Obsidian vault. Activate when the user runs "/weekly-review", asks "what did I accomplish this week", "weekly retrospective", "summarise my week", or "prepare weekly review". Works from any directory.
development
Produces a prioritised daily briefing by aggregating tasks from Obsidian TaskNotes, Google Calendar, Gmail, Linear, and GitHub, then writes the result to today's daily note in the Obsidian vault. Activate when the user runs "/today", asks "what's on my plate today", "give me my daily briefing", "what do I need to do today", or "morning briefing". Works from any directory without requiring Obsidian to be running.
tools
Provides a quick status snapshot of all GitHub repositories in a configured organisation — active, dormant, stalled — plus open pull requests and issues. Terminal output only, optimised for speed. Activate when the user runs "/project-pulse", asks "what is the status of my GitHub projects", "show me my repos", "which projects are active", "project overview", "GitHub pulse", or "what is happening in [org]". Works from any directory.