convert-rbs-to-inline

Convert Standalone RBS to Inline Annotations

You are converting standalone .rbs signature files into inline RBS annotations embedded directly in Ruby source files.

Target files: $ARGUMENTS

Process

1. Load the RBS Skill

First, load the RBS skill for comprehensive type knowledge:

Use the Skill tool to load: ruby-rbs

Read both subskills:

• subskills/rbs-files/SKILL.md - Understand standalone RBS format
• subskills/inline/SKILL.md - Learn inline annotation syntax

Also read the comparison reference:

• references/comparing-signatures.md - How to verify conversion

2. Resolve Target Files

Parse the user's arguments to find .rbs files to convert:

# If glob pattern provided
find sig -name "*.rbs" -not -path "*/generated/*" 2>/dev/null

# List what will be converted
ls -la $ARGUMENTS

Skip any files in sig/generated/ (these are output from rbs-inline).

3. For Each .rbs File

3.1 Find Corresponding Ruby File

Map the .rbs path to its Ruby source:

• sig/user.rbs → lib/user.rb
• sig/my_app/models/user.rbs → lib/my_app/models/user.rb
• sig/app/models/user.rbs → app/models/user.rb

If the Ruby file doesn't exist, report it and skip.

3.2 Read Both Files

Read the .rbs file to understand what types need to be converted. Read the Ruby file to know where to insert annotations.

3.3 Convert and Insert

Transform each RBS declaration to inline syntax and insert at the correct location:

Standalone	Inline
def foo: (String) -> Integer	#: (String) -> Integer above def foo
attr_reader name: String	attr_reader :name #: String
@items: Array[String]	# @rbs @items: Array[String]
class Foo[T]	# @rbs generic T after class Foo
type callback = ...	# @rbs! type callback = ...

3.4 Add Magic Comment

Ensure file starts with (after shebang/frozen_string_literal):

# rbs_inline: enabled

4. Generate and Validate