Skip to content

Make rails-docs and tailwind-docs derive version dynamically - #747

Merged
mattlindsey merged 1 commit into
mainfrom
update_docs_skills_dynamic_versioning
Jul 30, 2026
Merged

Make rails-docs and tailwind-docs derive version dynamically#747
mattlindsey merged 1 commit into
mainfrom
update_docs_skills_dynamic_versioning

Conversation

@mattlindsey

Copy link
Copy Markdown
Collaborator

Summary

  • Follow-up to Add Rails official documentation skill #746 (already merged), which added rails-docs, hotwire-docs, and tailwind-docs skills.
  • rails-docs and tailwind-docs hardcoded version-specific claims ("this project pins Rails 8.0" / "pins Tailwind v3") that would go stale silently the moment either dependency is bumped, with nothing to flag it.
  • Both skills now instruct Claude to determine the actual version at query time instead:
    • rails-docs: greps Gemfile.lock for the installed rails version and builds the versioned guide/API URLs from that.
    • tailwind-docs: checks for config/tailwind.config.js (v3-style JS config) vs @theme in the stylesheets (v4-style CSS config) to determine which docs to consult.
  • No functional app code touched — skill instructions only.

Test plan

  • N/A — documentation/skill-only change, no app code touched.

Hardcoded version claims (Rails 8.0, Tailwind v3) go stale the moment
the project upgrades and nothing flags it. Both skills now instruct
Claude to check Gemfile.lock / repo structure at query time instead,
so they stay correct across future version bumps without edits.
@mattlindsey
mattlindsey marked this pull request as ready for review July 30, 2026 14:32
@mattlindsey
mattlindsey merged commit ad47c7b into main Jul 30, 2026
6 checks passed
@mattlindsey
mattlindsey deleted the update_docs_skills_dynamic_versioning branch July 30, 2026 14:32
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