Agent skill

Polylith Base Creation

by DavidVujic in 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).

MITAuto-check passedBackend & APIs

Install Polylith Base Creation

skills CLI
$ npx skills add DavidVujic/python-polylith --skill polylith-base-creation -a claude-code

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

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

At a glance

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).

  • The user wants to add a service
  • SKILL.md covers Quick command, Command reference, What gets created (loose theme) and Examples, plus 2 more sections
  • Calls uv and poetry
  • Any new entry point to a Polylith workspace

What it does

Polylith Base Creation is an agent skill from 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). Use when the user wants to add a service, API, endpoint, handler, or any new entry point to a Polylith workspace.

Its SKILL.md is about 760 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 REST APIs, Event-driven systems and Background jobs. It works with 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 to add a service
  • Any new entry point to a Polylith workspace

Example prompts

  • “/polylith-base-creation”

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 Base Creation loads about 757 tokens when it runs. Until then it costs about 81 tokens; SKILL.md has 275 words of instructions outside code blocks.

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

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). 275 words, ~757 tokens.

Download SKILL.mdSave it as .claude/skills/polylith-base-creation/SKILL.md (or your agent's skills folder).
name
polylith-base-creation
description
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). Use when the user wants to add a service, API, endpoint, handler, or any new entry point to a Polylith workspace.

Base Creation Skill

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

Quick command

bash
uv run poly create base --name api

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.

A base is the entry point of a deployable application. For non-entry-point reusable code (business logic, capabilities), use polylith-component-creation instead.

Command reference

OptionRequiredDefaultDescription
--nameyes—Name of the base (also the package name).
--descriptionno""Optional human-readable description.

What gets created (loose theme)

bases/<namespace>/api/
├── __init__.py     # Public interface — empty; add re-exports here
└── core.py         # Implementation — empty; user fills it in

If [tool.polylith.test].enabled = true in workspace.toml, the CLI also creates test/bases/<namespace>/api/test_core.py.

For the tdd theme layout (bases/api/{src,test}/<namespace>/api/...), load the polylith-workspace-setup skill.

Examples

bash
# Minimal
uv run poly create base --name api

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

Notes for the agent

  • core.py is empty boilerplate — there is no FastAPI/Typer/Lambda scaffolding. Fill it in manually after creation if asked.
  • __init__.py is also empty. By Polylith convention it should re-export the brick's public symbols, so consumers import from <namespace>.api import … rather than reaching into core.py.
  • A new base is not wired into any project. To wire it: load polylith-sync and run poly sync, or run poly create project (the interactive prompt will offer to attach the base).
  • The same command works for both loose and tdd themes — the CLI reads [tool.polylith.structure].theme from workspace.toml.

Verification

After creation, verify the base exists using your file tools (e.g., check bases/<namespace>/<name>/__init__.py). Then, you will likely need to populate core.py and __init__.py using your file writing tools since they are created empty.

© 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-base-creation of DavidVujic/python-polylith.

Open the folder on GitHubat commit a7a80f2

Compare with similar skills

Polylith Base Creation 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 Base Creation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Polylith Base Creation this skillDavidVujic/python-polylith553—~757Automated safety check: PassMIT
AWS Serverless Edazxkane/aws-skills3674 repos~3.2kAutomated safety check: PassMIT
Serverless IntegrationsDataDog/dd-trace-js836—~1.1kAutomated safety check: PassCustom licence
Processing S3 Uploads With Step Functionsaws/agent-toolkit-for-aws2.8k—~4kAutomated safety check: PassApache-2.0
AWS Serverlessdavila7/claude-code-templates32k8 repos~2kAutomated safety check: PassMIT
GCP Cloud Rundavila7/claude-code-templates32k8 repos~1.7kAutomated safety check: PassMIT

Similar skills

  • AWS Serverless Eda

    zxkane/aws-skills

    AWS serverless and event-driven architecture expert based on Well-Architected Framework.

    367 GitHub starsUsed in 4 repos~3.2k tokens
    Backend & APIsAuto-check passed
  • Serverless Integrations

    DataDog/dd-trace-js

    Official

    A skill your agent uses when adding, modifying, debugging, or reviewing dd-trace-js serverless platform integrations that create root invocation spans for AWS Lambda, Azure Functions, Google Cloud…

    836 GitHub stars~1.1k tokensUpdated today
    Backend & APIsAuto-check passed
  • Official

    Deploy an event-driven workflow that routes S3 uploads to either Lambda or Fargate via Step Functions based on file size.

    2.8k GitHub stars~4k tokensUpdated today
    Backend & APIsAuto-check passed
  • AWS Serverless

    davila7/claude-code-templates

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

    32k GitHub starsUsed in 8 repos~2k tokens
    Backend & APIsAuto-check passed
  • 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
  • AWS Lambda Microvms

    awslabs/agent-plugins

    Official

    Build, run, debug, and operate applications on AWS Lambda MicroVMs — Firecracker-isolated, snapshot-resumable serverless compute environments that run inside a container with up to 8-hour lifetimes.

    915 GitHub starsUsed in 1 repo~4.1k tokens
    Backend & APIsAuto-check passed

More from DavidVujic/python-polylith

All 37 skills in this repo
  • Polylith Check

    DavidVujic/python-polylith

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

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

Categories

Questions about Polylith Base Creation

What does Polylith Base Creation do?

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). Polylith Base Creation is an agent skill from 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).

When should I use Polylith Base Creation?

Polylith Base Creation fits situations like: the user wants to add a service; any new entry point to a Polylith workspace.

How do I install Polylith Base Creation in Claude Code?

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

How do I install Polylith Base Creation in Codex?

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

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

What does Polylith Base Creation need to run?

Going by SKILL.md and its folder, Polylith Base Creation needs the command-line tools its instructions call (uv and poetry).

Does Polylith Base Creation 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 Base Creation 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 Base Creation use?

Polylith Base Creation 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 Base Creation use?

About 757 tokens (SKILL.md is roughly 3k 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 Base Creation?

Skills that share tags, products or a category with Polylith Base Creation: AWS Serverless Eda (zxkane/aws-skills, 367 stars), Serverless Integrations (DataDog/dd-trace-js, 836 stars), Processing S3 Uploads With Step Functions (aws/agent-toolkit-for-aws, 2.8k stars) and AWS Serverless (davila7/claude-code-templates, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Polylith Base Creation?

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.