gradle-composite-builds

Wire Gradle composite builds with includeBuild and dependency substitution across repositories.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/ClankerGuru/opsx --skill gradle-composite-builds
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gradle-composite-builds
Source: https://github.com/ClankerGuru/opsx/tree/main/cli/src/main/resources/content/skills/gradle-composite-builds
Command: npx skills add https://github.com/ClankerGuru/opsx --skill gradle-composite-builds

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinating multiple Gradle repositories requires manual wiring of included builds and careful dependency substitution. This skill automates the wrkx pattern for includeBuild wiring, workspace configuration, and cross-repo development.

Core Features & Use Cases

  • Wire composite builds via settings.includeBuild with automated repository discovery and optional substitution maps to local projects.
  • Enable dependency substitution across included builds to route artifacts to local outputs for rapid iteration.
  • Discover included projects through reflection where needed, with lifecycle-aware activation in settingsEvaluated and rootProject phases.
  • Validate and sanitize build names, skip missing clones, and guard against double-apply to maintain stable builds.

Quick Start

Enable the wrkx workspace configuration for your project and run a Gradle build to apply the composite-build wiring.

Frequently Asked Questions about gradle-composite-builds

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Gradle composite builds across multiple repositories?▼

You can automate Gradle composite builds by applying includeBuild wiring and dependency substitution across multiple repositories. This skill uses settingsEvaluated and reflection to discover included projects and route artifacts to local outputs.

How does dependency substitution work in a Gradle composite build workspace?▼

Dependency substitution in a Gradle composite build routes external artifacts to local project outputs. This enables rapid cross-repo iteration by automatically swapping published dependencies for local included builds.

How do I wire includeBuild in Gradle for cross-repo development?▼

You wire includeBuild in Gradle by applying automated repository discovery and optional substitution maps to local projects. The skill activates lifecycle-aware wiring during settingsEvaluated and rootProject phases.

What happens if a repository clone is missing in a Gradle composite build?▼

If a repository clone is missing, the composite build configuration skips it automatically. The skill guards against missing clones and double-apply scenarios to maintain stable builds.

Does Gradle composite build wiring require unique build names?▼

Yes, Gradle composite build wiring requires unique sanitized build names. The skill validates and enforces unique names during project discovery to prevent naming conflicts.

When do I need Gradle composite builds instead of a single multi-project setup?▼

You need Gradle composite builds when coordinating multiple independent Gradle repositories into a coherent workspace. This approach enables cross-repo development with local project substitution without merging repositories.