Run any Skill in Manus with one click

kotlin-api-consultant

Stars60

Forks6

UpdatedMarch 19, 2026 at 01:49

Queries Kotlin compiler source code for API validation, compatibility checks, and breaking change detection. Use when validating Kotlin compiler APIs, checking IrGenerationExtension compatibility, analyzing compiler plugin API usage, or verifying that an API hasn't been deprecated or removed in a newer Kotlin version. Make sure to use this skill whenever compiler plugin code references Kotlin internal APIs — these APIs change frequently between Kotlin versions and silent breakage is common.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

rsicarelli

rsicarelli/fakt

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

File Explorer

4 files

SKILL.md

readonly

name	kotlin-api-consultant
description	Queries Kotlin compiler source code for API validation, compatibility checks, and breaking change detection. Use when validating Kotlin compiler APIs, checking IrGenerationExtension compatibility, analyzing compiler plugin API usage, or verifying that an API hasn't been deprecated or removed in a newer Kotlin version. Make sure to use this skill whenever compiler plugin code references Kotlin internal APIs — these APIs change frequently between Kotlin versions and silent breakage is common.
allowed-tools	Read, Grep, Glob, Bash, WebFetch

Kotlin API Consultant

Validates Kotlin compiler API usage, detects breaking changes, and provides best practice recommendations for compiler plugin development.

Core Mission

Provides Kotlin compiler API validation by consulting source code, detecting breaking changes, and ensuring API compatibility across Kotlin versions.

Instructions

1. Identify Target API

Extract from conversation:

API class/interface name from user's message
Look for patterns: "check IrGenerationExtension", "validate IrPluginContext API"
Common APIs: IrGenerationExtension, IrPluginContext, IrFactory, IrClass, IrTypeParameter, CompilerPluginRegistrar

If unclear or missing:

Ask: "Which Kotlin compiler API would you like me to consult?"
Suggest: IrGenerationExtension | IrPluginContext | IrFactory | CompilerPluginRegistrar | Other

2. Locate API in Kotlin Compiler Source

Search Kotlin source on GitHub or local copy if available:

Common package locations:

org.jetbrains.kotlin.backend.common.extensions (IR extension APIs)
org.jetbrains.kotlin.ir.declarations (IR tree elements)
org.jetbrains.kotlin.ir.expressions (IR expressions)
org.jetbrains.kotlin.ir.types (Type system)
org.jetbrains.kotlin.fir (FIR APIs)
org.jetbrains.kotlin.compiler.plugin (Plugin registration)

If not found:

API '${API_NAME}' not found

Suggestions:
1. Check spelling (case-sensitive)
2. Check if it's an internal/experimental API
3. Consult: https://kotlinlang.org/docs/compiler-plugins.html

3. Analyze API Definition

Extract key information:

Package and imports
Interface/class declaration
Generic type parameters
Method signatures
Annotations (@UnsafeApi, @FirIncompatiblePluginAPI, @Deprecated)
Default implementations

Critical annotation markers:

@UnsafeApi                          // May change without notice
@FirIncompatiblePluginAPI          // K1 only, not K2
@Deprecated(message = "...", level = ERROR)  // Removal planned
@ExperimentalCompilerApi           // Unstable, may change

4. Detect Breaking Changes

Breaking change indicators:

Removed methods
Changed method signatures
Added abstract methods to interface
Changed return types
New required type parameters
Deprecation with ReplaceWith (migration path)

5. Generate API Report

KOTLIN API CONSULTATION: ${API_NAME}

LOCATION:
Package: org.jetbrains.kotlin...
Module: ...

DEFINITION (Kotlin ${VERSION}):
[Interface/class definition]

STABILITY: Stable / Experimental / Deprecated
K2 COMPATIBLE: Yes / No / Partial

FAKT USAGE:
- [How Fakt uses this API]
- [Alignment status]

WARNINGS:
- [Any @UnsafeApi warnings]
- [Deprecation notices]

RECOMMENDATIONS:
1. [Recommendation]
...

6. Provide Usage Recommendations

If API is stable: Safe to use directly. If API has @UnsafeApi: Consider abstraction layer for isolation. If API is deprecated: Show migration path with replacement API.

Supporting Files

resources/api-lookup-patterns.md - Strategies for finding APIs
resources/breaking-changes-catalog.md - Known breaking changes across Kotlin versions
resources/api-best-practices.md - Best practices for compiler plugin APIs

Related Skills

compiler-architecture-validator - Validate architectural patterns
compilation — Debug compilation errors
docs-navigator — Access documentation

API Categories

Category	Examples	Stability
Core IR	IrGenerationExtension, IrPluginContext	Stable
FIR Phase	FirExtensionRegistrar	K2 specific
Plugin System	CompilerPluginRegistrar	Stable
Type System	IrTypeParameter, IrType	Moderate
Experimental	Various @ExperimentalCompilerApi	Unstable

Validation Checklist

Before using an API in Fakt:

More from this repository

same repository

compilation

rsicarelli/fakt

Validates compilation of generated Fakt fakes and diagnoses build failures. Covers type safety, smart defaults, DSL typing, error classification, and root cause analysis. Use when compilation fails, generated code has errors, validating type safety, verifying changes compile before committing, or checking if generated code is valid. Make sure to use this skill whenever a build error mentions generated fakes or the Fakt plugin — even if the root cause might be elsewhere, this skill's error classification pinpoints the actual source.

2026-03-1960

bdd-test-runner

rsicarelli/fakt

Runs BDD-compliant GIVEN-WHEN-THEN tests, validates naming compliance, and analyzes coverage. Use when running tests, checking BDD compliance, validating test patterns, or verifying that test names follow GIVEN-WHEN-THEN conventions. Make sure to use this skill whenever tests need to be executed — it validates naming compliance and catches convention violations that plain test runners miss.

2026-03-0660

behavior-analyzer-tester

rsicarelli/fakt

Analyzes code behavior and generates comprehensive GIVEN-WHEN-THEN unit tests with vanilla JUnit5. Use when generating tests, analyzing behavior for test coverage, creating unit tests for Fakt components, or writing tests for new or modified code. Make sure to use this skill whenever new tests need to be written — it ensures BDD naming compliance, proper test isolation, and coverage of edge cases that are easy to overlook.

2026-03-0660

codegen

rsicarelli/fakt

Documents the Fakt code generation pipeline — immutable AST model, builder DSL, renderer, default value strategies, and extension functions. Use when modifying code generation, changing generated output, adding new generated patterns, understanding builders or renderers, adding a new default value strategy, or debugging generated output. Make sure to use this skill whenever generated Kotlin code needs to change — the pipeline has strict conventions (immutable AST, builder DSL, renderer separation) that must be followed even for small changes.

2026-03-0660

compiler-architecture-validator

rsicarelli/fakt

Validates Fakt follows compiler plugin best practices — two-phase FIR→IR, context-driven generation, CompilerPluginRegistrar structure. Use when validating architecture, checking plugin structure, reviewing compiler patterns, or verifying that FIR and IR phases remain properly separated. Make sure to use this skill whenever compiler plugin code is modified — phase mixing and registration issues are subtle bugs that only surface at runtime.

2026-03-0660

docs-navigator

rsicarelli/fakt

Navigates Fakt documentation — both internal contributor docs (.claude/docs/) and public MkDocs site (docs/). Use when looking for docs about architecture, testing, code generation, setup, troubleshooting, or any project convention. Make sure to use this skill whenever you need to find documentation — it knows the full doc tree structure and avoids wasting time searching in the wrong locations.

2026-03-0660