Skip to content

skills: Add Herb install and ERB lint/format skills for LLM agents#1745

Open
lucianghinda wants to merge 1 commit into
marcoroth:mainfrom
lucianghinda:lg/skills-for-herb
Open

skills: Add Herb install and ERB lint/format skills for LLM agents#1745
lucianghinda wants to merge 1 commit into
marcoroth:mainfrom
lucianghinda:lg/skills-for-herb

Conversation

@lucianghinda
Copy link
Copy Markdown

Adds two skills under skills/ that help LLM agents work with Herb in Rails projects.

  • skills/herb-install-rails/ — idempotent install/configure flow with bin/herb-rails-doctor (preflight), bin/herb-rails-setup (Gemfile + .herb.yml + CI workflow with both Ruby and Node setup, plus uninstall), and bin/herb-rails-write-config.rb (deep-merge writer that preserves user-set keys, Ruby 2.6+ compatible).

  • skills/herb-erb-lint-format/ — inner-loop contract for editing ERB: lint + actionview check + format after every edit, with explicit npx fallback when the gem binary is missing and a note that actionview check has no npm equivalent.

Adds two skills under skills/ that help LLM agents work with Herb in
Rails projects. Built via test-driven skill authoring: baseline subagent
scenarios surfaced concrete failure modes (missing framework: actionview,
CI lacking Node and actionview check, lint giving up on missing binary
instead of trying npx, grep used instead of herb actionview graph),
which the skills explicitly address with rationalization tables and red
flag lists. Re-tested with the same scenarios after the rewrite and both
agents now comply.

- skills/herb-install-rails/ — idempotent install/configure flow with
  bin/herb-rails-doctor (preflight), bin/herb-rails-setup (Gemfile +
  .herb.yml + CI workflow with both Ruby and Node setup, plus uninstall),
  and bin/herb-rails-write-config.rb (deep-merge writer that preserves
  user-set keys, Ruby 2.6+ compatible).

- skills/herb-erb-lint-format/ — inner-loop contract for editing ERB:
  lint + actionview check + format after every edit, with explicit npx
  fallback when the gem binary is missing and a note that actionview
  check has no npm equivalent.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@lucianghinda lucianghinda marked this pull request as draft May 23, 2026 08:15
@lucianghinda
Copy link
Copy Markdown
Author

@marcoroth here is a draft of adding two skills to Herb following our conversation in Rimini. I split the idea of skills in two:

  1. One script to help setup Herb for a Rails app - this one has some scripts inside
  2. One script that should be invoked by any LLM (with skill support) and that teaches the LLM how to use Herb while implementing features.

I marked this as draft because I need a bit of feedback from you in a couple of directions:

  1. In case you agree with the idea of a skill that teaches an LLM to install herb that has few additional scripts and here I have a question if those scripts should be inside the skill or be part of Herb itself.
  2. In case the scripts for installing Herb remains remain part of the skill I need to write some tests for them and so the question will be where to put those tests in the test folder (which path)?
  3. Of course any other feedback about the wording of the skill will be helpful

@lucianghinda lucianghinda marked this pull request as ready for review May 23, 2026 12:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant