Agent skill

Polylith Dependency Management

by DavidVujic in DavidVujic/python-polylith

Add or manage third-party dependencies in a Polylith workspace.

MITAuto-check passedDevelopment

Install Polylith Dependency Management

skills CLI
$ npx skills add DavidVujic/python-polylith --skill polylith-dependency-management -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install DavidVujic/python-polylith polylith-dependency-management --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/DavidVujic/python-polylith.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/polylith/polylith-dependency-management .claude/skills/polylith-dependency-management && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
polylith-dependency-management
GitHub stars
553
Token cost
~643 tokens
SKILL.md length
283 words
Files
1
Skills in repo
37
Repo updated
First seen
Licence
MIT

At a glance

Add or manage third-party dependencies in a Polylith workspace.

  • Works in 2 steps: The Development Project (Root) → Deployable Projects (projects/)
  • The user wants to install a new library (e.g.
  • SKILL.md covers Rules for adding dependencies, Example Workflow: Adding… and Notes for the agent
  • Calls uv and poetry

What it does

Polylith Dependency Management is an agent skill from DavidVujic/python-polylith. Add or manage third-party dependencies in a Polylith workspace. Use when the user wants to install a new library (e.g., requests, fastapi) for a brick or project.

Its SKILL.md is about 640 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Dependency management and Backend development. It works with FastAPI. The repository describes itself as: Tooling support for the Polylith Architecture in Python. The licence is MIT.

When your agent uses it

  • The user wants to install a new library (e.g.
  • Fastapi) for a brick

Example prompts

  • “/polylith-dependency-management”

Requirements

  • Python 3

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. The Development Project (Root)
  2. Deployable Projects (projects/)

What it can do on your machine

Read from SKILL.md and the folder at commit a7a80f2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • uv
    • poetry

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Polylith Dependency Management loads about 643 tokens when it runs. Until then it costs about 48 tokens; SKILL.md has 283 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~48
When it runs · the whole SKILL.md, loaded when a task matches
~643

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from DavidVujic/python-polylith at commit a7a80f2, republished under its MIT licence (© DavidVujic). 283 words, ~643 tokens.

Download SKILL.mdSave it as .claude/skills/polylith-dependency-management/SKILL.md (or your agent's skills folder).
name
polylith-dependency-management
description
Add or manage third-party dependencies in a Polylith workspace. Use when the user wants to install a new library (e.g., requests, fastapi) for a brick or project.

Dependency Management Skill

💡 Terminology: this skill uses Polylith terms like brick, project, and development project. If they're unfamiliar, load polylith-concepts first.

Polylith manages third-party dependencies differently than standard Python projects.

Rules for adding dependencies

  1. The Development Project (Root): Every third-party library used anywhere in the workspace must be added to the root pyproject.toml (the development project). This ensures local REPLs, tests, and the shared lockfile work correctly. Use your package manager (e.g., uv add <package>, poetry add <package>) at the workspace root.
  2. Deployable Projects (projects/<name>): If a library is required for production by a specific deployable project, it must also be added to that project's pyproject.toml under projects/<name>/. Do this by manually editing the dependencies array in projects/<name>/pyproject.toml.

⚠ Never add dependencies to a brick's directory. Bricks do not have their own pyproject.toml files.

Example Workflow: Adding requests to an api project

  1. Install it at the root so the lockfile updates and it's available for local development:

    bash
    uv add requests
  2. Manually add it to the deployable project that needs it: Edit projects/api/pyproject.toml.

    Important Versioning Rule: Before adding the dependency to the project, check the root pyproject.toml. If it contains a [tool.uv.workspace] section (e.g., members = ["projects/*"]), then uv workspaces is enabled.

    If uv workspaces is enabled, do not specify the version in the project's pyproject.toml. Just use the package name, because versions are centrally pinned in the root. If workspaces are not enabled, then you should specify the version.

    toml
    # WITH uv/poetry workspaces enabled (Recommended):
    dependencies = [
        "requests"
    ]
    
    # WITHOUT workspaces enabled:
    dependencies = [
        "requests>=2.31.0"
    ]
  3. Run poly check (load polylith-check) to verify the workspace is valid. poly check will catch if a project imports requests but forgot to declare it in its pyproject.toml.

Notes for the agent

  • Use poly libs (load polylith-libs) to inspect current dependency usage across projects.

© DavidVujic, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/polylith/polylith-dependency-management of DavidVujic/python-polylith.

Open the folder on GitHubat commit a7a80f2

Compare with similar skills

Polylith Dependency Management next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Polylith Dependency Management compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Polylith Dependency Management this skillDavidVujic/python-polylith553—~643Automated safety check: PassMIT
AI ServerOpentrons/opentrons521—~2.5kAutomated safety check: NotesApache-2.0
Releasezmievsa/cadwyn309—~522Automated safety check: PassMIT
Mastering Python SkillSpillwaveSolutions/agent-brain120—~1.4kAutomated safety check: NotesMIT
Flowfile Debugging PlaybookEdwardvaneechoud/Flowfile370—~6.3kAutomated safety check: PassMIT
Senior Fullstackalirezarezvani/claude-skills28k1 repos~3.7kAutomated safety check: NotesMIT

Similar skills

  • AI Server

    Opentrons/opentrons

    Conventions for the opentrons-ai-server FastAPI service — project structure, uv dependency management, settings, testing, Docker, and deployment.

    521 GitHub stars~2.5k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Release

    zmievsa/cadwyn

    Prepare and publish Cadwyn releases. An agent skill from zmievsa/cadwyn.

    309 GitHub stars~522 tokensUpdated today
    DevelopmentAuto-check passed
  • Mastering Python Skill

    SpillwaveSolutions/agent-brain

    Modern Python coaching covering language foundations through advanced production patterns.

    120 GitHub stars~1.4k tokensUpdated 17 days ago
    DevelopmentAuto-check: notes
  • Flowfile Debugging Playbook

    Edwardvaneechoud/Flowfile

    Symptom-to-cause triage playbook for Flowfile (core/worker/kernel/frontend/AI) — covers "no such table" DB cascades (two distinct causes), import-time Alembic migration corruption, silent…

    370 GitHub stars~6.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Senior Fullstack

    alirezarezvani/claude-skills

    Fullstack development toolkit with project scaffolding for Next.js, FastAPI, MERN, and Django stacks, code quality analysis with security and complexity scoring, and stack selection guidance.

    28k GitHub starsUsed in 1 repo~3.7k tokens
    DevelopmentAuto-check: notes
  • Senior Fullstack

    borghei/Claude-Skills

    Fullstack development toolkit with project scaffolding for Next.js/FastAPI/MERN/Django stacks and code quality analysis.

    874 GitHub stars~1.7k tokensUpdated today
    DevelopmentAuto-check passed

More from DavidVujic/python-polylith

All 37 skills in this repo
  • Polylith Base Creation

    DavidVujic/python-polylith

    Create a Polylith base with poly create base — the entry point of a deployable application (HTTP API, CLI, message-queue consumer, AWS Lambda handler, GCP Cloud Function, scheduled job).

    553 GitHub stars~757 tokensUpdated 2 days ago
    Auto-check passed
  • Polylith Check

    DavidVujic/python-polylith

    Validate a Polylith workspace with poly check — the canonical CI gate.

    553 GitHub stars~972 tokensUpdated 2 days ago
    Auto-check passed
  • Polylith Component Creation

    DavidVujic/python-polylith

    Create a Polylith component with poly create component — a reusable, isolated brick implementing business logic, a feature, a domain module, or a capability.

    553 GitHub stars~800 tokensUpdated 2 days ago
    Auto-check passed
  • Polylith Dependency Visualization

    DavidVujic/python-polylith

    Visualize brick × brick dependencies with poly deps — find circular dependencies, inspect a brick's public interface, and detect interface-bypass violations.

    553 GitHub stars~906 tokensUpdated 2 days ago
    Auto-check passed
  • Polylith Diff

    DavidVujic/python-polylith

    List Polylith bricks whose implementation changed since a git tag using poly diff.

    553 GitHub stars~1.1k tokensUpdated 2 days ago
    Auto-check passed
  • Polylith Libs

    DavidVujic/python-polylith

    Inspect third-party libraries used per Polylith project with poly libs.

    553 GitHub stars~656 tokensUpdated 2 days ago
    Auto-check passed

Works with

Questions about Polylith Dependency Management

What does Polylith Dependency Management do?

Add or manage third-party dependencies in a Polylith workspace. Polylith Dependency Management is an agent skill from DavidVujic/python-polylith. Add or manage third-party dependencies in a Polylith workspace.

When should I use Polylith Dependency Management?

Polylith Dependency Management fits situations like: the user wants to install a new library (e.g; fastapi) for a brick.

How do I install Polylith Dependency Management in Claude Code?

Run `npx skills add DavidVujic/python-polylith --skill polylith-dependency-management -a claude-code`. Or copy the skill folder (.agents/skills/polylith/polylith-dependency-management in DavidVujic/python-polylith) into .claude/skills/polylith-dependency-management in your project. Claude Code loads it when a task matches its description.

How do I install Polylith Dependency Management in Codex?

Run `npx skills add DavidVujic/python-polylith --skill polylith-dependency-management -a codex`. Or copy the skill folder (.agents/skills/polylith/polylith-dependency-management in DavidVujic/python-polylith) into .agents/skills/polylith-dependency-management in your project. Codex loads it when a task matches its description.

Can I use Polylith Dependency Management in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add DavidVujic/python-polylith --skill polylith-dependency-management -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/polylith-dependency-management, .gemini/skills/polylith-dependency-management, .github/skills/polylith-dependency-management and .opencode/skills/polylith-dependency-management in your project.

What does Polylith Dependency Management need to run?

Going by SKILL.md and its folder, Polylith Dependency Management needs the command-line tools its instructions call (uv and poetry). Our summary lists: Python 3.

Does Polylith Dependency Management access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Polylith Dependency Management safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Polylith Dependency Management use?

Polylith Dependency Management is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Polylith Dependency Management use?

About 643 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Polylith Dependency Management?

Skills that share tags, products or a category with Polylith Dependency Management: AI Server (Opentrons/opentrons, 521 stars), Release (zmievsa/cadwyn, 309 stars), Mastering Python Skill (SpillwaveSolutions/agent-brain, 120 stars) and Flowfile Debugging Playbook (Edwardvaneechoud/Flowfile, 370 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Polylith Dependency Management?

DavidVujic (a GitHub user) maintains it in DavidVujic/python-polylith, which has 553 GitHub stars. The repository holds 37 skills in this directory. The repository was last updated on October 4, 2026.

Source: DavidVujic/python-polylith on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.