Kotlin Autocomplete Skill

You have access to accurate, project-specific Kotlin type information through autocomplete metadata generated by the kotlin-autocomplete-gradle-plugin.

When to Use This Skill

Use this skill when:

• •Writing Kotlin code and need to know what methods/properties are available on a type
• •The user asks "what can I do with X type?" or "what methods does X have?"
• •Verifying if a specific member exists on a type
• •Exploring Kotlin APIs (stdlib, coroutines, or project-specific)
• •You're unsure about method signatures or available extensions

How It Works

The autocomplete metadata is generated by running ./gradlew buildAutocomplete in a Kotlin project. This creates JSON files in build/autocomplete/ containing:

• •All public properties and methods with full signatures
• •Extension functions and properties
• •Both standard library and project-specific types

Querying Type Information

Use the helper script to query type information:

.claude/skills/scripts/kotlin-autocomplete-lookup.sh "fully.qualified.TypeName"

Examples:

# Standard library types
.claude/skills/scripts/kotlin-autocomplete-lookup.sh "kotlin.String"
.claude/skills/scripts/kotlin-autocomplete-lookup.sh "kotlin.collections.List"

# Coroutines types
.claude/skills/scripts/kotlin-autocomplete-lookup.sh "kotlinx.coroutines.flow.Flow"

# Project types
.claude/skills/scripts/kotlin-autocomplete-lookup.sh "com.example.User"

Response Format

When presenting autocomplete information, format it clearly:

Type: kotlin.String

Members:
- val length: kotlin.Int
- fun substring(startIndex: kotlin.Int): kotlin.String
- fun lowercase(): kotlin.String

Extensions:
- fun toSnakeCase(): kotlin.String
- val firstChar: kotlin.Char?

Total: 3 members, 2 extensions

Prerequisites

The Kotlin project must have:

1. •Applied the plugin in build.gradle.kts:
   kotlin

   plugins {
       id("com.lightningkite.kotlin-autocomplete") version "0.0.1-1"
   }
   

2. •Generated metadata: ./gradlew buildAutocomplete
3. •Metadata exists in build/autocomplete/ directory

Important Notes

• •Type names must be fully qualified: Use kotlin.String not String
• •Only public members are included: Internal and private members are excluded
• •Extensions on Any/Any? are filtered: Too generic to be useful
• •Fast lookups: Index-based queries are nearly instant

If Metadata Not Found

If autocomplete metadata doesn't exist:

1. •Suggest running ./gradlew buildAutocomplete
2. •Verify the plugin is applied
3. •Check if the type name is correct
4. •Fall back to general Kotlin knowledge, but note it may not be project-specific

Benefits

• •No hallucinations: All information comes from actual compiled code
• •Project-aware: Includes custom extensions and project types
• •Always up-to-date: Regenerate when code changes
• •Complete signatures: Full parameter types and return types

Example Workflow

User: "What can I do with a Flow?"

1. •Run: .claude/skills/scripts/kotlin-autocomplete-lookup.sh "kotlinx.coroutines.flow.Flow"
2. •Parse the output
3. •Present available operations in a clear format
4. •Suggest common patterns based on the available members

This ensures you provide accurate, project-specific Kotlin guidance!