retif

Claudecode Linter — Development skill for Claude Code

Development community

Standalone linter and formatter for Claude Code plugins and configuration files — 90 rules across 8 artifact types with auto-fix.

How to install Claudecode Linter

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

What Claudecode Linter does

Standalone linter and formatter for Claude Code plugins and configuration files — 90 rules across 8 artifact types with auto-fix.

Alternatives in Development

Gtm Motions — Identify best GTM motions across 7 types including PLG and ABM 7.8k ★
Env Fix — テスト実行に必要な環境依存問題（パッケージ不足、環境変数未設定、設定ファイル不備、外部サービス未起動）を自動的に分析・修正します 974 ★
Gemini Project Context For SaneBar — PRIMARY INSTRUCTION: This project uses a shared configuration with Claude 216 ★

README

claudecode-linter

[![CI](https://github.com/retif/claudecode-linter/actions/workflows/ci.yml/badge.svg)](https://github.com/retif/claudecode-linter/actions/workflows/ci.yml) [![npm version](https://img.shields.io/npm/v/claudecode-linter)](https://www.npmjs.com/package/claudecode-linter) [![license](https://img.shields.io/npm/l/claudecode-linter)](https://github.com/retif/claudecode-linter/blob/main/LICENSE) [![Socket Badge](https://socket.dev/api/badge/npm/package/claudecode-linter)](https://socket.dev/npm/package/claudecode-linter)

Standalone linter for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) plugins and configuration files.

Validates `plugin.json`, `SKILL.md`, agent/command markdown, `hooks.json`, `mcp.json`, `settings.json`, `CLAUDE.md`, `.lsp.json`, and `monitors/monitors.json` files. plugin.json, settings.json, the agent/skill/command frontmatter, .lsp.json and monitors.json are checked against JSON Schemas auto-extracted from Claude Code's runtime Zod validators — failures the linter reports are the same failures Claude Code would raise at session start.

![demo](assets/demo.gif)

Install

npm install -g claudecode-linter

Or run directly:

npx claudecode-linter ~/projects/my-plugin/

Or build it from a clone of this repository — there is no `dist/` until you build:

git clone https://github.com/retif/claudecode-linter
cd claudecode-linter
npm ci && npm run build      # install dependencies, compile to dist/
node dist/index.js path/to/plugin/

Commands elsewhere in this README are written as `claudecode-linter …` (the global / `npx` install); from a clone, that is `node dist/index.js …`.

Usage

Lint

Check plugin artifacts for errors without modifying files. This is the default mode — `--lint` is optional:

# Lint a plugin directory
claudecode-linter --lint path/to/plugin/
claudecode-linter path/to/plugin/  # same thing

# Lint multiple paths
claudecode-linter plugin-a/ plugin-b/