cclint

🥈Silver

cclint is a linter for Claude Code agents, commands, and skills. It validates YAML frontmatter, enforces structural patterns, detects security issues, and provides quality scoring with improvement recommendations. It benefits developers and operations teams by ensuring code quality and security in Claude Code components.

1410Updated 4mo ago

Intermediate30min to implementautomation

Saves ~30 min per use

Quick InstallView Source

git clone https://github.com/dotcommander/cclint.git

Works with:

Claude

Overview

About This Skill

cclint is a linter designed to validate Claude Code components including agents, commands, skills, plugins, and settings. It catches frontmatter schema errors, enforces structural and naming conventions, and flags cross-file problems like broken references and orphaned skills before they cause runtime issues. The tool provides quality scoring on a 0-100 scale with letter grades (A-F) to help teams prioritize improvements. cclint supports incremental adoption through baseline mode, allowing projects with existing violations to tighten standards over time. Developers and DevOps teams benefit from automated validation integrated into CI/CD pipelines and pre-commit workflows.

How to Use

Install via `go install github.com/dotcommander/cclint@latest`. Run `cclint` to lint all components under ~/.claude, or target specific files or component types. Use `cclint --scores` to generate quality assessments, `cclint fmt --write` for auto-formatting, and `cclint --baseline` for incremental adoption on existing projects.

Use Cases

Validate YAML frontmatter and schema compliance in Claude Code components

Detect and flag broken cross-file references and orphaned skills

Enforce structural patterns and naming conventions across agents and commands

Generate quality scores to prioritize code improvements and refactoring

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/dotcommander/cclint

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Analyze the following Claude Code skill using cclint. Provide a detailed report including validation results, structural pattern adherence, security issues, and quality score with improvement recommendations. Skill name: [SKILL_NAME], YAML frontmatter: [YAML_FRONTMATTER], Code: [CODE]

Example Output

```markdown
# cclint Analysis Report

## Validation Results
✅ YAML frontmatter is valid
✅ Required fields are present
❌ Missing 'description' field in YAML frontmatter

## Structural Pattern Adherence
✅ Follows Claude Code skill structure
✅ Properly formatted input/output sections
❌ Missing error handling in main function

## Security Issues
✅ No hardcoded credentials detected
✅ Proper input sanitization
❌ Potential SQL injection vulnerability in database query

## Quality Score
**Score: 78/100**

## Improvement Recommendations
1. Add missing 'description' field to YAML frontmatter
2. Implement error handling in main function
3. Sanitize database query inputs to prevent SQL injection
4. Add more detailed comments to complex code sections
```