pdugan20/format-cc
skills/format-cc/SKILL.md
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 --global
skillsauthnpx skillsauth add pdugan20/claudelint format-ccInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 28, 2026, 11:20 AM117.5s3 files scanned
SKILL.md
- name:
- format-cc
- description:
- 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.
- version:
- 1.0.0
- argument-hint:
- [flags]
- - Bash(claudelint:
- *)
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 passed1- Formatting issues found
See Also
- validate-all - Validate Claude files
- CLI Reference - Complete CLI documentation
Related Skills
pdugan20/test-skill
testing
VerifiedTrustedCommunity
A valid test skill for testing purposes. Use this when you want to test skill validation.
5SKILL.mdUpdated Apr 28, 2026
pdugan20/no-version-skill
testing
VerifiedTrustedCommunity
This skill is missing the version field for testing purposes.
5SKILL.mdUpdated Apr 28, 2026
pdugan20/dangerous-skill
testing
VerifiedTrustedCommunity
This skill contains dangerous commands for testing security validation.
5SKILL.mdUpdated Apr 28, 2026
pdugan20/validate-skills
tools
VerifiedTrustedCommunity
Validates Claude Code skills for schema, naming, documentation, and security. Use when user asks to "check my skill", "validate skill syntax", "why isn't my skill loading", "skill errors", or "dangerous command detected". Validates SKILL.md frontmatter, allowed-tools, file references, directory organization, and shell script security.
5SKILL.mdUpdated Apr 28, 2026