New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Polylith Project Management

by DavidVujic in DavidVujic/python-polylith

Create a deployable Polylith project with poly create project — a lightweight pyproject.toml under projects/<name/ that references bricks for deployment as a Docker image, wheel, AWS Lambda, GCP…

MITAuto-check passedBackend & APIs

Install Polylith Project Management

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

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

GitHub CLI
$ gh skill install DavidVujic/python-polylith polylith-project-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-project-management .claude/skills/polylith-project-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-project-management
GitHub stars
553
Token cost
~1.5k tokens
SKILL.md length
530 words
Files
1
Skills in repo
37
Repo updated
First seen
Licence
MIT

At a glance

Create a deployable Polylith project with poly create project — a lightweight pyproject.toml under projects/<name/ that references bricks for deployment as a Docker image, wheel, AWS Lambda, GCP…

  • Works in 3 steps: Detects the build backend in the root… → Writes projects//pyproject.toml,… → If --quiet is not used, it runs an…
  • The user wants a new deployable
  • SKILL.md covers Quick command, What poly create project…, Prerequisites and Command reference, plus 5 more sections
  • Calls uv and poetry

What it does

Polylith Project Management is an agent skill from DavidVujic/python-polylith. Create a deployable Polylith project with poly create project — a lightweight pyproject.toml under projects/<name/ that references bricks for deployment as a Docker image, wheel, AWS Lambda, GCP Cloud Function, or other artifact. Use when the user wants a new deployable, service, microservice, or release target.

Its SKILL.md is about 1.5k 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 Backend & APIs, covering Project management, Microservices and Serverless. It works with Docker, AWS Lambda and Google Cloud. 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 a new deployable
  • Tasks that involve Project management
  • Tasks that involve Microservices

Example prompts

  • “/polylith-project-management”

Requirements

  • Python 3
  • Docker

Workflow steps

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

  1. Detects the build backend in the root pyproject.toml (Hatchling, PDM, or Poetry) and picks the matching pyproject.toml template.
  2. Writes projects//pyproject.toml, inheriting authors and requires-python from the root.
  3. If --quiet is not used, it runs an interactive prompt to add bricks. Agents must always use --quiet and manage bricks manually.

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 Project Management loads about 1.5k tokens when it runs. Until then it costs about 87 tokens; SKILL.md has 530 words of instructions outside code blocks.

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

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). 530 words, ~1,464 tokens.

Download SKILL.mdSave it as .claude/skills/polylith-project-management/SKILL.md (or your agent's skills folder).
name
polylith-project-management
description
Create a deployable Polylith project with `poly create project` — a lightweight `pyproject.toml` under `projects/<name>/` that references bricks for deployment as a Docker image, wheel, AWS Lambda, GCP Cloud Function, or other artifact. Use when the user wants a new deployable, service, microservice, or release target.

Project Management Skill

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

Quick command

bash
uv run poly create project --name user_api --quiet

Command prefix: If you do not know the package manager, list lock files with ls uv.lock poetry.lock pdm.lock 2>/dev/null (a pyproject.toml is always present, so it tells you nothing on its own). Use uv run poly (uv), poetry poly (poetry), pdm run poly (pdm), hatch run poly (hatch), or poly (activated venv). Examples below use uv run.

⚠ Do NOT invent flags for selecting components/bases/deployment targets — they don't exist. The CLI accepts only --name, --description, and --quiet. Bricks are attached manually and via later poly sync runs. ⚠ There is no poly build project command. Building the artifact (Docker, wheel, Lambda zip) is the package manager's job (uv build, poetry build, hatch build, pdm build).

What poly create project actually does

  1. Detects the build backend in the root pyproject.toml (Hatchling, PDM, or Poetry) and picks the matching pyproject.toml template.
  2. Writes projects/<name>/pyproject.toml, inheriting authors and requires-python from the root.
  3. If --quiet is not used, it runs an interactive prompt to add bricks. Agents must always use --quiet and manage bricks manually.

Prerequisites

  • A Polylith workspace already exists (load polylith-workspace-setup if not).
  • The root pyproject.toml exists and uses Hatchling, uv, Poetry, pixi, Maturin or PDM. Without it, the command exits non-zero with Failed to guess the used Package & Dependency Management.

Command reference

OptionRequiredDefaultDescription
--nameyes—Name of the project.
--descriptionno""Optional human-readable description.
--quietnofalseSuppress the interactive prompt.

Examples

bash
# Minimal — bypass interactive prompt
uv run poly create project --name user_api --quiet

# With description
uv run poly create project --name consumer --description "Kafka order consumer" --quiet

What gets written

projects/user_api/pyproject.toml

For the Hatchling backend (most common with Polylith):

toml
[build-system]
requires = ["hatchling", "hatch-polylith-bricks"]
build-backend = "hatchling.build"

[project]
name = "user_api"
version = "0.1.0"
description = "User-facing HTTP API"
authors = [{ name = "Jane Doe", email = "jane@example.com" }]
requires-python = ">=3.12"
dependencies = []

[tool.hatch.build.targets.wheel]
packages = ["mycompany"]

[tool.hatch.build.hooks.polylith-bricks]

[tool.polylith.bricks]
# Populated by `poly sync` (e.g. "../../bases/mycompany/api" = "mycompany/api")

name, description, authors, requires-python, and packages come from the root pyproject.toml and the --name / --description flags. [tool.polylith.bricks] is populated manually or by poly sync.

Backend differences
Build backendBuild hook in projectNotes
Hatchlinghatch-polylith-bricksMost common.
PDMpdm-polylith-bricks
Poetry(no build hook)Uses poetry-polylith-plugin at runtime.
Show full SKILL.md (214 more words)Show less

After creation

  • Whenever imports change, run poly sync (load polylith-sync).
  • Before a release / in CI, run poly check (load polylith-check).

Notes for the agent

  • Always use --quiet. AI agents cannot interact with stdin prompts and the process will hang indefinitely if --quiet is omitted.
  • After creating the project with --quiet, you can link a base manually, but it is not strictly required right away. Empty projects are perfectly valid. If the user wants to add a base later, or if the base doesn't exist yet, simply leave the [tool.polylith.bricks] section empty for now.
  • Manual Base Linking Syntax: When it's time to link a base manually, edit the [tool.polylith.bricks] section in projects/<name>/pyproject.toml. Check workspace.toml first to determine the theme and namespace.
    • For the loose theme (recommended): "../../bases/<namespace>/<basename>" = "<namespace>/<basename>" (e.g., "../../bases/mycompany/api" = "mycompany/api").
    • For the tdd theme: "../../bases/<basename>/src/<namespace>/<basename>" = "<namespace>/<basename>" (e.g., "../../bases/api/src/mycompany/api" = "mycompany/api").
  • Components are never selected directly; they are pulled in transitively by the imports of the chosen base when you run poly sync.

Verification

After creation, verify the project exists by checking projects/<name>/pyproject.toml. If the base already exists and the user wants it linked now, edit the [tool.polylith.bricks] section in that file to include the base, and then run poly sync to populate its transitive dependencies. Otherwise, the empty project is ready for development to proceed.

© 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-project-management of DavidVujic/python-polylith.

Open the folder on GitHubat commit a7a80f2

Compare with similar skills

Polylith Project 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 Project Management compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Polylith Project Management this skillDavidVujic/python-polylith553—~1.5kAutomated safety check: PassMIT
Frontmcp Deploymentagentfront/frontmcp146—~9.2kAutomated safety check: NotesApache-2.0
GCP Cloud Rundavila7/claude-code-templates32k8 repos~1.7kAutomated safety check: PassMIT
Discover Infrarand/cc-polymath181—~783Automated safety check: PassMIT
Securing Serverless Functionsmukul975/Anthropic-Cybersecurity-Skills34k—~3.1kAutomated safety check: PassApache-2.0
AWS Cloudformation Lambdagiuseppe-trisciuoglio/developer-kit355—~3kAutomated safety check: NotesMIT

Similar skills

  • Frontmcp Deployment

    agentfront/frontmcp

    A skill your agent uses when deploying, building for production, packaging, or shipping a FrontMCP server.

    146 GitHub stars~9.2k tokensUpdated yesterday
    DevOps & CloudAuto-check: notes

  • GCP Cloud Run

    davila7/claude-code-templates

    Specialized skill for building production-ready serverless applications on GCP.

    32k GitHub starsUsed in 8 repos~1.7k tokens
    Backend & APIsAuto-check passed

  • Discover Infra

    rand/cc-polymath

    Automatically discover cloud, infrastructure, deployment, and container skills when working with AWS, GCP, Azure, Docker, Kubernetes, Terraform, Netlify, Heroku, serverless, or IaC

    181 GitHub stars~783 tokensUpdated 7 mo ago
    DevOps & CloudAuto-check passed

  • Securing Serverless Functions

    mukul975/Anthropic-Cybersecurity-Skills

    Hardens serverless compute platforms (AWS Lambda, Azure Functions, Google Cloud Functions): least-privilege IAM roles, dependency vulnerability scanning, secrets management integration, input…

    34k GitHub stars~3.1k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed

  • AWS Cloudformation Lambda

    giuseppe-trisciuoglio/developer-kit

    Provides AWS CloudFormation patterns for Lambda functions, layers, API Gateway integration, event sources, cold start optimization, monitoring, logging, template validation, and deployment workflows.

    355 GitHub stars~3k tokensUpdated 28 days ago
    Backend & APIsAuto-check: notes

  • Model Deployment

    majiayu000/claude-skill-registry

    Deploy trained machine learning models as production-ready services using REST APIs, containers, serverless functions, and orchestration platforms.

    666 GitHub starsUsed in 1 repo~2.1k tokens
    Backend & APIsAuto-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 4 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 4 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 4 days ago
    Auto-check passed

  • Polylith Dependency Management

    DavidVujic/python-polylith

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

    553 GitHub stars~643 tokensUpdated 4 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 4 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 4 days ago
    Auto-check passed

Works with

Categories

Questions about Polylith Project Management

What does Polylith Project Management do?

Create a deployable Polylith project with poly create project — a lightweight pyproject.toml under projects/<name/ that references bricks for deployment as a Docker image, wheel, AWS Lambda, GCP…. Polylith Project Management is an agent skill from DavidVujic/python-polylith.toml under projects/<name/ that references bricks for deployment as a Docker image, wheel, AWS Lambda, GCP Cloud Function, or other artifact.

When should I use Polylith Project Management?

Polylith Project Management fits situations like: the user wants a new deployable; tasks that involve Project management; tasks that involve Microservices.

How do I install Polylith Project Management in Claude Code?

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

How do I install Polylith Project Management in Codex?

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

Can I use Polylith Project 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-project-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-project-management, .gemini/skills/polylith-project-management, .github/skills/polylith-project-management and .opencode/skills/polylith-project-management in your project.

What does Polylith Project Management need to run?

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

Does Polylith Project 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 Project 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 Project Management use?

Polylith Project 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 Project Management use?

About 1.5k tokens (SKILL.md is roughly 5.9k 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 Project Management?

Skills that share tags, products or a category with Polylith Project Management: Frontmcp Deployment (agentfront/frontmcp, 146 stars), GCP Cloud Run (davila7/claude-code-templates, 32k stars), Discover Infra (rand/cc-polymath, 181 stars) and Securing Serverless Functions (mukul975/Anthropic-Cybersecurity-Skills, 34k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Polylith Project 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.