python-tooling

House Python conventions plus the type-checking failures that get misdiagnosed: the dependency pinning policy (applications exact, libraries floors), the rule…

Skill by fblissjr

IndexedApache-2.0★ 2

Write a review

Install

Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install skill/fblissjr-python-tooling

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

House Python conventions plus the type-checking failures that get misdiagnosed: the dependency pinning policy (applications exact, libraries floors), the rule that linters, formatters and tests are never auto-run after an edit unless asked, and the two mechanical mistakes behind most Pydantic/Pyright diagnostic walls. Use when adding or pinning a dependency with uv add, when about to run ruff, pytest or a formatter after editing Python, when pyright reports a wall of "Arguments missing for parameters" or reportCallIssue, when a [tool.pyright] block seems to have no effect, when type errors appear on BaseModel subclasses whose fields have defaults, or when asked to suppress type errors in a Python project.

Use cases: testing, writing

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this skill can do and what it asks for, from its SKILL.md. Checked Oct 25, 2026.

Tools: No tools found
Secrets: None asked for
Install scripts: None found

Network hosts it talks to 1

codeload.github.com · found in install command

Files it touches

~/.claude/skills/python-tooling

What's inside

Skill name: python-tooling
Description: House Python conventions plus the type-checking failures that get misdiagnosed: the dependency pinning policy (applications exact, libraries floors), the rule that linters, formatters and tests are never auto-run after an edit unless asked, and the two mechanical mistakes behind most Pydantic/Pyright diagnostic walls. Use when adding or pinning a dependency with uv add, when about to run ruff, pytest or a formatter after editing Python, when pyright reports a wall of "Arguments missing for parameters" or reportCallIssue, when a [tool.pyright] block seems to have no effect, when type errors appear on BaseModel subclasses whose fields have defaults, or when asked to suppress type errors in a Python project.
License: Apache-2.0
Instructions: 31 lines in SKILL.md · view on GitHub

Files (2)

SKILL.md
type-checking.md · references/

SKILL.md (first lines)

# Python conventions and type-checking traps

Claude already knows uv. This skill carries only what it cannot derive: the
house pinning policy, and the failures that reliably get misdiagnosed.

## Pinning policy

Applications pin exact (`uv add httpx==0.27.2`); libraries and dev dependencies
use floors (`uv add 'httpx>=0.27'`). Unsure → exact. `uv lock --check` after.

## Before suppressing a wall of type errors

Two mechanical mistakes produce hundreds of diagnostics that read as unfixable
Pydantic/Pyright noise: a positional `Field()` default and an unannotated
splatted dict. Check both before writing a suppression: `references/type-checking.md`.

The same file covers Pyright config precedence — `pyrightconfig.json` always
outranks `[tool.pyright]`, which is why a config block can appear to do nothing.

## After an edit, don't run linters or tests unasked

Leave linters, formatters, and tests alone after an edit unless asked. This is
the one behavioural default worth overriding here: the reflex is strong, the
output is long, and it buries the change the user actually wants to look at.

## Adjacent, owned elsewhere

- Lint config and ruff findings — `ruff-diagnostics` plugin.
- Pointing Pyright at the project venv — `pyright-autoconfig` plugin.

From fblissjr/fb-claude-skills, Apache-2.0.

Signals

Stars: 2
Forks: 1
Open issues: 0
Last commit (this folder): Sep 24, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026).

Details

License: Apache-2.0
Repository: github.com/fblissjr/fb-claude-skills
First seen: Oct 24, 2026
Last checked: Oct 24, 2026
Source: GitHub github-graphql

More from fblissjr

Cite this page

python-tooling skill. Agent Mart. https://agentmart.dev/skills/fblissjr-python-tooling (last updated 2026-10-24)