Home / alexhawat / mergecraft · skills/mergecraft/SKILL.md · GitHub

mergecraft skillA

Name: mergecraft
Author: alexhawat

mergecraft is agent-read markdown (skill) from alexhawat/mergecraft: Set up, run, and troubleshoot mergeCraft — the BYOK AI PR review GitHub Action and CLI. Use when the user asks to install or configure mergeCraft, add AI PR review to a repo, run a local review, interpret mergecraft-approval status or findings, configure models in .mergecraft/config.yaml, use mergecraft mcp serve, or debug a failing mergeCraft workflow..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# mergeCraft

mergeCraft is an AI-powered PR reviewer: a GitHub Action plus a Python CLI
(`mergecraft`). BYOK — the user's Claude/ChatGPT subscription or API key; no
SaaS backend. Deterministic analyzers run first, then an LLM review agent, then
a read-only verifier; typed findings drive inline comments and the
`mergecraft-approval` commit status.

## Setup checklist (new consumer repo)

1. **Prereqs:** Python **3.11+**, uv, authenticated `gh` CLI. If no Python 3.11+
   locally → use the Docker Action only ([`docs/install.md`](../../docs/install.md)).
2. **Install:**

   ```bash
   uv tool install "merge-craft @ git+https://github.com/alexhawat/mergeCraft"
   mergecraft init
   ```

3. **Authentication — STOP and ask the user.** Use `mergecraft provider list`
   to find the configured provider label or id from `init`. Authenticate that
   entry with `mergecraft provider auth <label-or-id> --scope local` for local
   evaluation, or `--scope github` to adopt GitHub Actions. Examples below assume
   these provider labels are configured:
   - `mergecraft provider auth anthropic --scope github` (Claude Pro/Max)
…

Read the whole file at its exact version.

How to install

Latest version

mdr add alexhawat/mergecraft/mergecraft@git:20260921.fc1ed4b

Exact content

mdr add alexhawat/mergecraft/mergecraft@sha256:b0e5bb842b866495

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

[![mdr](https://markdownregistry.com/badge/art_eia7f7zlhqx5gfl2.svg)](https://markdownregistry.com/a/art_eia7f7zlhqx5gfl2)

1 badge views in 30 days

Versions

version	committed	commit	size	audit
git:20260921.fc1ed4b latest	2026-09-21	fc1ed4b	6,315 B	A	view · diff
git:20260907.ffa694a	2026-09-07	ffa694a	6,183 B	A	view · diff
git:20260824.af064e0	2026-08-24	af064e0	5,038 B	A	view · diff
git:20260822.bb511f4	2026-08-22	bb511f4	4,270 B	A	view · diff
git:20260820.b4d451a	2026-08-20	b4d451a	4,226 B	A	view

Audit of the latest version

A 17 of 17 checks passed. Deterministic, no model, same answer every run.

pass: Frontmatter block present
pass: Frontmatter declares a name
pass: Frontmatter declares a description
pass: Size between 200 bytes and 200 KB (6315 bytes)
pass: No zero-width or bidi control characters
pass: No instruction hidden inside an HTML comment
pass: No link to an exfiltration or paste host
pass: No credential-shaped string
pass: No instruction to send local credentials anywhere
pass: No text hidden with inline styles
pass: No prompt-injection phrasing
pass: No curl or wget piped into a shell
pass: No recursive delete of root, home or parent
pass: No instruction to read or print local credentials
pass: No base64 blob over 200 characters
pass: No link to a raw IP address
pass: No script tag

Source

GitHub

alexhawat/mergecraft · 11 stars · license MIT · pushed 2026-09-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_eia7f7zlhqx5gfl2
GET https://markdownregistry.com/api/v1/resolve?ref=alexhawat/mergecraft/mergecraft
GET https://markdownregistry.com/api/v1/blob/b0e5bb842b866495d2c628784eff60fcdb78891093eafb69134cfd49b0f0b2d3

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from alexhawat/mergecraft

code-review skill

alexhawat/mergecraft · .github/skills/code-review/SKILL.md · Reviews a pull request or diff in the mergeCraft repository and produces typed, evidence-backed findings with a…

git:20260910.99ce63d · audit A · 11 stars

AGENTS.md agents

alexhawat/mergecraft · AGENTS.md

git:20260922.3ffdd69 · audit A · 11 stars

llms-full.txt llmstxt

alexhawat/mergecraft · llms-full.txt

git:20260922.3ffdd69 · audit B · 11 stars

llms.txt llmstxt

alexhawat/mergecraft · llms.txt

git:20260901.f17f2c3 · audit A · 11 stars