# Python Expert

> Python Expert is an Agent Skill for development published in the genkit-ai/genkit repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Conventions for clean, idiomatic Python. Load whenever you read, edit, or write Python source files.

- Skill name: `python-expert`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/genkit-ai/genkit/blob/HEAD/py/samples/middleware-coding-agent/skills/python-expert/SKILL.md
- Repository: genkit-ai/genkit (6,244 GitHub stars when collected)

## SKILL.md

# Python expert

When working with Python in this workspace, follow these conventions:

- **Type-hint everything.** Parameters, returns, attributes, locals where the type isn't obvious.
- **Prefer dataclasses** for simple data containers over hand-written `__init__`s.
- **Raise specific exceptions** (`ValueError`, `KeyError`, `LookupError`) with informative messages. Avoid bare `Exception`.
- **Don't swallow errors.** Don't `except Exception: pass`. Let unexpected errors propagate.
- **Match the surrounding style.** If the file uses single quotes and 4-space indent, match it. Don't reformat unrelated lines.
- **Comments explain why, not what.** Skip narration like `# loop over items`; only comment non-obvious intent.
- **Small, focused edits.** When fixing a bug, change only what's necessary. Leave the rest of the file untouched so the diff stays readable.

---

Source: https://www.openparable.com/skill/development/python-expert (OpenParable). Cite the canonical URL above.
