When to use this skill
ALWAYS use this skill when the user mentions:
Searching for Maven dependencies or components Finding Maven coordinates (groupId, artifactId, version) Checking component versions or version history Retrieving Maven artifacts (JAR, POM, sources, Javadoc) Verifying Maven dependency coordinates Analyzing dependency trees or transitive dependencies Working with Maven Central Repository Any request related to Maven components, libraries, or dependencies
Trigger phrases include:
"查找 Maven 依赖" (find Maven dependency), "搜索 Maven 组件" (search Maven component) "Maven 坐标" (Maven coordinates), "groupId" (groupId), "artifactId" (artifactId) "Maven 版本" (Maven version), "最新版本" (latest version), "版本历史" (version history) "Maven Central" (Maven Central), "Maven 仓库" (Maven repository) "下载 Maven 依赖" (download Maven dependency), "获取 POM 文件" (get POM file) "依赖树" (dependency tree), "传递依赖" (transitive dependencies) Any mention of "Maven", "dependency", "artifact", "repository", "coordinates" How to use this skill
CRITICAL: This skill should be triggered when the user needs to search, retrieve, or work with Maven components from Maven Central Repository.
Trigger this skill when you see:
User says "查找 Maven 依赖" (find Maven dependency), "搜索 Maven 组件" (search Maven component) User needs Maven coordinates (groupId, artifactId, version) User wants to check component versions or retrieve artifacts User mentions Maven Central Repository or Maven dependencies User needs to analyze dependencies or verify coordinates
To search for Maven components:
Identify the search type from the user's request:
Search by name → Use Maven Central Search API Get specific version → Use direct repository URL Check latest version → Query maven-metadata.xml Analyze dependencies → Parse POM file Download artifact → Use direct download URL
Load the appropriate example file from the examples/ directory:
examples/search-by-name.md - Search components by name or keywords examples/search-by-coordinates.md - Search by groupId and artifactId examples/get-version-info.md - Get version information and history examples/download-artifact.md - Download JAR, POM, sources, or Javadoc examples/analyze-dependencies.md - Analyze dependency tree examples/verify-coordinates.md - Verify Maven coordinates validity
Follow the specific instructions in that example file for API endpoints, parameters, and best practices
Use Maven Central Repository API:
Search API (https://search.maven.org/solrsearch/select):
Query parameter: q - Search query (e.g., g:com.google.guava AND a:guava) Rows parameter: rows - Number of results (default: 20, max: 200) Start parameter: start - Pagination offset Core parameter: core - Search core (default: gav)
Direct Repository Access (https://repo1.maven.org/maven2/):
Path format: {groupId}/{artifactId}/{version}/{artifactId}-{version}.{extension} GroupId path: Replace dots with slashes (e.g., com.google.guava → com/google/guava) Metadata: maven-metadata.xml for version information POM file: {artifactId}-{version}.pom JAR file: {artifactId}-{version}.jar Sources: {artifactId}-{version}-sources.jar Javadoc: {artifactId}-{version}-javadoc.jar
Construct the appropriate URL:
Search Example:
https://search.maven.org/solrsearch/select?q=g:com.google.guava+AND+a:guava&rows=20&wt=json
Direct Access Example:
https://repo1.maven.org/maven2/com/google/guava/guava/maven-metadata.xml https://repo1.maven.org/maven2/com/google/guava/guava/33.0.0/guava-33.0.0.pom https://repo1.maven.org/maven2/com/google/guava/guava/33.0.0/guava-33.0.0.jar
Parse and format the results:
Extract relevant information (groupId, artifactId, version, description) Format coordinates in standard Maven format: groupId:artifactId:version Present results in a clear, structured format Include download links and metadata when relevant
Validate coordinates:
Verify groupId format (should be reverse domain notation) Check artifactId format (should be lowercase, hyphen-separated) Validate version format (semantic versioning preferred) Confirm artifact exists before providing download links
Output Format Requirements:
Always provide Maven coordinates in standard format: groupId:artifactId:version Include direct download URLs when relevant Format search results in a clear, structured table or list Provide metadata information (description, repository, last updated) when available Include version information and release dates when querying versions Maven Central Repository Structure Repository Base URL Primary: https://repo1.maven.org/maven2/ Search API: https://search.maven.org/solrsearch/select Alternative mirrors: Available for different regions Path Structure {groupId}/{artifactId}/{version}/{artifactId}-{version}.{extension}
Example:
com/google/guava/guava/33.0.0/guava-33.0.0.jar
Available Artifacts POM: {artifactId}-{version}.pom - Project Object Model file JAR: {artifactId}-{version}.jar - Compiled Java classes Sources: {artifactId}-{version}-sources.jar - Source code Javadoc: {artifactId}-{version}-javadoc.jar - API documentation Metadata: maven-metadata.xml - Version and release information Search API Parameters Query Syntax GroupId search: g:com.google.guava ArtifactId search: a:guava Version search: v:33.0.0 Combined search: g:com.google.guava AND a:guava Text search: guava (searches in groupId, artifactId, and description) Response Format JSON: wt=json (default) XML: wt=xml Java properties: wt=javabin Pagination rows: Number of results per page (default: 20, max: 200) start: Offset for pagination (default: 0) Best Practices Always verify coordinates: Check that groupId, artifactId, and version exist before use Use latest stable versions: Prefer RELEASE versions over SNAPSHOT versions Check version metadata: Query maven-metadata.xml for latest version information Validate before download: Verify artifact exists before providing download links Include checksums: When available, provide SHA-1 and MD5 checksums for verification Format coordinates correctly: Always use standard Maven format groupId:artifactId:version Provide context: Include description, repository information, and last updated date when available Common Tasks Task 1: Search by Name
Use the Search API with text query to find components by name or keywords.
Example:
GET https://search.maven.org/solrsearch/select?q=guava&rows=20&wt=json
Task 2: Search by Coordinates
Use the Search API with groupId and artifactId to find specific components.
Example:
GET https://search.maven.org/solrsearch/select?q=g:com.google.guava+AND+a:guava&rows=20&wt=json
Task 3: Get Version Information
Query maven-metadata.xml to get all available versions and latest version.
Example:
GET https://repo1.maven.org/maven2/com/google/guava/guava/maven-metadata.xml
Task 4: Download Artifact
Construct direct download URL for specific artifact.
Example:
GET https://repo1.maven.org/maven2/com/google/guava/guava/33.0.0/guava-33.0.0.jar
Task 5: Analyze Dependencies
Download and parse POM file to extract dependency information.
Example:
GET https://repo1.maven.org/maven2/com/google/guava/guava/33.0.0/guava-33.0.0.pom
Keywords
English keywords: maven, maven central, maven repository, maven dependency, maven artifact, maven component, groupId, artifactId, version, coordinates, pom, jar, dependency, repository, search, retrieve, download, metadata, transitive dependencies, dependency tree, maven coordinates, maven search
Chinese keywords (中文关键词): Maven, Maven 中央仓库, Maven 仓库, Maven 依赖, Maven 组件, Maven 坐标, groupId, artifactId, version, 版本, 坐标, POM, JAR, 依赖, 仓库, 搜索, 检索, 下载, 元数据, 传递依赖, 依赖树, 查找依赖, 搜索组件, 获取版本, 下载依赖
Resources Maven Central Repository: https://repo1.maven.org/maven2/ Maven Central Search: https://search.maven.org/ Maven Central Search API Documentation: https://central.sonatype.com/search-api/ Maven Coordinates Guide: https://maven.apache.org/guides/mini/guide-naming-conventions.html