python-development · sammcj — Claude Code skill: Python and installation
The python-development skill sets Python coding rules for Claude Code, covering environments, typing, paths, and script dependencies. Use it on Python projects.
Apache-2.0 ★ 173 updated 2026-10-24
npx skills add sammcj/agentic-coding --skill python-development -a claude-codeWhat python-development does
The skill gives Claude Code a set of conventions for Python work. It favours Python 3.14+ features, uses uv to manage .venv, and runs type checks with uvx ty check. Functions should carry type hints; data structures use dataclasses, paths use pathlib, and formatted strings use f-strings.
For small standalone scripts with a few dependencies, the skill uses PEP 723 metadata in a TOML block enclosed by # /// markers. The example declares beautifulsoup4. The concrete constraint is Python 3.14+ with uv handling the virtual environment, so those choices need to fit the project.
What it helps with
- set conventions for a Python project
- run type checks with
uvx ty check - model data with dataclasses
- replace
os.pathwithpathlib - declare script dependencies with PEP 723
Example prompts for the agent
- Apply the skill’s Python rules to this project and use Python 3.14+ features where appropriate.
- Run
uvx ty checkon the project and fix the type errors it reports. - Add the script dependencies to a PEP 723 block inside the standalone file.
How to install python-development
1Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill python-development -a claude-code2Manually: put the files in place
~/.claude/skills/python-development/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/python-development/
1Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill python-development -a codex2Manually: put the files in place
.agents/skills/python-development/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill python-development -a cursor2Manually: put the files in place
.cursor/skills/python-development/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install sammcj/agentic-coding Skills/python-development/SKILL.md2Manually: put the files in place
.github/skills/python-development/SKILL.md1Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill python-development -a gemini-cli2Platform CLI
gemini skills install https://github.com/sammcj/agentic-coding --path Skills/python-developmentManually: put the files in place
.devin/skills/python-development/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about python-development
How do I install python-development in Claude Code?
Run npx skills add sammcj/agentic-coding --skill python-development -a claude-code. The skill file will be available at ~/.claude/skills/python-development/SKILL.md.
What does python-development do?
It sets Python conventions for Claude Code, including Python 3.14+, uv, uvx ty check, function type hints, dataclasses, pathlib, and f-strings. It also describes PEP 723 dependency blocks for standalone scripts.
What does python-development require?
The skill uses uv for virtual-environment management and uvx ty check for type checking. Its guidance favours Python 3.14+ features.
Source text
SKILL.md · Apache-2.0
--- name: python-development description: You MUST activate this skill when working on Python projects --- # Python - Favour Python 3.14+ features. Use `uv` for .venv management. Use `uvx ty check` for type checking - Type hints for all functions. Dataclasses for data structures. Pathlib over os.path. f-strings - For standalone scripts that have a few dependencies, use PEP 723 to declare dependencies in a TOML block inside `# ///` markers (e.g. `# /// script\n# dependencies = [\n# "beautifulsoup4",\n# ]\n# ///`)
© sammcj · Apache-2.0 · sammcj/agentic-coding
Similar skills
All skills for Programming languages →python-development by other authors comes first.