match-codebase-conventions

Map coding conventions across files and directories to identify alignment gaps.

1|Updated Mar 8, 2026
One-click install
npx skills add https://github.com/gjalla/gjalla-plugin --skill match-codebase-conventions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: match-codebase-conventions
Source: https://github.com/gjalla/gjalla-plugin/tree/main/claude/skills/match-codebase-conventions
Command: npx skills add https://github.com/gjalla/gjalla-plugin --skill match-codebase-conventions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates detection of inconsistencies in coding conventions across a codebase, surfacing gaps and guiding alignment.

Core Features & Use Cases

  • Scan naming conventions, file structures, error handling, testing, and documentation usage
  • Compare against ADRs, principles, and style guides to identify deviations
  • Generate an actionable plan to harmonize patterns with minimal disruption

Quick Start

Scan the repository for ADRs and style guides and generate a unified conventions plan

Frequently Asked Questions about match-codebase-conventions

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

FAQPage Schema
How do I find inconsistencies in coding conventions across my codebase?

To find inconsistencies in coding conventions, scan the repository to map file naming, directory structure, error handling, testing, and documentation usage across multiple files. This surfaces alignment gaps where patterns are codified or implicit.

How do I compare my codebase against ADRs and style guides?

Comparing your codebase against ADRs and style guides involves scanning for explicit rules in documentation and matching them against actual file and directory patterns. This identifies deviations from established architecture decisions.

What is the best way to harmonize project conventions with minimal disruption?

Harmonizing project conventions with minimal disruption requires mapping all alignment gaps first, then generating an actionable plan that prioritizes consistent patterns for file naming, structures, and error handling without breaking existing logic.

Can I detect implicit coding conventions that are not documented in a CONTRIBUTING guide?

Yes, you can detect implicit coding conventions by analyzing multiple files for consistent naming, directory structure, and error handling patterns. This surfaces unwritten rules that lack explicit documentation in ADRs or CONTRIBUTING files.

Why does my codebase have inconsistent file naming and directory structure?

Inconsistent file naming and directory structure occurs when conventions remain implicit and lack explicit rules in ADRs or style guides. Scanning the codebase identifies these alignment gaps between documented principles and actual implementation.