sm-host-setup

Automate SourceMonitor engine integration into Rails 8 host applications.

3|Updated Oct 16, 2025
One-click install
npx skills add https://github.com/dchuk/source_monitor --skill sm-host-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sm-host-setup
Source: https://github.com/dchuk/source_monitor/tree/main/.claude/skills/sm-host-setup
Command: npx skills add https://github.com/dchuk/source_monitor --skill sm-host-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Use when integrating the SourceMonitor engine into a host Rails application, covering gem installation, engine mounting, migration copying, initializer creation, and verifying the install works.

Core Features & Use Cases

  • Guided installer that performs mounting, initializer creation, and migrations.
  • Manual setup path for hosts needing fine-grained control over installation.
  • Post-install verification checks to ensure the dashboard is reachable.

Quick Start

Run the guided installer from your host Rails app root and follow the prompts to mount the engine, install dependencies, and verify the setup.

Frequently Asked Questions about sm-host-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate a Rails engine into an existing host app?

You can integrate a Rails engine into a host app using a guided installer that handles gem installation, engine mounting, migration copying, and initializer creation. The installer runs idempotently and includes post-install verification to ensure the dashboard works.

What does mounting a Rails engine do in a host application?

Mounting a Rails engine in a host application exposes the engine's routing and features, such as a monitoring dashboard. The setup process also copies required migrations and generates an initializer to ensure the engine functions correctly within the host app's environment.

Can I manually configure engine mounting instead of using a guided installer?

Yes, a manual setup path is available for hosts needing fine-grained control over the installation. This allows you to manually handle gem installation, engine mounting, migration copying, and initializer configuration instead of relying on the automated guided installer.

How do I verify a Rails engine installation works in my host app?

You verify a Rails engine installation by running built-in post-install checks to ensure the dashboard is reachable. This verification step confirms that the mounting, migrations, and initializer setup were applied successfully to your host application.

Does this Rails engine installer support upgrade scenarios for Rails 8?

Yes, the installer applies to new or existing Rails 8 host applications and covers upgrade scenarios. It uses an idempotent installer to handle migration, configuration, and verification steps, ensuring a working dashboard even when upgrading.