How do I confirm that the cycles are actually fixed?

The skill runs mix xref with a --fail-above 0 threshold, meaning the command will only succeed if zero cycles are detected, followed by a full project compilation.

What are compile-connected and compile labels?

These are mix xref graph labels that help identify modules that depend on each other at compile time. Running both ensures that all cycles in the compilation graph are identified and resolved.

Will this skill perform large-scale refactors?

No, the skill is designed to prioritize minimal changes. It prefers strategies like extracting shared logic into a helper module or moving specific functions rather than re-architecting the entire application.

Why does this skill require Elixir 1.19 or higher?

Elixir 1.19 introduced significantly more accurate detection for compile-time dependencies. Older versions may produce false positives or miss complex cycles in the dependency graph.

Elixir Cyclic Dependency Manager

Name: Elixir Cyclic Dependency Manager
Author: matteing

bymatteing

•

Developer Tools

Detects and resolves circular compile-time dependencies in Elixir projects using mix xref and structured refactoring.

This skill streamlines Elixir project maintenance by identifying and breaking cyclic compile-time dependencies. It utilizes the powerful mix xref tool—requiring Elixir 1.19 or higher—to map module relationships and provides a systematic approach to resolving cycles with minimal code disruption. By employing strategies like helper module extraction and dependency inversion, the skill helps developers achieve a zero-cycle baseline for faster compilation and cleaner architecture.

Key Features

01Minimal-change refactoring strategies including module splitting

0235 GitHub stars

03Automated mix xref graph analysis for compile-time cycles

04Support for existing project-specific cycle checking tasks

05Elixir 1.19+ version verification for accurate dependency mapping

06Verification via --fail-above 0 flag to ensure total cycle removal

Use Cases

01Fixing mix xref failures in CI/CD pipelines

02Optimizing project compilation speed by reducing module re-compilation

03Refactoring legacy Elixir codebases with complex circular references

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add matteing/opal elixir-cyclic-deps

For use in Claude.ai and ChatGPT

Download Skill