// Review a Kiso component for quality and consistency. Runs the 12-point checklist against shadcn source, design system rules, and deliverables. Use on a PR, branch, or working directory.
Build UIs with Kiso — accessible Rails UI components with Tailwind CSS theming. Use when creating interfaces, customizing themes, building forms, or composing page layouts in Rails + Hotwire apps.
Kiso component conventions and development workflow. Points to the right docs for building, reviewing, and shipping components.
Audit all documentation for staleness after code changes. Checks docs site, CLAUDE.md, skills references, contributing skill, agents, and project/ files. Use after completing a feature, merging a PR, or when asked to check docs.
Guide through releasing a new version of kiso. Use when cutting a release, publishing a new version, or running bin/release.
Build a Kiso component from scratch. Reads shadcn/Nuxt UI sources, creates theme module, ERB partials, Lookbook previews, docs, E2E tests. Use when building a new component or picking up where a previous attempt left off.
Agentic Component Factory — build multiple Kiso components in parallel using builder and reviewer agents in isolated worktrees. Usage: /factory #47 #48 or /factory #47 #48 #49 (pass issue numbers)
| name | component-review |
| description | Review a Kiso component for quality and consistency. Runs the 12-point checklist against shadcn source, design system rules, and deliverables. Use on a PR, branch, or working directory. |
Review a Kiso component against the established quality standards.
Read project/component-review.md — this is the authoritative checklist.
It contains the 12-point review, common mistakes, and report format.
Identify the component to review:
gh pr diff {N} to read the changesRead the shadcn source for comparison:
vendor/shadcn-ui/apps/v4/registry/new-york-v4/ui/{name}.tsx
Run every check in the checklist. Report PASS or FAIL with specific details.
Run lint and tests:
bundle exec standardrb --check lib/kiso/themes/{name}.rb
bundle exec rake test
npm run lint && npm run fmt:check
npm run test:unit
npm run test:e2e
Report findings using the table format from project/component-review.md.
If empowered to fix issues: make the changes, run lint/tests, and commit
with fix: address review feedback for {ComponentName}.