ameba-configuration

Configure Ameba lint rules and generate .ameba.yml for Crystal projects.

187|20|Updated Nov 20, 2025
One-click install
npx skills add https://github.com/TheBushidoCollective/han --skill ameba-configuration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ameba-configuration
Source: https://github.com/TheBushidoCollective/han/tree/main/jutsu/jutsu-ameba/skills/ameba-configuration
Command: npx skills add https://github.com/TheBushidoCollective/han --skill ameba-configuration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enforcing consistent Crystal code style and catching issues across a Crystal project helps maintain quality and readability.

Core Features & Use Cases

  • .ameba.yml generation and rule configuration
  • Globs and Excludes to target code correctly
  • Rule categories with severity levels

Quick Start

Generate a default .ameba.yml and tweak UnusedArgument and other rules for your project.

Frequently Asked Questions about ameba-configuration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure Ameba to enforce code style in a Crystal project?

Ameba configuration enforces Crystal code style through a .ameba.yml file that defines lint, style, and performance rules with severity levels. Generate a default config with `ameba --gen-config`, then customize rule enablement, file globs, and exclusions to match your project's standards.

What's the difference between Ameba's lint, style, and performance rule categories?

Ameba organizes rules into three categories: Lint rules catch code errors and potential bugs, Style rules enforce consistent formatting conventions, and Performance rules identify inefficient code patterns. Each category applies different severity levels to guide developers on issue priority.

Can I exclude specific files or directories from Ameba linting?

Yes, Ameba's .ameba.yml supports both Globs to target code paths and Excluded to skip files and directories. You can also disable specific rules inline within your code and configure per-rule exclusions like ExcludeEmptyBlocks for fine-grained control.

How do I disable Ameba rules for specific code sections?

Ameba supports inline rule disabling within Crystal source code, allowing you to suppress specific rules for particular code blocks. Configure per-rule options in .ameba.yml to set Enabled status and Severity levels, or disable rules temporarily where they conflict with your intent.

Does Ameba automatically fix code style violations?

Ameba supports auto-correction across multiple Crystal codebases, allowing it to automatically fix detected style and performance issues. Run Ameba with auto-correct flags to apply fixes, then review and commit the changes to standardize code across your project.

Can I apply the same Ameba configuration across multiple Crystal projects?

Yes, Ameba's .ameba.yml configuration is portable and can be reused across multiple Crystal codebases. Share a base configuration across projects and customize Globs and rule severities per repository to enforce consistent standards while adapting to project-specific needs.