agentsclimarketplace

Format cc

Skill pdugan20/claudelint/skills/format-cc

Formats Claude Code files with markdownlint, prettier, and shellcheck. Use when user asks to "format my files", "fix markdown formatting", "clean up CLAUDE.md", or "check shell scripts". Auto-fixes markdown, JSON, YAML formatting and analyzes shell script quality.From its SKILL.md

Install
npx -y skills add pdugan20/claudelint --skill format-cc

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 14 stars14 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

3.5 KB, as published. Nobody here has run it

Format Claude Code Files

Runs claudelint format to format Claude Code project files using industry-standard tools:

  • markdownlint - Markdown structure and formatting
  • prettier - Code formatting for markdown, JSON, YAML
  • shellcheck - Shell script analysis

Usage

claudelint format --fix $ARGUMENTS

Modes

Fix Mode (default)

Auto-fix formatting issues:

claudelint format --fix

Or simply:

claudelint format

Check Mode

Check formatting without making changes:

claudelint format --check

Useful for CI/CD to verify formatting.

Options

  • --check - Check formatting without making changes
  • --fix - Fix formatting issues (default)
  • --verbose - Show detailed command output

What Gets Formatted

Markdown Files

  • CLAUDE.md
  • .claude/**/*.md

Tools:

  • markdownlint - MD041, MD031, MD032, MD040, MD022
  • prettier - Line wrapping, indentation

JSON Files

  • .claude/**/*.json
  • .mcp.json
  • .claude-plugin/**/*.json

Tool: prettier

YAML Files

  • .claude/**/*.{yaml,yml}

Tool: prettier

Shell Scripts

  • .claude/**/*.sh
  • .claude/hooks/*

Tool: shellcheck (analysis only, no auto-fix)

Examples

Format all Claude files:

claudelint format --fix

Check formatting in CI:

claudelint format --check

Verbose output:

claudelint format --fix --verbose

Required Tools

Install formatting tools globally or in your project:

markdownlint

npm install -g markdownlint-cli
# or
npm install --save-dev markdownlint-cli

prettier

npm install -g prettier
# or
npm install --save-dev prettier

shellcheck

brew install shellcheck
# or
npm install -g shellcheck

Configuration

The format command automatically scopes to Claude files only, so it won't conflict with your project's existing formatters.

Customizing Markdownlint

Create .markdownlint.json in your project root:

{
  "default": true,
  "MD013": false,
  "MD033": {
    "allowed_elements": ["kbd", "br"]
  },
  "MD041": true,
  "MD031": true,
  "MD032": true,
  "MD040": true,
  "MD022": true
}

claudelint format will automatically use this configuration.

Customizing Prettier

Create .prettierrc.json in your project root:

{
  "semi": true,
  "singleQuote": true,
  "printWidth": 100,
  "tabWidth": 2,
  "useTabs": false,
  "arrowParens": "always",
  "endOfLine": "lf",
  "proseWrap": "preserve"
}

claudelint format will automatically use this configuration.

Integration

Add to package.json scripts:

{
  "scripts": {
    "format:claude": "claudelint format --fix",
    "format:claude:check": "claudelint format --check",
    "lint:claude": "claudelint check-all"
  }
}

Add to pre-commit hooks:

#!/bin/sh
claudelint format --check
claudelint check-all

Exit Codes

  • 0 - All formatting checks passed
  • 1 - Formatting issues found

See Also

Keep looking

Skills are one crate of 611,178. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.