hyuga611

Reflint — Git skill for Claude Code

Git community

Reference-integrity CI linter for AGENTS.md / llms.txt / CLAUDE.md — fail the PR when agent config points at commands, scripts, or paths that no longer exist.

How to install Reflint

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

What Reflint does

Reference-integrity CI linter for AGENTS.md / llms.txt / CLAUDE.md — fail the PR when agent config points at commands, scripts, or paths that no longer exist. Language-agnostic, zero-dep.

Alternatives in Git

  • Awesome ChatGPT — Search awesome-ChatGPT-repositories for open-source GitHub repositories related to ChatGPT and LLMs 3.2k ★
  • Claude Code Reverse — GitHub Repo stars Reverse Engineering Claude Code with LLMs Reverse engineering research 2.2k ★
  • Merge Dependabot PRs — @description Evaluate and merge dependabot PRs with parallel builds, dependency-aware batching, and transitive 1.6k ★

README

reflint

![reflint fails CI with 3 broken references in AGENTS.md](docs/hero.svg)

One of three zero-dependency linters for AI-agent repos. To run all three in a single pass, with one report and one exit code, use **[tenken](https://github.com/hyuga611/tenken)** — `npx @hyuga/tenken`.

[![npm](https://img.shields.io/npm/v/@hyuga/reflint?color=cb3837&logo=npm)](https://www.npmjs.com/package/@hyuga/reflint) [![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE) [![zero dependencies](https://img.shields.io/badge/dependencies-0-brightgreen)](package.json)

**In any language, fail the PR when your `AGENTS.md`, `llms.txt`, or `CLAUDE.md` points at a command, script, or path that no longer exists.** `reflint` is a *reference-integrity* linter for agent config files. It doesn't grade style or prose — it checks whether the references are **real**: the scripts, paths, and files your config tells an AI agent to use. Zero-dependency, language-agnostic, runs in CI on every PR.

**`AGENTS.md` や `llms.txt` の中の「もう解決できない参照」を、どのスタックでも毎PRで落とす。** AIエージェント向け設定ファイルの **参照整合性 (reference integrity)** を CI で検証するリンタ。表記や文体ではなく、AIに渡す **"嘘の指示" そのもの** ── 存在しないコマンド・スクリプト・パス ── を落とす。依存ゼロ・言語非依存。


Why / なぜ

Agent config rots silently. When it tells the agent to run a script that was renamed, or points at a path that was deleted, the agent trusts it and breaks things. `reflint` fails CI before that happens. It checks *facts*, not prose — so it works in any stack (Go, Rust, Python, Ruby, JS…), and it treats `llms.txt` as a first-class target, which the rest of the ecosystem's format validators don't check for real references.

Use as a GitHub Action / CIで使う(定着の本体)

# .github/workflows/reflint.yml
name: reflint
on: [push, pull_request]
jobs:
  reflint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with: { fetch-depth: 0 }      # needed for the "new in this PR" diff
      - uses: hyuga611/reflint@v0     # auto-detects AGENTS.md / llms