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 Concepts

by DavidVujic in DavidVujic/python-polylith

Provides foundational knowledge about Polylith architecture, including the glossary (bases, components, projects, workspaces), theme layouts, and package manager mapping.

MITAuto-check passedDevelopment

Install Polylith Concepts

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

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

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

At a glance

Provides foundational knowledge about Polylith architecture, including the glossary (bases, components, projects, workspaces), theme layouts, and package manager mapping.

  • Development work in your project
  • SKILL.md covers Glossary, Package & Dependency… and Themes
  • Calls uv and poetry

What it does

Polylith Concepts is an agent skill from DavidVujic/python-polylith. Provides foundational knowledge about Polylith architecture, including the glossary (bases, components, projects, workspaces), theme layouts, and package manager mapping. Use this when you need to understand Polylith terminology or how the repository is structured conceptually before taking action.

Its SKILL.md is about 1k 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. It works with Python. The repository describes itself as: Tooling support for the Polylith Architecture in Python. The licence is MIT.

When your agent uses it

  • Development work in your project

Example prompts

  • “Use the polylith-concepts skill to provide foundational knowledge about Polylith architecture, including the glossary (bases, components, projects…”
  • “/polylith-concepts”

Requirements

  • Python 3
  • Docker

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 Concepts loads about 1k tokens when it runs. Until then it costs about 79 tokens; SKILL.md has 410 words of instructions outside code blocks.

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

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). 410 words, ~1,046 tokens.

Download SKILL.mdSave it as .claude/skills/polylith-concepts/SKILL.md (or your agent's skills folder).
name
polylith-concepts
description
Provides foundational knowledge about Polylith architecture, including the glossary (bases, components, projects, workspaces), theme layouts, and package manager mapping. Use this when you need to understand Polylith terminology or how the repository is structured conceptually before taking action.

Polylith Concepts & Glossary

Glossary

Bricks

The fundamental units of code in Polylith — components and bases. Bricks are reusable, isolated, and organized under a single namespace.

Components

Reusable, isolated bricks that implement business logic or capabilities. Components are consumed by bases and by other components, never the other way around.

Bases

Bricks that serve as the entry point of a deployable application — for example HTTP APIs, CLIs, message-queue consumers, AWS Lambda handlers, GCP Cloud Functions, or scheduled jobs. A base wires together components and exposes the application to its runtime.

Namespace

The top-level Python package name under which all bricks live (e.g. mycompany). Defined once in [tool.polylith].namespace in workspace.toml; shared by every brick.

Workspace

The root directory of a Polylith repository. Contains workspace.toml, the root pyproject.toml (which is the development project), the bases/, components/, projects/, and development/ directories, and a single shared lock file.

Projects

Lightweight pyproject.toml configurations under projects/<name>/ that reference bricks to produce deployable artifacts (Docker images, wheels, Lambda packages). Projects contain no Python source code of their own.

Development Project

The root pyproject.toml itself — a single, unified Python environment that includes every brick and every dependency (production and dev). Used for local development, REPL sessions, and notebooks under development/.

Dependencies
  • The development project (root pyproject.toml) holds all dependencies, including dev-only ones.
  • Each project under projects/ holds only its production dependencies.
  • With uv workspaces, individual projects don't need to pin third-party versions — the root pyproject.toml and the shared lock file pin versions centrally.
Show full SKILL.md (166 more words)Show less

Package & Dependency Management mapping

The poly CLI is package-manager-agnostic — only the command prefix changes. Each SKILL.md repeats the prefix detection rule inline so the agent doesn't need this README to act. The full table:

ToolDetection signalCommand prefix
uv (recommended)uv.lock present, or [tool.uv] in pyproject.tomluv run poly …
Poetry[tool.poetry] in pyproject.toml, poetry.lockpoetry poly … (via poetry-polylith-plugin)
PDM[tool.pdm] in pyproject.toml, pdm.lockpdm run poly …
Hatch[tool.hatch] in pyproject.tomlhatch run poly …
Ryerequirements.lock + [tool.rye]rye run poly …
Activated virtualenv$VIRTUAL_ENV set, or none of the abovepoly …

If multiple signals are present, prefer the lock file that exists, then [tool.<x>] markers, then plain poly.

Themes

[tool.polylith.structure].theme controls the on-disk brick layout:

  • loose (recommended) — flat <bricks_dir>/<namespace>/<brick>/ directories with tests in a top-level test/ folder. Used by python-polylith itself and by most public examples.
  • tdd — each brick is its own directory with src/ and test/ siblings.

The CLI default for poly create workspace --theme is tdd. Always pass --theme loose explicitly when loose is wanted.

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

Open the folder on GitHubat commit a7a80f2

Compare with similar skills

Polylith Concepts 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 Concepts compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Polylith Concepts this skillDavidVujic/python-polylith553—~1kAutomated safety check: PassMIT
LangBot Plugin Developmentlangbot-app/LangBot18k—~3.9kAutomated safety check: PassApache-2.0
LangBot Core Developmentlangbot-app/LangBot18k—~1.4kAutomated safety check: NotesApache-2.0
Keybase RPC Log Analysiskeybase/client9.3k—~3kAutomated safety check: PassBSD-3-Clause
DDNS Provider DevelopmentNewFuture/DDNS4.7k—~558Automated safety check: PassMIT
Releasezmievsa/cadwyn309—~522Automated safety check: PassMIT

Similar skills

  • LangBot Plugin Development

    langbot-app/LangBot

    Guides building, debugging and testing LangBot plugins: components, SDK calls, README and locale rules, SDK pitfalls and WebSocket-based testing.

    18k GitHub stars~3.9k tokensUpdated today
    DevelopmentAuto-check passed

  • LangBot Core Development

    langbot-app/LangBot

    Covers developing the LangBot core backend and web UI: dev setup, repo layout, API auth types, adding endpoints, migrations and keeping the MCP server in step.

    18k GitHub stars~1.4k tokensUpdated today
    DevelopmentAuto-check: notes

  • Keybase RPC Log Analysis

    keybase/client

    Captures a clean Keybase service log and analyzes it for redundant, duplicated or looping RPCs, then checks whether a caching fix reduced the calls.

    9.3k GitHub stars~3k tokensUpdated today
    DevelopmentAuto-check passed

  • DDNS Provider Development

    NewFuture/DDNS

    Adds or changes a DNS provider in the DDNS project while keeping its code, schemas, tests and Chinese and English docs consistent.

    4.7k GitHub stars~558 tokensUpdated 2 days ago
    DevelopmentAuto-check passed

  • Release

    zmievsa/cadwyn

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

    309 GitHub stars~522 tokensUpdated yesterday
    DevelopmentAuto-check passed

  • Saleor Port Changes

    saleor/saleor

    Forward-ports or backports a single PR or branch onto the currently checked-out Saleor branch, handling GraphQL version markers and migration numbering along the way.

    23k GitHub stars~969 tokensUpdated yesterday
    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 3 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 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

Works with

Categories

Questions about Polylith Concepts

What does Polylith Concepts do?

Provides foundational knowledge about Polylith architecture, including the glossary (bases, components, projects, workspaces), theme layouts, and package manager mapping. Polylith Concepts is an agent skill from DavidVujic/python-polylith. Provides foundational knowledge about Polylith architecture, including the glossary (bases, components, projects, workspaces), theme layouts, and package manager mapping.

When should I use Polylith Concepts?

Polylith Concepts fits situations like: development work in your project.

How do I install Polylith Concepts in Claude Code?

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

How do I install Polylith Concepts in Codex?

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

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

What does Polylith Concepts need to run?

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

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

Polylith Concepts 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 Concepts use?

About 1k tokens (SKILL.md is roughly 4.2k 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 Concepts?

Skills that share tags, products or a category with Polylith Concepts: LangBot Plugin Development (langbot-app/LangBot, 18k stars), LangBot Core Development (langbot-app/LangBot, 18k stars), Keybase RPC Log Analysis (keybase/client, 9.3k stars) and DDNS Provider Development (NewFuture/DDNS, 4.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Polylith Concepts?

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.