ia-python-services skill
Implements patterns for building CLI tools, asynchronous services, and backend applications using modern Python tooling.
- GitHub stars
- 36
- Files
- 7
- Last commit
- Nov 11, 2026
- License
- MIT
- Allowed tools
- —
What does the ia-python-services skill do?
ia-python-services implements patterns for building CLI tools, asynchronous services, and backend applications using modern Python tooling.
Summary generated from the skill's SKILL.md.
About the ia-python-services skill
Developers building command-line interfaces, asynchronous services, or backend applications can use this skill to implement standardized Python patterns. It provides specific guidance for managing concurrency with asyncio, configuring modern tooling like uv, ruff, and ty, and structuring FastAPI services. An agent should load this skill when tasked with writing Python code, managing pyproject.toml files, or setting up testing environments with pytest.
The skill focuses on strict discipline regarding input validation, error handling, and architectural simplicity. It requires maintaining distinct states between missing and empty results and ensures that network calls include timeouts. By following these rules, the agent produces code that adheres to high coverage targets and passes specific checks using uv run commands for testing and linting. It relies on specialized references for topics like service boundaries, concurrency, and CLI setup to ensure consistent implementation across different Python projects.
What an agent can do with it
- 1Configure Python project toolingSet up a new Python environment using uv, ruff, and ty with proper configuration files.
- 2Implement resilient asynchronous servicesDevelop background jobs and network calls that include timeouts and proper retry logic.
- 3Build validated backend APIsCreate FastAPI services that enforce strict validation at boundaries and manage migrations.
Written from the skill's SKILL.md. Every use case is checked against a quote from it.
How to install the ia-python-services skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the ia-python-services skill in Plugin
/plugin marketplace add iliaal/whetstone /plugin install whetstone@iliaal-marketplace
Install the ia-python-services skill in Claude Code
~/.claude/skills/ia-python-services/SKILL.md
$ npx degit iliaal/whetstone/plugins/whetstone/skills/ia-python-services ~/.claude/skills/ia-python-servicesInstall the ia-python-services skill in Claude Code (project)
.claude/skills/ia-python-services/SKILL.md
$ npx degit iliaal/whetstone/plugins/whetstone/skills/ia-python-services .claude/skills/ia-python-servicesInstall the ia-python-services skill in Codex
~/.agents/skills/ia-python-services/SKILL.md
$ npx degit iliaal/whetstone/plugins/whetstone/skills/ia-python-services ~/.agents/skills/ia-python-servicesInstall the ia-python-services skill in Gemini CLI
~/.gemini/skills/ia-python-services/SKILL.md
$ npx degit iliaal/whetstone/plugins/whetstone/skills/ia-python-services ~/.gemini/skills/ia-python-servicesInstall the ia-python-services skill in Claude.ai
npx degit iliaal/whetstone/plugins/whetstone/skills/ia-python-services ia-python-services && zip -r ia-python-services.zip ia-python-services # claude.ai → Customize → Skills → + → Create skill → Upload a skill → ia-python-services.zip
SKILL.md
View on GitHubPython Services & CLI
Working rules
- Validate external inputs and responses at boundaries; preserve exception causes.
- Keep missing results distinct from empty results. When an empty collection means success, require the response field instead of defaulting it to empty; an all-default model can validate
{}as success. Test missing, misspelled, explicitly empty, and populated payloads through the real validation boundary. - Keep simple sequential work synchronous. Bound concurrent work, preserve cancellation, and keep task references.
- Give network calls timeouts; retry only failures and operations whose semantics permit it.
- Enforce job idempotency with atomic writes and database constraints.
- Preserve published API behavior and shared migration history.
- Match telemetry to an operational question and verify its output.
Discipline
- Simplicity first: every change as simple as possible, impact minimal code
- Only touch what's necessary; avoid introducing unrelated changes
- No hacky workarounds: if a fix feels wrong, step back and implement the clean solution
- Before adding a new abstraction, verify it appears in 3+ places. If not, inline it.
- Verify: see Verify section below; pass all checks with zero warnings before declaring done
Verify
uv run pytestpasses with zero failuresuv run ruff check .passes with zero warningsuv run ty check .passes with zero errors- Coverage target: 80%+ (
uv run pytest --cov; add--cov-report=htmlfor a browsable report)
Task-specific references
Read the relevant reference before implementing or reviewing the matching behavior:
- For packaging, environment configuration, CLI setup, or pytest behavior: tooling-and-tests.md.
- For asyncio, background jobs, retries, pooling, timeouts, or health checks: concurrency-and-resilience.md.
- For APIs, validation, errors, migrations, logging, metrics, or traces: service-boundaries.md.
Existing specialized references, when the corresponding topic applies:
Files in this skill
7ia-python-services skill questions
How do I install the ia-python-services skill in Claude Code?
Run npx degit iliaal/whetstone/plugins/whetstone/skills/ia-python-services ~/.claude/skills/ia-python-services. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the ia-python-services skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.
How should I handle empty vs missing results in data validation?
You must keep missing results distinct from empty results. When an empty collection signifies success, require the response field rather than defaulting to an empty value.
What is the rule for adding new abstractions?
Before introducing a new abstraction, you must verify that it is used in at least three different places; otherwise, it should be inlined.