igmarin/hanakai-yaku
Curated library of atomic AI agent skills for Hanami, dry-rb, and ROM Ruby development. Covers actions, slices, repositories, relations, changesets, providers, DI, operations, TDD, CLI, views, routing, and validation. Shared Ruby process skills have moved to ruby-core-skills. Uses Markdown + Front-matter architecture.
92
94%
Does it follow best practices?
Impact
92%
1.33xAverage score across 35 eval scenarios
Passed
No known issues
integration-matrix.mddocs/reference/
Integration Matrix — hanakai-yaku
Integration matrix: which skill connects to which and in what order.
Complete Agent Loop
Hanami Setup
graph TD
A[New Project] --> B[Phase 1: Context Loading]
B --> C[Phase 2: Provider Config]
C --> D[Phase 3: DI Implementation]
D --> E[Phase 4: Verification]
E --> F[Setup Complete]Full Pipeline
load-context → configure-providers → implement-di → verifyIntegrations by Skill
load-context
| Next | When |
|---|---|
| configure-providers | After context, to set up or verify providers |
| implement-di | After context, to implement DI patterns |
| hanami-setup | First step in project onboarding |
configure-providers
| Next | When |
|---|---|
| implement-di | After provider setup, inject into consumers |
| hanami-setup | Part of the onboarding workflow |
implement-di
| Next | When |
|---|---|
| (Write tests) | After DI, write specs with test doubles |
| (Implement) | After DI and tests, implement the feature |
Quick Decision Matrix
New to the project?
└─ load-context → discover structure
Need a new service?
└─ configure-providers → implement-di
Full project setup?
└─ hanami-setup (agent)Checkpoints and Gates
| Name | Type | Defined in | Purpose |
|---|---|---|---|
| Context Loaded | gate | load-context, hanami-setup | Don't proceed without knowing app structure |
| Providers Verified | gate | configure-providers, hanami-setup | All providers must boot without errors |
See Also
- Skill Catalog — Complete skills list
- Agent Guide — Agent workflows with Mermaid diagrams
docs
evals
scenario-1
scenario-2
scenario-3
scenario-4
scenario-5
scenario-6
scenario-7
scenario-8
scenario-9
scenario-10
scenario-11
scenario-12
scenario-13
scenario-14
scenario-15
scenario-16
scenario-17
scenario-18
scenario-19
scenario-20
scenario-21
scenario-22
scenario-23
scenario-24
scenario-25
scenario-26
scenario-27
scenario-28
scenario-29
scenario-30
scenario-31
scenario-32
scenario-33
scenario-34
scenario-35
skills
actions
build-json-api
create-action
handle-errors
validate-params
context
load-context
db
create-changeset
create-repository
define-relation
write-migration
dry-monads
handle-result-pattern
dry-rb
create-operation
create-validation-contract
providers
configure-providers
implement-di
review-security
routing
define-routes
slices
configure-slice
create-slice
extract-slice
review-slice-boundaries
test-slice