---

name: reflect description: Push improvements back to Kotlin Multiplatform Skills source repository. Use after encountering issues with KMP, Android, iOS, Ktor, Koin, or SQLDelight skills. allowed-tools:

• Read
• Write
• Edit
• Glob
• Grep
• Bash
• AskUserQuestion

---

Reflect — Kotlin Multiplatform Skills

Capture learnings from the current session and push improvements back to the kotlin-kmp-skills source repository.

When to Use

Run /kotlin-kmp:reflect when you've:

• Encountered API mismatches (wrong Kotlin APIs, deprecated patterns)
• Discovered undocumented KMP patterns
• Found workflow improvements for shared/platform modules
• Fixed common error patterns that should be documented

Workflow

┌─────────────────────────────────────────────────────────────┐
│  Current Session                                            │
│                                                             │
│  1. Analyze conversation for improvements                   │
│  2. Pre-check: Compare installed vs latest version          │
│     - If outdated → prompt to update first                  │
│     - If current → continue                                 │
│  3. Locate kotlin-kmp-skills repo                           │
│  4. Show proposed changes for approval                      │
│  5. Apply changes to skill files                            │
│  6. Commit and push to origin                               │
│  7. Update plugin in current project                        │
│     - Run: /plugin marketplace update kotlin-kmp-skills     │
│  8. Verify new version is installed                         │
└─────────────────────────────────────────────────────────────┘

Process

Step 1: Version Check

Before analyzing improvements, check if the installed plugin is up-to-date:

# Compare installed version with latest in source repo
# If outdated, prompt user to update first to avoid duplicate changes

If outdated:

The installed kotlin-kmp plugin is outdated. Please update first:

  /plugin marketplace update kotlin-kmp-skills

Then run /kotlin-kmp:reflect again.

Step 2: Analyze Context

Review the current conversation for:

Category	Look For
API Mismatches	Wrong function signatures, deprecated APIs used
Missing Documentation	Undocumented patterns discovered during work
Workflow Improvements	Better approaches found for common tasks
Error Patterns	Common mistakes that should have warnings
Template Updates	Outdated code templates that needed fixes

Step 3: Locate Source Repository

Find the kotlin-kmp-skills repository:

1. Check KOTLIN_KMP_SKILLS_REPO environment variable
2. Default to ~/Projects/personal/kotlin-kmp-skills
3. Clone from GitHub if not present locally:

   git clone git@github.com:pddhkt/kotlin-kmp-skills.git
   

Step 4: Propose Changes

Show the user what will be updated:

## Proposed Skill Improvements

### kmp/reference/expect-actual.md
- Add iOS-specific actual implementation for FileSystem
- Update Gradle configuration for KMP 2.0

### sqldelight/reference/schema.md
- Fix migration syntax for nullable columns

### Reasoning
During this session, we encountered build failures because the
expect/actual skill was missing the iOS FileSystem implementation.

---
Proceed with these changes? (y/n)

Step 5: Apply Changes

After user approval:

1. Navigate to source repo
2. Edit the relevant skill files under plugins/kotlin-kmp/
3. Create a descriptive commit:

   git commit -m "reflect: add iOS FileSystem actual, fix migration syntax
   
   - kmp/reference/expect-actual.md: Add iOS FileSystem implementation
   - sqldelight/reference/schema.md: Fix nullable column migration
   
   Source: Session reflection"
   

Step 6: Push to Origin

git push origin main

Step 7: Update Current Project

After pushing, update the plugin in the current project:

/plugin marketplace update kotlin-kmp-skills

Verify the new version is installed and the changes are reflected.

Step 8: Notify Team

Output a summary:

## Skills Updated Successfully

The following changes have been pushed to kotlin-kmp-skills:
- kmp/reference/expect-actual.md: Added iOS FileSystem actual
- sqldelight/reference/schema.md: Fixed migration syntax

Your local installation has been updated.

**For other team members:**
Run `/plugin marketplace update kotlin-kmp-skills` to get these improvements.

Configuration

Set a custom repository location:

# In your shell profile (~/.bashrc, ~/.zshrc)
export KOTLIN_KMP_SKILLS_REPO="/custom/path/to/kotlin-kmp-skills"

What Gets Captured

Good Candidates for Reflection

• API signature corrections
• Missing configuration steps discovered
• Better Kotlin/KMP patterns found
• Common errors and their fixes
• Updated Gradle configuration
• New expect/actual implementations

Not Captured

• Project-specific code
• Credentials or secrets
• Personal preferences (unless universally beneficial)
• Temporary workarounds