🎯

markdownlint-custom-rules

🎯Skill

from thebushidocollective/han

What it does

Validates and enforces custom Markdown linting rules to ensure consistent documentation quality and style across projects.

markdownlint-custom-rules

Installation

Install skill:

npx skills add https://github.com/thebushidocollective/han --skill markdownlint-custom-rules

Last UpdatedJan 30, 2026

View on GitHub Back to Skills

Skill Details

SKILL.md

Overview

# Han

[![GitHub Release](https://img.shields.io/github/v/release/TheBushidoCollective/han)](https://github.com/TheBushidoCollective/han/releases)

Automatic quality gates for Claude Code. Every conversation ends with validation—linting, formatting, type-checking, and tests run automatically, catching issues before they ship.

Getting Started

Two commands. That's it.

```bash

# 1. Install the CLI

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

# 2. Auto-detect and install plugins for your project

han plugin install --auto

```

Next time you use Claude Code, validation hooks run automatically when you finish a conversation.

Alternative Installation

```bash

# Homebrew (macOS/Linux)

brew install thebushidocollective/tap/han

```

How It Works

Install - One command installs the CLI and auto-detects plugins for your stack
Code - Claude writes code as usual. No workflow changes needed
Validate - Stop hooks run automatically. Linters, formatters, type checkers, and tests are all verified
Learn - Local metrics track success rates and calibrate confidence. Nothing leaves your machine

Plugin Categories

139 plugins across four categories:

| Category | Description | Examples |

|----------|-------------|----------|

| Core | Essential infrastructure. Auto-installs han binary, provides metrics and MCP servers | Always required |

| Jutsu (Tools) | Validation plugins for your stack | TypeScript, Biome, Pytest, RSpec, ShellCheck |

| Dō (Agents) | Specialized AI agents | Code review, debugging, architecture, security |

| Hashi (Integrations) | MCP servers for external tools | GitHub, Playwright, Blueprints |

Browse all plugins at [han.guru/plugins](https://han.guru/plugins/)

Why It Works

Smart Caching - Only runs validation when relevant files change. Native Rust hashing keeps it fast
Local Metrics - Tracks task success and confidence calibration. All data stays on your machine
Zero Config - Binary auto-installs on first session. --auto flag detects your stack automatically
Any Stack - TypeScript, Python, Rust, Go, Ruby, Elixir. If there's a linter, there's a plugin

CLI Commands

```bash

# Install plugins

han plugin install # Interactive mode

han plugin install --auto # Auto-detect your stack

han plugin install # Install specific plugin

# Manage plugins

han plugin search # Search marketplace

han plugin uninstall # Remove plugin

# Run hooks manually

han hook run # Run a specific hook

han hook explain # Show configured hooks

# MCP server

han mcp # Start MCP server for natural language hook execution

```

Documentation

Full documentation at [han.guru/docs](https://han.guru/docs/)

Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for how to create new plugins.

License

MIT License - see [LICENSE](LICENSE)

---

Built by [The Bushido Collective](https://thebushido.co)

More from this repository10

🎯

scala functional patterns🎯Skill

Validates and enforces functional programming best practices and patterns in Scala code, ensuring idiomatic use of immutability, pattern matching, higher-order functions, and type-safe transformati...

🎯

erlang otp behaviors🎯Skill

Validates and enforces correct implementation of Erlang OTP (Open Telecom Platform) behaviors like gen_server, supervisor, and application, ensuring code follows standard patterns and best practice...

🎯

checkstyle-rules🎯Skill

checkstyle-rules skill from thebushidocollective/han

🎯

gitlab-ci-artifacts-caching🎯Skill

gitlab-ci-artifacts-caching skill from thebushidocollective/han

🎯

shell-scripting-fundamentals🎯Skill

shell-scripting-fundamentals skill from thebushidocollective/han

🎯

gleam erlang interop🎯Skill

Enables seamless interoperability between Gleam and Erlang, allowing Gleam code to directly call and interact with Erlang functions and libraries.

🎯

cypress-advanced🎯Skill

Validates and runs advanced Cypress end-to-end testing configurations, performing comprehensive test suite execution, coverage analysis, and automated quality checks for web application testing wor...

🎯

jutsu-bun:bun-runtime🎯Skill

Validates and runs runtime checks for Bun.js projects, ensuring code quality and runtime integrity during Claude Code interactions.

🎯

ecto-schema-patterns🎯Skill

Validates and enforces best practices for Elixir Ecto database schema definitions, ensuring consistent and idiomatic schema structure across database models.

🎯

nestjs-dependency-injection🎯Skill

Validates and enforces proper dependency injection practices in NestJS applications, ensuring correct module, provider, and injection token configurations during Claude Code conversations.