About

Imported from terminalskills/skills (skills/poetry/SKILL.md). Install upstream with npx skills add terminalskills/skills --skill poetry. Copyright stays with the author (Apache-2.0).

Poetry

Name: poetry
Author: terminalskills

Overview

Poetry is a Python dependency manager and build tool. It handles virtual environments, dependency resolution (with a lock file), project scaffolding, and PyPI publishing. The modern replacement for pip + setuptools + virtualenv.

Instructions

Step 1: New Project

# Install Poetry
curl -sSL https://install.python-poetry.org | python3 -

# Create new project
poetry new my-api
cd my-api

# Or init in existing directory
poetry init

Step 2: Manage Dependencies

# Add dependencies
poetry add fastapi uvicorn sqlalchemy
poetry add pydantic-settings

# Add dev dependencies
poetry add --group dev pytest pytest-asyncio pytest-cov ruff mypy

# Remove
poetry remove requests

# Update
poetry update                  # update all within constraints
poetry update fastapi          # update specific package
poetry lock                    # regenerate lock file without installing

Step 3: pyproject.toml

# pyproject.toml — Project configuration
[tool.poetry]
name = "my-api"
version = "1.0.0"
description = "Project management API"
authors = ["Team <team@example.com>"]
readme = "README.md"

[tool.poetry.dependencies]
python = "^3.11"
fastapi = "^0.110"
uvicorn = {extras = ["standard"], version = "^0.27"}
sqlalchemy = "^2.0"
pydantic-settings = "^2.0"

[tool.poetry.group.dev.dependencies]
pytest = "^8.0"
pytest-asyncio = "^0.23"
pytest-cov = "^4.1"
ruff = "^0.3"
mypy = "^1.8"

[tool.poetry.scripts]
serve = "my_api.main:start"
migrate = "my_api.db:run_migrations"

[tool.ruff]
target-version = "py311"
line-length = 100

[tool.pytest.ini_options]
asyncio_mode = "auto"
testpaths = ["tests"]

[build-system]
requires = ["poetry-core"]
build-backend = "poetry.core.masonry.api"

Step 4: Use

# Activate virtual environment
poetry shell

# Run without activating
poetry run python main.py
poetry run pytest
poetry run serve              # custom script from pyproject.toml

# Export for Docker (no Poetry needed in container)
poetry export -f requirements.txt -o requirements.txt --without-hashes

# Build and publish to PyPI
poetry build
poetry publish

Guidelines

Always commit poetry.lock — ensures reproducible installs across environments.
Use poetry export for Docker — don't install Poetry in production containers.
Group dev dependencies with --group dev — they're excluded from production installs.
poetry.lock resolves ALL transitive dependencies — no more "works on my machine."
Alternative: uv (from Astral, makers of Ruff) — 10-100x faster, compatible with pip/Poetry.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/terminalskills-skills-poetry/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

terminalskills-skills-poetry.ocm.jsonjson

{
  "ocm": "1",
  "id": "terminalskills-skills-poetry",
  "kind": "skill",
  "name": "poetry",
  "description": "Manage Python projects with Poetry. Use when a user asks to manage Python dependencies, create virtual environments, publish packages to PyPI, handle dependency resolution, or set up a Python project structure.",
  "publisher": "terminalskills",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "poetry",
      "python",
      "dependencies",
      "packaging",
      "virtual-environment",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Manage Python projects with Poetry. Use when a user asks to manage Python dependencies, create virtual environments, publish packages to PyPI, handle dependency resolution, or set up a Python project structure."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/terminalskills/skills",
      "path": "skills/poetry/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/terminalskills/skills/blob/HEAD/skills/poetry/SKILL.md",
      "key": "terminalskills/skills/skills/poetry/SKILL.md"
    },
    "compatibility": "Python 3.8+",
    "license": "Apache-2.0"
  },
  "instructions": "# Poetry\n\n## Overview\n\nPoetry is a Python dependency manager and build tool. It handles virtual environments, dependency resolution (with a lock file), project scaffolding, and PyPI publishing. The modern replacement for pip + setuptools + virtualenv.\n\n## Instructions\n\n### Step 1: New Project\n\n```bash\n# Install Poetry\ncurl -sSL https://install.python-poetry.org | python3 -\n\n# Create new project\npoetry new my-api\ncd my-api\n\n# Or init in existing directory\npoetry init\n```\n\n### Step 2: Manage Dependencies\n\n```bash\n# Add dependencies\npoetry add fastapi uvicorn sqlalchemy\npoetry add pydantic-settin",
  "cost": {
    "context_tokens": 648
  }
}

Fetch it by URL: GET /api/v1/registry/terminalskills-skills-poetry/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.