Agent skill

Layered Rails

by evilmartians in evilmartians/redprints-cfp

Write, refactor, and review Rails code using layered architecture principles from "Layered Design for Ruby on Rails Applications".

No licenceAuto-check passedBackend & APIs

Install Layered Rails

skills CLI
$ npx skills add evilmartians/redprints-cfp --skill layered-rails -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install evilmartians/redprints-cfp layered-rails --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/evilmartians/redprints-cfp.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/layered-rails .claude/skills/layered-rails && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
layered-rails
GitHub stars
108
Used in
1 other repo
Token cost
~4.1k tokens
SKILL.md length
1,239 words
Files
59 (incl. references)
Skills in repo
1
Repo updated
First seen
Licence
None found

At a glance

Write, refactor, and review Rails code using layered architecture principles from "Layered Design for Ruby on Rails Applications".

  • Works in 6 steps: Analyzing a codebase — apply the… → Reviewing code changes — run the code… → Running the specification test — use the… → …
  • Refactoring Rails code — models
  • SKILL.md covers Quick Start, What this skill is for, Workflows and Core Principles, plus 9 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Layered Rails is an agent skill from evilmartians/redprints-cfp. Write, refactor, and review Rails code using layered architecture principles from "Layered Design for Ruby on Rails Applications". Use when writing or refactoring Rails code — models, controllers, services, jobs, mailers, policies, forms, query objects, presenters, view components, state machines, serializers, or AI/LLM features — to apply correct patterns and avoid layer violations; and when reviewing Rails code, PRs, or diffs for layer violations, fat controllers/models, anemic models, callback misuse, god…

Its SKILL.md is about 4.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 62 other files, including reference files (for example `examples/authorization-to-policy.md`, `examples/callbacks-to-service.md` and `examples/complex-input-to-form-object.md`).

It sits in Backend & APIs, covering Backend development and Refactoring. It works with Ruby on Rails. The repository describes itself as: A redprint for a CFP app built with Rails and Inertia.js.

When your agent uses it

  • Refactoring Rails code — models
  • View components
  • AI/LLM features — to apply correct patterns and avoid layer violations
  • When reviewing Rails code

Example prompts

  • “Layered Design for Ruby on Rails Applications”
  • “layered design”
  • “architecture layers”
  • “/layered-rails”

Requirements

  • Pre-approved tools (allowed-tools): Grep, Glob, Read, Task

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Analyzing a codebase — apply the architecture analysis for a full audit, or zoom in with the service-layer audit, callback analysis, or…
  2. Reviewing code changes — run the code review workflow on a diff, file, or branch.
  3. Running the specification test — use the spec-test workflow on a single file or directory to evaluate whether code belongs in its current…
  4. Planning gradual adoption — generate a phased roadmap with the layerification plan workflow, focused on a goal like "introduce…
  5. Planning a feature — I'll apply the layered principles below to whichever code you're about to write.
  6. Implementing a specific pattern — authorization, notifications, view components, AI integration, etc. — see the Pattern Catalog and Topic…

What it can do on your machine

Read from SKILL.md and the folder at commit 6080fc2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Grep
    • Glob
    • Read
    • Task

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are ruby).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • skills.sh

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Layered Rails loads about 4.1k tokens when it runs, and up to ~58k if it reads all its reference files. Until then it costs about 252 tokens; SKILL.md has 1,239 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~252
When it runs · the whole SKILL.md, loaded when a task matches
~4.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~58k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 1,239 words (~4,081 tokens).

“Design and review Rails applications using layered architecture principles.”

— opening of SKILL.md by evilmartians
name
layered-rails
allowed-tools
Grep, Glob, Read, Task

Read the full SKILL.md on GitHub

Files

SKILL.md and 58 other files (references) in .agents/skills/layered-rails of evilmartians/redprints-cfp.

  • SKILL.md
  • examples/authorization-to-policy.md
  • examples/callbacks-to-service.md
  • examples/complex-input-to-form-object.md
  • examples/current-from-model.md
  • examples/god-object-decomposition.md
  • examples/implicit-to-explicit-state-machine.md
  • examples/query-to-query-object.md
  • examples/view-logic-to-presenter.md
  • references/anti-patterns/callbacks.md
  • references/anti-patterns/concerns.md
  • references/anti-patterns/helpers.md
  • references/anti-patterns/jobs.md
  • references/anti-patterns/layer-violations.md
  • references/anti-patterns/service-objects.md
  • references/anti-patterns/testing.md
  • references/core/architecture-layers.md
  • … and 42 more

Open the folder on GitHubat commit 6080fc2

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in evilmartians/redprints-cfp, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Layered Rails next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Layered Rails compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Layered Rails this skillevilmartians/redprints-cfp1081 repos~4.1kAutomated safety check: PassNone
Antipattern Preventiondoorkeeper-gem/doorkeeper5.5k—~1.1kAutomated safety check: PassMIT
Rails ArchitectureThibautBaissac/rails_ai_agents665—~1.5kAutomated safety check: PassMIT
Rubyericrisco/rsc-harness180—~3.2kAutomated safety check: PassMIT
Engineering PrinciplesAzure/agent-app-orchestrator103—~282Automated safety check: PassMIT
Spring Data Jparrezartprebreza/spring-boot-skills301—~3kAutomated safety check: PassMIT

Similar skills

  • Antipattern Prevention

    doorkeeper-gem/doorkeeper

    Avoid common Ruby and Rails antipatterns that degrade maintainability and performance.

    5.5k GitHub stars~1.1k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Rails Architecture

    ThibautBaissac/rails_ai_agents

    Guides modern Rails 8 code architecture decisions and patterns.

    665 GitHub stars~1.5k tokensUpdated 4 mo ago
    DevelopmentAuto-check passed
  • Ruby

    ericrisco/rsc-harness

    A skill your agent uses when writing or refactoring plain Ruby outside Rails — scripts, CLIs, gems, libraries: Enumerable chains and blocks, module mixins and value objects, Bundler/gemspec…

    180 GitHub stars~3.2k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Engineering Principles

    Azure/agent-app-orchestrator

    Official

    Agent Landing Zone Orchestrator architecture and implementation principles.

    103 GitHub stars~282 tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Spring Data Jpa

    rrezartprebreza/spring-boot-skills

    A skill your agent uses when generating or refactoring Spring Boot 4 JPA entities, repositories, queries, projections, persistence tests, entity relationships, embeddables, IDs, or Hibernate mappings.

    301 GitHub stars~3k tokensUpdated 19 days ago
    Backend & APIsAuto-check passed
  • Build Backend

    hashgraph-online/awesome-codex-plugins

    Build or modify backend APIs, services, jobs, persistence, and integrations while preserving contracts, authorization, data integrity, and failure behavior.

    1.3k GitHub stars~410 tokensUpdated yesterday
    Backend & APIsAuto-check passed

Works with

Questions about Layered Rails

What does Layered Rails do?

Write, refactor, and review Rails code using layered architecture principles from "Layered Design for Ruby on Rails Applications". Layered Rails is an agent skill from evilmartians/redprints-cfp. Write, refactor, and review Rails code using layered architecture principles from "Layered Design for Ruby on Rails Applications".

When should I use Layered Rails?

Layered Rails fits situations like: refactoring Rails code — models; view components; AI/LLM features — to apply correct patterns and avoid layer violations; when reviewing Rails code.

How do I install Layered Rails in Claude Code?

Run `npx skills add evilmartians/redprints-cfp --skill layered-rails -a claude-code`. Or copy the skill folder (.agents/skills/layered-rails in evilmartians/redprints-cfp) into .claude/skills/layered-rails in your project. Claude Code loads it when a task matches its description.

How do I install Layered Rails in Codex?

Run `npx skills add evilmartians/redprints-cfp --skill layered-rails -a codex`. Or copy the skill folder (.agents/skills/layered-rails in evilmartians/redprints-cfp) into .agents/skills/layered-rails in your project. Codex loads it when a task matches its description.

Can I use Layered Rails in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add evilmartians/redprints-cfp --skill layered-rails -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/layered-rails, .gemini/skills/layered-rails, .github/skills/layered-rails and .opencode/skills/layered-rails in your project.

What does Layered Rails need to run?

SKILL.md names no scripts, command-line tools or credentials: Layered Rails is instructions for the agent only. Its frontmatter pre-approves these tools: Grep, Glob, Read, Task.

Does Layered Rails access the network?

SKILL.md names 1 domain. As links in the text: skills.sh. This is read from the text; nothing was executed.

Is Layered Rails safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Layered Rails use?

No licence was found for Layered Rails or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Layered Rails use?

About 4.1k tokens (SKILL.md is roughly 16k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 54k tokens, read only when the agent opens those files.

What are the alternatives to Layered Rails?

Skills that share tags, products or a category with Layered Rails: Antipattern Prevention (doorkeeper-gem/doorkeeper, 5.5k stars), Rails Architecture (ThibautBaissac/rails_ai_agents, 665 stars), Ruby (ericrisco/rsc-harness, 180 stars) and Engineering Principles (Azure/agent-app-orchestrator, 103 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Layered Rails?

evilmartians (a GitHub organization) maintains it in evilmartians/redprints-cfp, which has 108 GitHub stars. The repository was last updated on July 29, 2026.

Source: evilmartians/redprints-cfp on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.