Show HN: A linter and GitHub Action for CLAUDE.md, AGENTS.md and SKILL.md A read-only linter and GitHub Action called asitis, released at version 0.4.3 as the npm package @asitis/mcp, checks the instruction files coding agents read before starting work — CLAUDE.md, AGENTS.md, SKILL.md and related files — for vendor size limits, broken @imports, contradictory rules, instructions hidden in HTML comments or invisible characters, and SKILL.md frontmatter. In the project's examples/monorepo demo, asitis reports that a single CLAUDE.local.md disables Claude Code's AGENTS.md fallback, that the line "See @guide.md: for the review checklist" imports nothing because of the colon, and that Codex cuts packages/api/AGENTS.md after 6,332 of its 9,135 bytes against a 32,768-byte (32 KiB) budget shared across the chain. The tool installs as a Claude Code plugin, Codex plugin, Gemini CLI extension, Cursor MCP server, VS Code Copilot agent-mode MCP server, or via npx with no install. A read-only linter for CLAUDE.md, AGENTS.md, SKILL.md and the other files your coding agent reads before it starts work. Here is asitis loads on examples/monorepo https://github.com/Katta041/asitis-agent-tools/blob/main/examples/monorepo , a small made-up repo, run as its own git repo with 0.4.3. The footer about settings it can't see is trimmed: bash $ npx -y -p @asitis/mcp@0.4.3 asitis loads --tool claude-code What loads when a session starts in the project root local estimates, about 4 characters per token : Claude Code: about 37 tokens at launch from 2 files; 2 more files can load later up to about 39 tokens ; 2 not loaded At launch 1. CLAUDE.local.md, about 14 tokens, project instructions 2. @guide.md:: not loaded as written see lint steering , not counted 3. Skill listing 1 entry , about 23 tokens, names and descriptions of skills, commands and subagents; bodies load on use Later, when the agent works in a folder or on matching files 4. .claude/rules/api.md, about 21 tokens, when Claude reads or edits a file matching packages/api/ 2 files match now 5. packages/api/CLAUDE.md, about 18 tokens, when Claude reads or edits a file in packages/api Not loaded - AGENTS.md: CLAUDE.local.md switches off the AGENTS.md fallback, and it does not import AGENTS.md - packages/api/AGENTS.md: Claude Code reads the CLAUDE.md in packages/api instead Warnings - Claude Code ignores AGENTS.md here: CLAUDE.local.md switches off the AGENTS.md fallback just as a CLAUDE.md would, and it does not import AGENTS.md. Add the line @AGENTS.md to CLAUDE.local.md, or set Project instructions to claude-md-and-agents-md How sure: 4 confirmed with a canary run. $ npx -y -p @asitis/mcp@0.4.3 asitis loads packages/api --tool codex What loads when a session starts in packages/api local estimates, about 4 characters per token : Codex: about 8.2k tokens at launch from 2 files; 1 file cut At launch 1. AGENTS.md, about 6.6k tokens, root AGENTS.md 2. packages/api/AGENTS.md, about 1.6k tokens cut from 2.3k tokens , AGENTS.md for packages/api, first 6,332 bytes Cut - packages/api/AGENTS.md: the files above it use 26,436 of the 32,768-byte 32 KiB budget Codex shares across the chain. About 1.6k tokens of 2.3k tokens load. Warnings - packages/api/AGENTS.md is cut after 6,332 bytes: the AGENTS.md files above it use 26,436 of Codex's 32,768-byte 32 KiB budget How sure: 2 from vendor docs. One person's CLAUDE.local.md is enough to stop Claude Code reading the team's AGENTS.md, See @guide.md: for the review checklist imports nothing because of the colon, and Codex cuts the API package's AGENTS.md after 6,332 of its 9,135 bytes. None of that shows on GitHub. asitis lint checks the whole repo the same way: vendor size limits, broken @imports , rules that contradict each other, instructions hidden in HTML comments or invisible characters, and SKILL.md frontmatter. Install , pick one: - Claude Code plugin: claude plugin marketplace add Katta041/asitis-agent-tools && claude plugin install asitis@asitis - Codex plugin: codex plugin marketplace add Katta041/asitis-agent-tools && codex plugin add asitis@asitis - Gemini CLI extension: gemini extensions install https://github.com/Katta041/asitis-agent-tools - Cursor: Add to Cursor https://cursor.com/en/install-mcp?name=asitis&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBhc2l0aXMvbWNwQDAuNC4zIiwiLS1yb290IiwiJHt3b3Jrc3BhY2VGb2xkZXJ9Il19 adds the MCP server to your Cursor settings - VS Code Copilot agent mode : add the MCP server https://vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522asitis%2522%252C%2522type%2522%253A%2522stdio%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522%2540asitis%252Fmcp%25400.4.3%2522%252C%2522--root%2522%252C%2522%2524%257BworkspaceFolder%257D%2522%255D%257D - Any terminal, nothing to install: npx -y -p @asitis/mcp@0.4.3 asitis lint - GitHub Action: uses: Katta041/asitis-agent-tools@v0.4.3 full workflow under CLI and CI cli-and-ci - Devin Desktop Windsurf , Cline, Kiro, Zed, Goose, Continue, JetBrains and Docker: docs/install.md https://github.com/Katta041/asitis-agent-tools/blob/main/docs/install.md Why you can run it on your repo: it has no write tool and no network code, and the plugin starts it under Node's permission model so the runtime blocks writes and child processes too. MIT licensed. I hand-labelled every error and warning it reports on 71 public repos: 91% are worth fixing in 0.4.0, up from 70% in 0.3.0. Claude Code , one line, then start a new session: claude plugin marketplace add Katta041/asitis-agent-tools && claude plugin install asitis@asitis Run /asitis:md-lint lint every steering file in the project , /asitis:md-budget tokens loaded per session, per tool , /asitis:md-loads packages/api what each agent actually loads when it starts in that folder or /asitis:md-fix mechanical fixes as a diff, applied only after you say yes . Codex , one line, then start a new session. Ask Codex to "use AsItIs to lint the AGENTS.md files"; the plugin has the same tools, and a skill that picks the right one: codex plugin marketplace add Katta041/asitis-agent-tools && codex plugin add asitis@asitis Gemini CLI , one line, then restart Gemini. Run /asitis:md-lint , /asitis:md-loads , /asitis:md-budget or /asitis:md-fix : gemini extensions install https://github.com/Katta041/asitis-agent-tools Cursor, Claude Desktop, VS Code or any other MCP client: run the server from npm, pinned to a version. Ready-made configs are under Install other-mcp-clients-claude-desktop-cursor-codex-gemini-cli . Devin Desktop Windsurf , Cline, Kiro, Zed, Goose, Continue, JetBrains and Docker are in docs/install.md https://github.com/Katta041/asitis-agent-tools/blob/main/docs/install.md . npx -y @asitis/mcp@0.4.3 --root /absolute/path/to/project Terminal or CI , nothing to install first: npx -y -p @asitis/mcp@0.4.3 asitis lint Exit code 1 means something at or above --fail-on default error was found. --format sarif and --format github are there for code scanning and pull request annotations; see CLI and CI cli-and-ci for the GitHub Action and the pre-commit hook. No install at all: paste a file into the browser checker https://asitis.app/tools/steering-file-checker . It is the same linter running in your browser tab, and nothing is uploaded. A small project with three files. AGENTS.md holds the team's shared rules: Shared rules Use pnpm, not npm. Run pnpm test before every commit. CLAUDE.md was added later by one person. It has a zero-width space at the end of line 9 shown here as