CtrlK
BlogDocsLog inGet started
Tessl Logo

igmarin/ruby-core-skills

Curated library of 16 public Ruby AI agent skills: 10 atomic skills (YARD docs, service objects, calculator pattern, API clients, DDD, bug triage, code review, skill routing), 5 process-discipline skills (TDD, refactoring, review, security, test planning), and 1 planning skill (TDD task generation). Zero agents — this is a foundational library consumed by framework-specific tiles like rails-agent-skills and hanakai-yaku.

95

1.05x
Quality

96%

Does it follow best practices?

Impact

95%

1.05x

Average score across 16 eval scenarios

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

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 repository is a core component of the multi-repo AI Skill Ecosystem:

  1. ruby-core-skills (This repository): Contains 16 foundational Ruby programming, planning, and software engineering process-discipline skills. Contains zero agents.
  2. rails-agent-skills: Curated library of Rails-specific skills + 9 specialized agents that compose core processes.
  3. hanakai-yaku: Curated library of Hanami-specific skills + 10 specialized agents.
  4. agnostic-planning-skills: Generic project management, planning, and task breakdown skills + 4 agents.
  5. agent-mcp-runtime: The Rust-based CLI runtime that acts as the composition and resolution engine.

Dependency Direction

flowchart BT
    subgraph core["ruby-core-skills"]
        direction LR
        process["process skills"]
        atomic["atomic skills"]
    end

    rails["rails-agent-skills<br/>(skills+agents)"]
    hanakai["hanakai-yaku<br/>(skills+agents)"]
    agnostic["agnostic-planning-skills<br/>(skills+agents)"]

    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

ChatGPT Claude Cursor GitHub Copilot Google Gemini OpenCode Windsurf

PRs Welcome License: MIT CodeRabbit Pull Request Reviews tessl

Skill Inventory

SkillCategoryDescription
define-domain-languageDDDExtracting ubiquitous language or glossary definitions.
review-domain-boundariesDDDAuditing context boundaries and language leakage.
model-domainDDDTactical DDD design (aggregates, entities, value objects, domain services).
write-yard-docsDocumentationWriting or reviewing inline YARD documentation for public Ruby APIs.
create-service-objectPatternsCreating a service object (PORO .call pattern).
implement-calculator-patternPatternsImplementing polymorphic variant-based calculators (Strategy + Factory).
integrate-api-clientPatternsDesigning HTTP integrations (layered client/fetcher/builder pattern).
triage-bugTestingInvestigating a bug, reproducing via failing test, and creating a repair plan.
respond-to-reviewCode QualityReceiving code review feedback and addressing comments.
skill-routerOrchestrationTriaging and decomposing complex Ruby requests into ordered sub-tasks.
generate-tdd-tasksPlanningBreaking features into TDD quadruplet task lists with docs and review tasks.
tdd-processProcessGeneral engineering loop: Red-Green-Refactor process gates and checkpoints.
refactor-processProcessSafely refactoring code while preserving behavior under characterization tests.
review-processProcessReviewing changesets (severity taxonomies, structured findings, re-review).
security-review-processProcessReviewing code for general Ruby security flaws (secrets, injections).
test-planning-processProcessChoosing test boundaries (unit vs integration) and test scenarios.

Installation & Usage

Core skills are consumed by AI agents via the agent-mcp-runtime CLI tool.

During development, you can point the runtime to this local directory using the --registry flag:

agent-mcp-runtime --registry ./path/to/ruby-core-skills --task "Review this code"

In production, the runtime uses the central registry.json manifest to resolve dependencies automatically. When running a framework pack, the runtime loads the framework's own skills first, falling back to core skills for any general Ruby concerns:

# Resolves Rails agents/skills first, then falls back to core skills
agent-mcp-runtime --pack rails --task "Add full_name to User model"

License

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

Workspace
igmarin
Visibility
Public
Created
Last updated
Publish Source
CLI
Badge
igmarin/ruby-core-skills badge