New: 97,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 Dependency Visualization

by DavidVujic in DavidVujic/python-polylith

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

MITAuto-check passed

Install Polylith Dependency Visualization

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

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

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

At a glance

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

  • Works in 4 steps: Identify the offending import in the… → Add helloworld to /brick_b/init.py → Update the importer to from .brick_b… → …
  • What depends on what
  • SKILL.md covers Quick command, Command reference, Examples and Fixing an interface violation, plus 1 more section
  • Calls uv and poetry

What it does

Polylith Dependency Visualization is an agent skill from DavidVujic/python-polylith. Visualize brick × brick dependencies with poly deps — find circular dependencies, inspect a brick's public interface, and detect interface-bypass violations. Use for "what depends on what", "circular deps", "interface violation". For brick × project usage, use polylith-workspace-inspection.

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

The repository describes itself as: Tooling support for the Polylith Architecture in Python. The licence is MIT.

When your agent uses it

  • What depends on what
  • Interface violation

Example prompts

  • “s public interface, and detect interface-bypass violations. Use for”
  • “circular deps”
  • “interface violation”
  • “/polylith-dependency-visualization”

Requirements

  • Python 3

Workflow steps

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

  1. Identify the offending import in the violating brick (e.g. from .brick_b.internal import helloworld).
  2. Add helloworld to /brick_b/init.py
  3. Update the importer to from .brick_b import helloworld.
  4. Re-run poly deps --interface to confirm.

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 Visualization loads about 906 tokens when it runs. Until then it costs about 83 tokens; SKILL.md has 244 words of instructions outside code blocks.

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

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). 244 words, ~906 tokens.

Download SKILL.mdSave it as .claude/skills/polylith-dependency-visualization/SKILL.md (or your agent's skills folder).
name
polylith-dependency-visualization
description
Visualize **brick × brick** dependencies with `poly deps` — find circular dependencies, inspect a brick's public interface, and detect interface-bypass violations. Use for "what depends on what", "circular deps", "interface violation". For brick × project usage, use `polylith-workspace-inspection`.

Dependency Visualization Skill

Quick command

bash
uv run poly deps

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.

poly deps vs poly info:

  • poly deps → brick × brick (dependencies between bricks; interface compliance).
  • poly info → brick × project (which projects use which brick). Load polylith-workspace-inspection. ⚠ poly deps does not fail on warnings (circular deps, interface violations are informational). For pass/fail, use poly check (load polylith-check).

Command reference

OptionDefaultDescription
--brick—Restrict output to the named brick.
--interfacefalseShow the brick's public interface and flag bricks that bypass it.
--savefalsePersist the report to a file under the workspace's output dir.
--directorycwdRestrict analysis to projects whose path matches this directory.

Examples

bash
# Full matrix
uv run poly deps

# One brick + interface compliance check
uv run poly deps --brick message --interface

# Save report
uv run poly deps --save
Output format
                         d   g
                         a   r           m
                         t   e           e   s
                         a   e   k       s   c
                         b   t   a       s   h
                         a   i   f   l   a   e
                         s   n   k   o   g   m
  brick                  e   g   a   g   e   a
 ─────────────────────────────────────────────
  greeting               -   -   -   -   -   -
  kafka                  -   -   -   ✔   -   -
  message                ✔   -   ✔   -   -   ✔
  greet_api              -   ✔   -   ✔   -   -

✔ = row brick imports column brick.

Warning messages
ℹ brick_a is used by brick_b and also uses brick_a.        # circular
ℹ Found in brick_a: helloworld is not part of the public interface of brick_b.   # interface violation

Fixing an interface violation

When --interface reports a violation:

  1. Identify the offending import in the violating brick (e.g. from <ns>.brick_b.internal import helloworld).
  2. Add helloworld to <ns>/brick_b/__init__.py:
    python
    from <ns>.brick_b.internal import helloworld
  3. Update the importer to from <ns>.brick_b import helloworld.
  4. Re-run poly deps --interface to confirm.

Notes for the agent

  • Circular deps usually mean two bricks share a concept that should be extracted into a third brick — flag this for the user; don't silently break the cycle by hiding imports.

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

Open the folder on GitHubat commit a7a80f2

Compare with similar skills

Polylith Dependency Visualization 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 Visualization compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Polylith Dependency Visualization this skillDavidVujic/python-polylith553—~906Automated safety check: PassMIT
Visual Stylecalesthio/OpenMontage65k—~1.5kAutomated safety check: PassAGPL-3.0
D3 Visualizationnexu-io/open-design100k—~523Automated safety check: PassApache-2.0
Dependency Scanningsickn33/agentic-awesome-skills47k1 repos~2.4kAutomated safety check: PassMIT
Depsickn33/agentic-awesome-skills47k1 repos~1.8kAutomated safety check: PassMIT
Dependency Checkruvnet/ruflo74k—~258Automated safety check: PassMIT

Similar skills

  • Visual Style

    calesthio/OpenMontage

    Create, extract, and apply portable visual design systems via visual-style.md files.

    65k GitHub stars~1.5k tokensUpdated 4 days ago
    Frontend & DesignAuto-check passed

  • D3 Visualization

    nexu-io/open-design

    Teaches the agent to produce D3 charts and interactive data visualizations.

    100k GitHub stars~523 tokensUpdated today
    Data & AnalyticsAuto-check passed

  • Dependency Scanning

    sickn33/agentic-awesome-skills

    Scan package dependencies for known vulnerabilities using Snyk, Dependabot, and OWASP Dependency-Check.

    47k GitHub starsUsed in 1 repo~2.4k tokens
    SecurityAuto-check passed

  • Dep

    sickn33/agentic-awesome-skills

    Handles containerization, CI/CD pipelines, and deployment setup.

    47k GitHub starsUsed in 1 repo~1.8k tokens
    DevOps & CloudAuto-check passed

  • Dependency Check

    ruvnet/ruflo

    Scan project dependencies for known vulnerabilities and CVEs.

    74k GitHub stars~258 tokensUpdated today
    SecurityAuto-check passed

  • Visual Regression

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing CI coverage, automated checks, or test strategy related to Use visual regression testing.

    74k GitHub stars~493 tokensUpdated yesterday
    Testing & QAAuto-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 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

Questions about Polylith Dependency Visualization

What does Polylith Dependency Visualization do?

Visualize brick × brick dependencies with poly deps — find circular dependencies, inspect a brick's public interface, and detect interface-bypass violations. Polylith Dependency Visualization is an agent skill from DavidVujic/python-polylith. Visualize brick × brick dependencies with poly deps — find circular dependencies, inspect a brick's public interface, and detect interface-bypass violations.

When should I use Polylith Dependency Visualization?

Polylith Dependency Visualization fits situations like: what depends on what; interface violation.

How do I install Polylith Dependency Visualization in Claude Code?

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

How do I install Polylith Dependency Visualization in Codex?

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

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

What does Polylith Dependency Visualization need to run?

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

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

Polylith Dependency Visualization 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 Visualization use?

About 906 tokens (SKILL.md is roughly 3.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 Visualization?

Skills that share tags, products or a category with Polylith Dependency Visualization: Visual Style (calesthio/OpenMontage, 65k stars), D3 Visualization (nexu-io/open-design, 100k stars), Dependency Scanning (sickn33/agentic-awesome-skills, 47k stars) and Dep (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Polylith Dependency Visualization?

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.