ruby-type-signature-skills

Ruby Type Signature Skills

AI agent skills for generating and maintaining Ruby type signatures. Supports both RBS and Sorbet type systems with inline and separate file styles.

Overview

This plugin provides four model-invoked skills and one agent for working with Ruby type signatures.

Skills

Skill	Description	Output
generating-rbs	Generate RBS type signatures	Separate .rbs files in sig/ directory
generating-rbs-inline	Generate RBS inline annotations	# @rbs comments in .rb files
generating-sorbet	Generate Sorbet RBI files	Separate .rbi files in rbi/ directory
generating-sorbet-inline	Generate Sorbet inline signatures	sig {} blocks in .rb files

Agents

Agent	Description
update-signatures	Auto-detect signature system and style, update signatures for changed files

Installation

Claude Code

From GitHub Marketplace (Recommended):

/plugin marketplace add DmitryPogrebnoy/ruby-agent-skills
/plugin install ruby-type-signature-skills

Manual Installation:

# Global installation
git clone https://github.com/DmitryPogrebnoy/ruby-agent-skills.git ~/.claude/plugins/ruby-agent-skills

# Project-specific installation
git clone https://github.com/DmitryPogrebnoy/ruby-agent-skills.git .claude/plugins/ruby-agent-skills

OpenAI Codex

Codex CLI loads skills from .codex/skills/ directories. See the Codex skills documentation for details.

Invoke skills explicitly using $generating-rbs, $generating-rbs-inline, $generating-sorbet, or $generating-sorbet-inline.

Other AI Agents

Skills follow the Open Agent Skills Standard. Integrate the SKILL.md files into your agent's knowledge base.

How to Use

Skills are model-invoked - the AI automatically uses them based on your request. Example prompts:

Generate RBS signatures for lib/user.rb
Add inline Sorbet signatures to app/models/
Update type signatures for changed files

Plugin Structure

ruby-agent-skills/
├── .claude-plugin/
│   └── marketplace.json          # Marketplace configuration
├── plugins/
│   └── ruby-type-signature-skills/
│       ├── .claude-plugin/
│       │   └── plugin.json       # Plugin manifest
│       ├── agents/
│       │   └── update-signatures.md
│       └── skills/
│           ├── generating-rbs/
│           │   └── SKILL.md
│           ├── generating-rbs-inline/
│           │   └── SKILL.md
│           ├── generating-sorbet/
│           │   └── SKILL.md
│           └── generating-sorbet-inline/
│               └── SKILL.md
├── LICENSE
├── README.md
└── THIRD_PARTY_LICENSES.md

Contributing

Contributions welcome! Please submit issues and pull requests at GitHub.

License

MIT License - see LICENSE for details.