Documentation/Validation/Ameba
✅

Ameba

v1.10.0

Ameba skills for Crystal code analysis

validationskillhook

Installation

Install han binary (required for hooks to work):

curl -fsSL https://han.guru/install.sh | bash

Then install this plugin:

han plugin install ameba

Overview

Ameba skills for Crystal code analysis and linting.

Skills

This plugin provides the following skills:

  • Ameba Configuration - Setting up and customizing Ameba rules
  • Ameba Custom Rules - Creating custom linting rules
  • Ameba Integration - Integrating Ameba into CI/CD pipelines

Usage

Once enabled, Claude will automatically apply these skills when working with relevant code. The plugin provides context and expertise that Claude uses to:

  • Write idiomatic code following best practices
  • Suggest appropriate patterns and architectures
  • Catch common mistakes and anti-patterns
  • Provide framework-specific guidance

Installation

Install with npx (no installation required):

bash
han plugin install jutsu-ameba

Skills

📖

ameba-configuration

Use when configuring Ameba rules and settings for Crystal projects including .ameba.yml setup, rule management, severity levels, and code quality enforcement.

📖

ameba-custom-rules

Use when creating custom Ameba rules for Crystal code analysis including rule development, AST traversal, issue reporting, and rule testing.

📖

ameba-integration

Use when integrating Ameba into development workflows including CI/CD pipelines, pre-commit hooks, GitHub Actions, and automated code review processes.

Hooks

⚠ī¸

Token Usage Notice

Hooks run automatically during Claude Code sessions and their output is sent to the model for processing. This may increase token usage and associated costs. Consider disabling hooks you don't need via han-config.yml.

🛑

Stop

Runs when the main Claude Code agent has finished responding. Can verify task completion, check quality gates, or ensure documentation requirements are met before the session ends.