igmarin/ruby-core-skills
Curated library of 16 public Ruby AI agent skills covering TDD, refactoring, code review, security review, DDD, YARD documentation, and common design patterns.
94
96%
Does it follow best practices?
Impact
94%
1.13xAverage score across 16 eval scenarios
Advisory
Suggest reviewing before use
AI Skill Ecosystem — Ruby Core Skills
Shared Ruby development skills and process-discipline knowledge for the AI skill ecosystem. This repository contains framework-agnostic foundations for TDD, refactoring, code review, security review, DDD, inline documentation, and common Ruby design patterns.
Part of the AI Skill Ecosystem
This repo is one of 6 in a composable AI skill ecosystem:
| Repo | Role |
|---|---|
ruby-core-skills | 16 shared Ruby skills + process discipline |
rails-agent-skills | 28 Rails-specific skills + 9 orchestrator workflows |
hanakai-yaku | 35 Hanami/dry-rb skills + 10 orchestrator workflows |
agnostic-planning-skills | 10 planning skills + 4 orchestrator workflows |
agent-mcp-runtime | Rust CLI runtime (pack resolution, MCP) |
ruby-skill-bench | Benchmark/eval engine |
See the Ecosystem Overview for the full architecture.
Dependency Direction
flowchart BT
subgraph core["ruby-core-skills"]
direction LR
process["process skills"]
atomic["atomic skills"]
end
rails["rails-agent-skills<br/>(atomic+orchestrator)"]
hanakai["hanakai-yaku<br/>(atomic+orchestrator)"]
agnostic["agnostic-planning-skills<br/>(atomic+orchestrator)"]
rails --> core
hanakai --> core
agnostic --> coreFramework repos depend on core skills. ruby-core-skills does not know about any downstream frameworks.
Supported agent environments
Skill Inventory
| Skill | Category | Description |
|---|---|---|
| define-domain-language | DDD | Extracting ubiquitous language or glossary definitions. |
| review-domain-boundaries | DDD | Auditing context boundaries and language leakage. |
| model-domain | DDD | Tactical DDD design (aggregates, entities, value objects, domain services). |
| write-yard-docs | Documentation | Writing or reviewing inline YARD documentation for public Ruby APIs. |
| create-service-object | Patterns | Creating a service object (PORO .call pattern). |
| implement-calculator-pattern | Patterns | Implementing polymorphic variant-based calculators (Strategy + Factory). |
| integrate-api-client | Patterns | Designing HTTP integrations (layered client/fetcher/builder pattern). |
| triage-bug | Testing | Investigating a bug, reproducing via failing test, and creating a repair plan. |
| respond-to-review | Code Quality | Receiving code review feedback and addressing comments. |
| skill-router | Orchestration | Triaging and decomposing complex Ruby requests into ordered sub-tasks. |
| generate-tdd-tasks | Planning | Breaking features into TDD quadruplet task lists with docs and review tasks. |
| tdd-process | Process | General engineering loop: Red-Green-Refactor process gates and checkpoints. |
| refactor-process | Process | Safely refactoring code while preserving behavior under characterization tests. |
| review-process | Process | Reviewing changesets (severity taxonomies, structured findings, re-review). |
| security-review-process | Process | Reviewing code for general Ruby security flaws (secrets, injections). |
| test-planning-process | Process | Choosing test boundaries (unit vs integration) and test scenarios. |
Installation & Usage
Install skills via tessl.io:
npx tessl i igmarin/ruby-core-skillsor with yarn (tessl.io):
yarn tessl i igmarin/ruby-core-skillsOr with skills.sh:
npx skills add igmarin/ruby-core-skillsOr via GitHub CLI (v2.90.0+):
# Install all skills interactively
gh skill install igmarin/ruby-core-skills
# Install a specific skill
gh skill install igmarin/ruby-core-skills tdd-process --scope projectLicense
This project is licensed under the MIT License. See LICENSE for details.
- Workspace
- igmarin
- Visibility
- Public
- Created
- Last updated
- Publish Source
- CLI
- Badge