AI Skill Ecosystem — Ruby Core Skills

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 --> core

Framework 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-skills

or with yarn (tessl.io):

yarn tessl i igmarin/ruby-core-skills

Or with skills.sh:

npx skills add igmarin/ruby-core-skills

Or 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 project

License

This project is licensed under the MIT License. See LICENSE for details.