Skip to content

Agent Skills

Agent Skills are markdown files that provide context, instructions, and examples for an AI agent on how to use specific sets of tools effectively. They help the agent understand the best practices, common workflows, and troubleshooting steps for the tools provided by the Gradle MCP server.

How to Include Skills in Your Project

Agent skills should be installed into a directory where your calling agent can find and use them (e.g., its .claudemdc directory for Claude, or a specific skills directory).

The easiest way to include these skills is by using the install_gradle_skills tool provided by this MCP server. Simply tell your agent to do so.

Alternative: Using Context7's Skills Registry

If you prefer using an external registry and CLI, you can use the Context7 Skills Registry. Context7 provides a dedicated registry and CLI for discovering, installing, and managing MCP skills from GitHub repositories.

To install the Gradle MCP skills using the Context7 CLI:

npx ctx7 skills install /rnett/gradle-mcp --all

For more information, see the Context7 Skills documentation.

Manual Inclusion

Alternatively, you can manually include the SKILL.md files from the skills/ directory in your project's documentation or context folder (e.g., .claudemdc for Claude or similar directories for other agents).

We recommend pointing your agent to the GitHub repository if it has web browsing capabilities, or copying the relevant SKILL.md files into your project root.

Future distribution: MCP server

The MCP spec working group is working on adding support for distributing agent skills as part of an MCP server. Once that is available, we will use it to distribute our skills.

Included Skills

The following skills are included in the skills/ directory of the repository:

  • running_gradle_builds: Manages the full Gradle build lifecycle authoritatively with high-performance background execution and failure analysis.
  • running_gradle_tests: Executes and diagnoses tests at scale with high-precision filtering and authoritative failure isolation.
  • managing_gradle_dependencies: Manages and audits project dependency graphs authoritatively, performing high-resolution update checks.
  • introspecting_gradle_projects: Uncovers the full structure of any Gradle project authoritatively, mapping modules and configurations.
  • searching_dependency_sources: Explores and navigates the internal implementation of any library or Gradle itself authoritatively.
  • interacting_with_project_runtime: Prototypes logic and executes Kotlin code interactively within your project's full runtime context authoritatively.
  • researching_gradle_internals: Navigates official Gradle documentation, release notes, and version-specific guides expertly.
  • verifying_compose_ui: Visually verifies Compose UI components and previews authoritatively by instantly rendering them to images.
  • gradle_expert: Senior Build Engineer specializing in Gradle build scripts, dependency management, and build performance optimization.