convention-check

Detect project convention violations and report them with guidance.

1|1|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/kangmomin/harness-plugins --skill convention-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convention-check
Source: https://github.com/kangmomin/harness-plugins/tree/main/be-harness/skills/convention-check
Command: npx skills add https://github.com/kangmomin/harness-plugins --skill convention-check

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

이 스킬은 저장소의 프로젝트 컨벤션 위배 사항을 자동으로 식별하고 보고합니다.

Core Features & Use Cases

  • 프로젝트 로컬 규칙과 CLAUDE.md의 컨벤션을 비교해 위반을 탐지합니다.
  • .convention-check.json 구성을 통해 적용 규칙을 관리하고, OVERRIDES.md를 사용해 예외를 반영합니다.
  • 팀의 코드 품질 가이드라인 준수를 자동화하고 개발 속도를 높입니다.

Quick Start

Scan the repository for convention violations and generate a report.

Frequently Asked Questions about convention-check

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate project convention checks in a repository?

To automate project convention checks, configure a `.convention-check.json` file to define rules and use OVERRIDES.md for exceptions. The tool scans the repository, compares code against CLAUDE.md standards, and reports violations with clear guidance.

What is the best way to enforce coding and architectural conventions across plugin projects?

Enforcing coding and architectural conventions across plugin projects is done by validating configuration files and applying local overrides. The scanner reads project standards from CLAUDE.md and reports deviations automatically.

How does static analysis for project conventions handle local rule exceptions?

Static analysis for project conventions handles local rule exceptions through an OVERRIDES.md file. You define specific exceptions there, and the checker applies these overrides alongside the `.convention-check.json` configuration during the repository scan.

Can I use this convention checker without setting up a CLAUDE.md file?

You cannot effectively use this convention checker without a CLAUDE.md file, as it serves as the primary source for project standards. The tool relies on comparing local repository rules against these defined standards to identify and report violations.

Why does my project convention validation report false positives?

Project convention validation may report false positives if local exceptions are not properly defined. Ensure your specific use cases are documented in OVERRIDES.md and your `.convention-check.json` configuration accurately reflects your intended coding guidelines.

Do I need to configure specific files before scanning for code quality violations?

You need to configure a `.convention-check.json` file to manage applied rules before scanning for code quality violations. This file works with CLAUDE.md standards and OVERRIDES.md to ensure the automated validation matches your project requirements.