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.

1.05x

Quality

96%

Does it follow best practices?

Impact

95%

1.05x

Average score across 16 eval scenarios

Securityby

Passed

No known issues

Module README Template

Name: igmarin/ruby-core-skills
Rating: 95.13 (1 reviews)
Author: igmarin

Every service module under app/services/<module_name>/ MUST ship a README.md using this shape. One section per service in the module — even single-service modules get a README.

# <ModuleName> Services

Brief paragraph: what business capability this module covers.

## <ServiceName>

**Purpose:** one-line summary.

**Inputs:** `params [Hash]` with `:key1`, `:key2`, ...

**Success:** `{ success: true, response: { <domain_key>: <value> } }`

**Failure:** `{ success: false, response: { error: { message: String } } }`

**Raises:** `SomeError` when ..., `OtherError` when ... (internally rescued unless noted).

Notes

Keep response shapes consistent with the MANDATORY Response Contract in SKILL.md.
List exception classes even when rescued internally — readers need the full surface.
For class-only services (Pattern 3, e.g. validators), document the actual return type (nil / error string) instead of the success/failure hash if that's what the class returns.