pdugan20/claudelint/format-cc

Trust tier 3
  • community
  • ext:[{"type":"hook","description":"Pre/post lifecycle hooks"}]
Source check pending

Checking that the SKILL.md file is still in the repository.

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.

Install

npx vskill@latest install pdugan20/claudelint/format-cc

Semi-extensibleMentions customization, but needs skill-specific knowledge. Read the extensible skills standard

SKILL.md

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

bash
claudelint format --fix $ARGUMENTS

Modes

Fix Mode (default)

Auto-fix formatting issues:

bash
claudelint format --fix

Or simply:

bash
claudelint format
Check Mode

Check formatting without making changes:

bash
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:

bash
claudelint format --fix

Check formatting in CI:

bash
claudelint format --check

Verbose output:

bash
claudelint format --fix --verbose

Required Tools

Install formatting tools globally or in your project:

markdownlint
bash
npm install -g markdownlint-cli
# or
npm install --save-dev markdownlint-cli
prettier
bash
npm install -g prettier
# or
npm install --save-dev prettier
shellcheck
bash
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:

json
{
  "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:

json
{
  "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:

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

Add to pre-commit hooks:

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

Exit Codes

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

See Also

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
12
Repository forks
4
7-day trend score
13

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Extension points

  • hookPre/post lifecycle hooks

Learn the extensible skills standard

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/pdugan20/claudelint/format-cc/badge)](https://verified-skill.com/skills/pdugan20/claudelint/format-cc)

Something wrong with this skill or its page? Tell us.