Orchestrates Hanami project onboarding: loads application context, configures providers, implements dependency injection patterns, and verifies the setup. Use when setting up a new Hanami project, onboarding a developer, configuring services and DI, or wiring up dry-container, dry-system, IoC containers, or Hanami app configuration with providers and dependency injection.
Use when implementing authentication in Hanami 2.x, including login, logout, signup, session management, password hashing, and protecting endpoints. Sets up login/logout flows, configures session-based or token-based auth, adds password hashing with bcrypt, and returns correct 401/403 responses for auth failures. Use when a user asks about auth, login, signup, JWT, sessions, passwords, or securing Hanami actions.
Orchestrates the full Hanami slice lifecycle: creates the slice, tests it in isolation, reviews boundary design, and supports extraction from the app module. Use when building a new Hanami slice, auditing existing slices for bounded context violations, extracting monolithic code into a modular architecture, or enforcing slice generator conventions. Trigger terms: bounded context, Hanami module, modular architecture, slice boundaries, slice extraction, slice generator.
Use when implementing a Hanami 2.x feature, Hanami action, Hanami slice, or any Hanami controller logic using test-driven development (TDD / red-green-refactor). Orchestrates test planning, generates request specs or action unit specs, drives the implementation of Hanami action classes and route configurations, and performs a final code review. Use when starting a new Hanami feature from scratch, adding integration tests for an existing Hanami action, or following a red-green-refactor cycle for any Hanami 2.x component.
Use when implementing validation with dry-validation contracts, schemas, or form/input/params validation in Hanami 2.x. Injects dependencies, validates request params using dry-validation contracts, handles monadic Success/Failure result patterns, and writes action specs. Chains inject-dependencies, validate-params, handle-result-pattern, and write-action-spec.
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
hanakai-yaku turns AI coding assistants into disciplined Hanami collaborators.
A curated library of 35 atomic skills and 10 personas for Hanami, dry-rb, and ROM Ruby development that teach AI tools how to configure providers, implement dependency injection, write TDD tests, create repositories, design slices, and build operations — using Hanami conventions.
Status: Experimental — used to validate skill format portability across Ruby frameworks. Not actively maintained as a product. For production Rails AI tooling, see rails-ai-bridge.
The project is built around one non-negotiable rule:
Write test -> Run test -> Verify it FAILS for the right reason -> Implement -> Verify it PASSES
That TDD gate is encoded directly into the skills and personas.
This repo is one of 6 in a composable AI skill ecosystem:
| Repo | Role |
|---|---|
ruby-core-skills | 15 shared Ruby skills + process discipline |
rails-agent-skills | 28 Rails-specific skills + 9 agents |
hanakai-yaku | 35 Hanami/dry-rb skills + 10 personas |
agnostic-planning-skills | 10 planning skills + 4 personas |
agent-mcp-runtime | Rust CLI runtime (pack resolution, MCP) |
ruby-skill-bench | Benchmark/eval engine |
See the Ecosystem Overview for the full architecture.
This repo depends on ruby-core-skills. See Migration Guide.
Supported agent environments
| Reader | What you get | | Hanami developers | AI-assisted Hanami development: slices, repositories, operations, actions, views. | | dry-rb users | Guidance on operations, validation contracts, DI patterns, and type-safe design. | | ROM users | Repository patterns, relation design, changeset composition, migration safety. | | Team leads | Repeatable workflows for Hanami onboarding, TDD discipline, and slice architecture. |
Install skills via tessl.io:
npx tessl i igmarin/hanakai-yaku
or with yarn
yarn dlx tessl i igmarin/hanakai-yaku
Install skills via skills.sh:
npx skills add igmarin/hanakai-yaku
Or via GitHub CLI (v2.90.0+):
# Install the dependency first
gh skill install igmarin/ruby-core-skills
# Install all skills interactively
gh skill install igmarin/hanakai-yaku
# Install a specific skill
gh skill install igmarin/hanakai-yaku load-context --scope project
Or use directly as chat commands (@skill-name) in compatible AI tools (OpenCode, Cursor, Claude Code, Gemini CLI, Windsurf).
| Area | Purpose |
|---|---|
skills/ | Atomic Hanami skills organized by category: context, providers, actions, persistence, dry-rb, testing, slices, views. |
skills/personas/ | Orchestrating personas that chain skills into guided workflows. |
docs/ | Architecture, Persona guide, reference catalog, and calling conventions. |
CONTEXT.md | Domain glossary — the canonical vocabulary for Hanami concepts. |
Skills are invoked via chat commands:
Curated library of AI agent skills for Ruby on Rails development. Includes code review, architecture, security, testing (RSpec), engines, service objects, DDD patterns, and workflow automation.
npx claudepluginhub igmarin/hanakai-yakuDesign fluency for frontend development. 1 skill with 23 commands (/impeccable polish, /impeccable audit, /impeccable critique, etc.) and curated anti-pattern detection.
Lazy senior dev mode. Forces the simplest, shortest solution that actually works: YAGNI, stdlib first, no unrequested abstractions.
Behavioral guidelines to reduce common LLM coding mistakes, derived from Andrej Karpathy's observations on LLM coding pitfalls
Comprehensive skill pack with 66 specialized skills for full-stack developers: 12 language experts (Python, TypeScript, Go, Rust, C++, Swift, Kotlin, C#, PHP, Java, SQL, JavaScript), 10 backend frameworks, 6 frontend/mobile, plus infrastructure, DevOps, security, and testing. Features progressive disclosure architecture for 50% faster loading.
Develop, test, build, and deploy Godot 4.x games with Claude Code. Includes GdUnit4 testing, web/desktop exports, CI/CD pipelines, and deployment to Vercel/GitHub Pages/itch.io.
Access thousands of AI prompts and skills directly in your AI coding assistant. Search prompts, discover skills, save your own, and improve prompts with AI.