菜单
Migrate Python formatting from black to ruff-format. Use when psf/black is in .pre-commit-config.yaml or [tool.black] exists in pyproject.toml.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/laurigates/claude-plugins --skill black-to-ruff-format命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
Install, configure and troubleshoot MCP servers. Use when adding/enabling servers, editing .mcp.json, fixing OAuth, or when a server runs stale code after an upstream fix.
FinOps snapshot — org billing, workflow stats, cache usage. Use when you want a high-level view of CI spending or workflow health before diving deeper.
GitHub Actions billing, workflow efficiency, and waste analysis at org or repo level. Use when investigating CI/CD costs, wasted runs, or optimizing triggers.
正在显示 SKILL.md
基于 SOC 职业分类
| name | black-to-ruff-format |
| description | Migrate Python formatting from black to ruff-format. Use when psf/black is in .pre-commit-config.yaml or [tool.black] exists in pyproject.toml. |
| allowed-tools | Read, Write, Edit, Glob, Grep, Bash(find *), Bash(test *), Bash(pre-commit *), Bash(uvx *), AskUserQuestion, TodoWrite |
| model | sonnet |
| args | [--check-only] [--fix] |
| argument-hint | [--check-only] [--fix] |
| created | "2026-04-14T00:00:00.000Z" |
| modified | "2026-05-09T00:00:00.000Z" |
| reviewed | "2026-04-14T00:00:00.000Z" |
Migrate from black to ruff format — Ruff's drop-in Black-compatible formatter written in Rust (~35x faster). Replaces the psf/black pre-commit hook, migrates [tool.black] configuration, and removes black from dev dependencies.
| Use this skill when... | Keep black when... |
|---|---|
.pre-commit-config.yaml contains psf/black | Team has strong preference for black's exact output |
[tool.black] exists in pyproject.toml | CI uses black --check specifically by name |
| Repo already uses ruff for linting | Project uses black's API in build scripts |
| Wanting to consolidate formatting under ruff |
find . -maxdepth 1 -name '.pre-commit-config.yaml'find . -maxdepth 1 -name 'pyproject.toml'find . -maxdepth 1 -name 'ruff.toml'| Parameter | Description |
|---|---|
--check-only | Report what would change without modifying files |
--fix | Apply migration automatically |
Execute this black-to-ruff-format migration:
.pre-commit-config.yaml and locate psf/black entries.pyproject.toml and extract the [tool.black] section.black → ruff-format migration audit
=====================================
pre-commit hook: psf/black found at rev <rev>
pyproject.toml: [tool.black] section found (line-length=<N>, target-version=<X>)
ruff already: EXISTS / NOT PRESENT
--check-only, stop here.Remove the repo block. If is already present, add the hook ID. Otherwise add the full ruff-pre-commit repo block with both and hooks:
psf/blackruff-pre-commitruff-formatruffruff-format- repo: https://github.com/astral-sh/ruff-pre-commit
rev: v0.9.1 # use latest stable ruff version
hooks:
- id: ruff
args: [--fix]
- id: ruff-format
If ruff-pre-commit already exists but only has the ruff linter hook, add the ruff-format hook ID under the same repo block.
Convert black configuration to ruff format config:
| black key | ruff equivalent | Notes |
|---|---|---|
line-length | [tool.ruff] line-length | Shared with linter |
target-version | [tool.ruff] target-version | Shared with linter |
skip-string-normalization | [tool.ruff.format] quote-style = "preserve" | |
skip-magic-trailing-comma | [tool.ruff.format] skip-magic-trailing-comma = true | |
preview | [tool.ruff.format] preview = true |
Remove the [tool.black] section. Merge settings into [tool.ruff] and [tool.ruff.format] sections (create if absent, merge if existing).
Remove black from dev/lint dependencies:
# With uv
uvx --from uv uv remove --dev black 2>/dev/null || true
If not using uv, note it for manual removal.
Run the new hook to confirm it works:
pre-commit run ruff-format --all-files
If it exits 0, the migration is complete. If it produces diffs, this is expected on first run (ruff format may reformat some files differently from black). Commit the reformatted files as part of the migration.
Print a summary of changes:
black → ruff-format migration complete
=======================================
.pre-commit-config.yaml UPDATED (removed psf/black, added ruff-format hook)
pyproject.toml UPDATED ([tool.black] → [tool.ruff.format])
Note: ruff-format is Black-compatible (same defaults), but may reformat a small
number of files. Review the diff and include these reformatted files in the
migration commit.
Files to stage:
git add .pre-commit-config.yaml pyproject.toml
git add <any reformatted .py files>
| Context | Command |
|---|---|
| Audit only | /migration-patterns:black-to-ruff-format --check-only |
| Apply migration | /migration-patterns:black-to-ruff-format --fix |
| Verify after migration | pre-commit run ruff-format --all-files |
| Check format directly | uvx ruff format --check . |
| Item | Value |
|---|---|
| ruff format docs | https://docs.astral.sh/ruff/formatter/ |
| Black compatibility | ruff format is designed as a Black drop-in with ~99.9% compatible output |
| Config section | [tool.ruff.format] in pyproject.toml |
| Pre-commit hook | ruff-format in astral-sh/ruff-pre-commit |
/migration-patterns:flake8-to-ruff — Migrate flake8/isort linting to ruff/migration-patterns:mypy-to-ty — Migrate mypy to ty/configure:repo — End-to-end repo config driver