/configure:editor Skill

/configure:editor

Check and configure editor settings for consistency across the team.

When to Use This Skill

| Use this skill when... | Use another approach when... | |------------------------|------------------------------| | Setting up consistent editor configuration across a team | Personal editor preferences only (configure in user settings) | | Checking EditorConfig or VS Code workspace compliance | Just viewing existing .editorconfig (use Read tool) | | Configuring format-on-save for detected languages | Project doesn't use VS Code (configure for other editors manually) | | Adding recommended VS Code extensions for project tools | Extensions are already properly configured | | Setting up debug configurations and tasks | Simple project with no debugging needs |

Context

EditorConfig: !find . -maxdepth 1 -name \'.editorconfig\'
VS Code settings: !find . -maxdepth 1 -name \'.vscode/settings.json\'
VS Code extensions: !find . -maxdepth 1 -name \'.vscode/extensions.json\'
VS Code launch: !find . -maxdepth 1 -name \'.vscode/launch.json\'
VS Code tasks: !find . -maxdepth 1 -name \'.vscode/tasks.json\'
Project languages: !find . -maxdepth 1 $ -name 'package.json' -o -name 'tsconfig.json' -o -name 'pyproject.toml' -o -name 'Cargo.toml' -o -name 'biome.json' $
Project standards: !find . -maxdepth 1 -name \'.project-standards.yaml\'

Parameters

Parse from $ARGUMENTS:

--check-only: Report compliance status without modifications
--fix: Apply all fixes automatically without prompting

Execution

Execute this editor configuration workflow:

Step 1: Detect project languages and tools

Check for language indicators:

| Indicator | Language/Tool | Configuration Needed | |-----------|---------------|---------------------| | package.json | JavaScript/TypeScript | Biome | | tsconfig.json | TypeScript | TypeScript extension | | pyproject.toml | Python | Ruff, Python extension | | Cargo.toml | Rust | rust-analyzer | | biome.json | Biome formatter/linter | Biome extension |

Step 2: Analyze current editor configuration

Check existing configuration against these requirements:

EditorConfig:

Verify .editorconfig exists
Check root directive, charset, end-of-line, final newline, trim whitespace
Check language-specific sections match detected languages

VS Code Settings:

Verify .vscode/settings.json exists
Check format-on-save, default formatters per language, language-specific settings

VS Code Extensions:

Verify .vscode/extensions.json exists
Check recommended extensions match project tools

Step 3: Generate compliance report

Print a formatted compliance report showing status of each check:

Editor Configuration Compliance Report
=======================================
Project: [name]
Languages: [detected]
Detected Tools: [detected]

EditorConfig:     [status per check]
VS Code Settings: [status per check]
VS Code Extensions: [status per check]

Overall: [X issues found]
Recommendations: [list specific fixes]

If --check-only, stop here.

Step 4: Configure editor files (if --fix or user confirms)

Apply fixes based on detected languages. Use configurations from REFERENCE.md.

Create or update .editorconfig with language-specific sections
Create or update .vscode/settings.json with format-on-save and per-language formatters
Create or update .vscode/extensions.json with recommended extensions for detected tools
Add language-specific settings (TypeScript import preferences, Python interpreter, Rust clippy)

Step 5: Create launch and task configurations

Create .vscode/launch.json with debug configurations for detected languages
Create .vscode/tasks.json with build/test/lint tasks

Step 6: Update standards tracking

Update .project-standards.yaml:

components:
  editor: "2025.1"
  editor_config: true
  vscode_settings: true
  vscode_extensions: true

Step 7: Create documentation

Create docs/EDITOR_SETUP.md with quick start instructions for the team covering VS Code setup, recommended extensions, and troubleshooting.

Step 8: Print completion report

Print a summary of all changes made, including files created/updated, extensions recommended, and next steps for the team.

For detailed configuration templates and language-specific settings, see REFERENCE.md.

Agentic Optimizations

| Context | Command | |---------|---------| | Check if EditorConfig exists | test -f .editorconfig && echo "exists" \|\| echo "missing" | | Validate EditorConfig syntax | editorconfig-checker .editorconfig 2>&1 (if installed) | | Check VS Code settings exist | test -f .vscode/settings.json && jq empty .vscode/settings.json 2>&1 | | List detected languages | find . -maxdepth 1 $ -name 'package.json' -o -name 'pyproject.toml' -o -name 'Cargo.toml' $ -exec basename {} \; | | Quick compliance check | /configure:editor --check-only | | Auto-fix all issues | /configure:editor --fix |

Flags

| Flag | Description | |------|-------------| | --check-only | Report status without offering fixes | | --fix | Apply all fixes automatically without prompting |

Examples

# Check compliance and offer fixes
/configure:editor

# Check only, no modifications
/configure:editor --check-only

# Auto-fix all issues
/configure:editor --fix

Error Handling

No language detected: Create minimal EditorConfig
Conflicting formatters: Warn about duplicate formatter configs
Invalid JSON: Report parse error, offer to replace with template

Agent Skills: /configure:editor

Install this agent skill to your local

Skill Files