gradle-settings-plugin

Implement a data-object pattern for Gradle settings plugins.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Gradle settings plugins often require boilerplate for a SettingsExtension, plugin wiring via rootProject, and consistent conventions. This skill provides a standardized data-object pattern to encapsulate constants, SettingsExtension, and a SettingsPlugin, reducing boilerplate and potential errors.

Core Features & Use Cases

  • Data-object pattern: a single data object contains constants, the SettingsExtension, and the SettingsPlugin.
  • Root-project wiring: demonstrates wiring tasks through settings.gradle.rootProject to promote configuration avoidance.
  • Convention wiring & safety: shows how to apply conventions compatible with the Gradle lifecycle and configuration cache.
  • Use case: when creating or updating Gradle settings plugins, this pattern streamlines setup and long-term maintenance.

Quick Start

Follow the pattern to scaffold a Gradle settings plugin using a data-object structure.

Frequently Asked Questions about gradle-settings-plugin

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

FAQPage Schema
How do I create a Gradle settings plugin using a data-object pattern in Kotlin?

The data-object pattern for Gradle settings plugins encapsulates constants, a SettingsExtension with @Inject, and a SettingsPlugin in a single Kotlin data object to reduce boilerplate and wiring errors.

How do I wire rootProject tasks in a Gradle settings plugin for configuration avoidance?

Wiring tasks through settings.gradle.rootProject in a Gradle settings plugin promotes configuration avoidance by ensuring task registration happens safely at the root project level during the build lifecycle.

Does the Gradle settings plugin data-object pattern work with configuration cache?

Yes, the Gradle settings plugin data-object pattern applies conventions compatible with the Gradle lifecycle and configuration cache by standardizing SettingsExtension wiring and plugin registration safely.

When do I need a settings plugin for a multi-project Gradle build?

You need a Gradle settings plugin for a multi-project Gradle build when applying consistent conventions across subprojects requires centralized rootProject task registration and a standardized SettingsExtension.

What is the best way to reduce boilerplate in Gradle settings plugin convention wiring?

The best way to reduce boilerplate in Gradle settings plugin convention wiring is using a Kotlin data-object pattern to standardize SettingsExtension creation and rootProject task registration.