Skip to content

Community call: shared skills for the Rails community - #151

Open
AFornio wants to merge 1 commit into
rubyuy:mainfrom
AFornio:skills-para-rails
Open

Community call: shared skills for the Rails community#151
AFornio wants to merge 1 commit into
rubyuy:mainfrom
AFornio:skills-para-rails

Conversation

@AFornio

@AFornio AFornio commented Aug 14, 2026

Copy link
Copy Markdown

Context

Most of us already have a CLAUDE.md, a .cursorrules or something similar sitting in a project, with our rules for specs, for security, for performance. They are roughly the same rules, written many times over, each copy slightly different and none of them reviewed by anyone else.

This proposes keeping the good ones in one place instead.

What it adds

A /skills/ section linked from the home page: one page per skill, grouped by category, with a raw view and a copy button. No author attribution, skills belong to the community. Seeded with rspec-tests-for-rails.

The call

Draft on purpose, the interesting part is which skills we want and what goes in them, not the code. To add one: drop the document in _skills/<name>.md and add its entry to _data/skills.yml. Categories are open too.

Screenshots

Screenshot 2026-08-17 at 9 16 42 AM Screenshot 2026-08-17 at 9 16 46 AM

QA steps

  1. Go to /skills/, check the search filters the cards
  2. Open the skill, switch between Markdown and Raw, hit Copy

Comment thread _data/skills.yml
Skills are markdown documents that coding agents (Claude Code and
friends) load as instructions. This adds a place to publish the ones
the community agrees on, so nobody has to rewrite them per project.

Each skill is a single file in _skills/, rendered at /skills/<name>/
with a markdown viewer, a raw view and a copy button. Skills are
grouped by category and are not attributed to an author: they belong
to the community.

Entries can be tagged as a skill or a rule via the type field, shown
as a badge on the card. Seeded with one rule for writing RSpec specs.
@AFornio
AFornio force-pushed the skills-para-rails branch from 41738e3 to 644f246 Compare August 17, 2026 12:16
@AFornio
AFornio marked this pull request as ready for review August 17, 2026 12:18
@AFornio
AFornio requested a review from a team as a code owner August 17, 2026 12:18
@AFornio
AFornio requested a review from delbetu August 18, 2026 12:33
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.

2 participants