Why should I use curly braces instead of brackets for placeholders?

The skill enforces the { string } convention to prevent the AI from confusing instructions with Markdown links or file references, ensuring clearer execution boundaries.

What formatting violations does this skill detect?

It identifies issues with instructional placeholders, missing code fence language tags, incorrect nesting, and relative path references that should use the plugin root variable.

How does the relative path linter help with plugin development?

It identifies brittle paths like '../' and suggests using ${CLAUDE_PLUGIN_ROOT}, which ensures that links and file references remain valid regardless of where the skill is invoked.

Does this skill fix the formatting issues automatically?

The skill identifies and reviews violations; while it provides the specific fix patterns and locations, the user or the AI can then apply the suggested fixes to the identified files.

Claude Skill Formatter

Name: Claude Skill Formatter
Author: outfitter-dev

byoutfitter-dev

•

開発者ツール

Validates Claude skill files against formatting conventions to ensure consistency in placeholders, code fences, and file paths.

The check-skill-formatting skill is a quality assurance utility designed specifically for developers creating and maintaining Claude Code skills within the Outfitter ecosystem. It automatically scans skill files to catch common preprocessing hazards, ensures instructional placeholders follow the required curly brace convention, validates code fence language specifiers, and enforces absolute plugin root paths. By automating these technical checks, the skill helps maintain high standards of documentation and execution consistency, preventing common errors that occur when transitioning between different skill environments or complex plugin architectures.

主な機能

01Script-based batch linting for entire plugin directories

02Relative path conversion to plugin root environment variables

03Automated frontmatter and preprocessing pattern auditing

04Placeholder validation for curly brace convention compliance

052 GitHub stars

06Code fence language specifier and nesting hazard detection

ユースケース

01Standardizing cross-skill references in large, multi-plugin projects

02Refactoring legacy skill files to meet modern formatting standards

03Validating new skills before repository submission or deployment

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add outfitter-dev/outfitter check-skill-formatting

For use in Claude.ai and ChatGPT

Download Skill