tyler-dot-earth

Patdown — Git skill for Claude Code

Git community

Block, steer, and "fuzzy lint" with Jev to make agents follow your rules and conventions.

How to install Patdown

This entry records only its repository, not the path inside it, so there is no exact command to give. Open tyler-dot-earth/patdown and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Patdown does

Block, steer, and "fuzzy lint" with Jev to make agents follow your rules and conventions. CLI, github action, pi package, claude extension, and more. Built with Effect + TypeScript.

Alternatives in Git

Claude Code Action — A general-purpose Claude Code action for GitHub PRs and issues that can answer questions and implement code ch 6.6k ★
Create Pull Request — by liam-hq - Provides comprehensive PR creation guidance with GitHub CLI, enforcing title conventions, followi 4.7k ★
Brooks Review — Run a Brooks-Lint PR code review 1.5k ★

README

patdown

Standalone CLI that lints a tree against fuzzy rules in one markdown file. Wrap it as a hook, plugin, or extension.

The judge is swappable. The default backend uses Effect `Decision` / `DecisionModel` with TypeSafe; rules and CLI commands use a provider-neutral interface.

Install

npx patdown --help
pnpm add -D patdown

Requires Node.js >=22.22.2. The library entry is `patdown`; rule adapters import `@patdown/rules`. Optional agent packages: `@patdown/pi` (Pi write steering) and `@patdown/claude` (Claude Code Write/Edit hooks). See [Pi write steering](docs/pi.md) and [Claude Code plugin](docs/claude.md).

For GitHub Actions, prefer the composite action over copy-paste yaml:

- uses: tyler-dot-earth/patdown@v0.7.0
  env:
    TYPESAFE_API_KEY: ${{ secrets.TYPESAFE_API_KEY }}

See [GitHub Actions](docs/github-actions.md). The action always runs the published CLI. Custom report shapes stay an embed of `runPatdownCli` with your own `PatdownOutput` layer ([Custom output](#custom-output)), not an action input.

Requirements

Node.js **>=22.22.2** and pnpm **11.8.0**. CI runs checks and built-CLI smoke tests on Node 22.22.2 and Node 24. Releases through v0.2.2 require Node >=24.18.0 and use `#/` import aliases that Node 22 rejects.

Commands

From this repo, prefer the workspace script. It builds `patdown` through Turborepo (`dependsOn: build`) and then runs the CLI from your current directory:

pnpm -w patdown
pnpm -w patdown -- --rules ./rules.md
pnpm -w patdown -- --rules ./packs/typescript --verbose
pnpm -w patdown -- rules
pnpm -w patdown -- doctor
pnpm -w patdown -- ask "Is this markdown heading title case?" --input-text "# Hello World"
pnpm -w patdown -- ask "Is this urgent?" --input-text "ASAP" --verbose
pnpm -w patdown -- --yes-threshold 0.9
pnpm -w patdown -- --github-annotation warning
pnpm -w patdown -- --files src/cli.ts --files README.md
pnpm -w patdown -- --files src
pnpm -w patdown -- --files 'src/**/*.ts'
pnpm -