vale-style-authoring-actions

Author Vale actions and fixers for custom rule fixes.

Updated May 4, 2026
One-click install
npx skills add https://github.com/ghalactic/vale-style --skill vale-style-authoring-actions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vale-style-authoring-actions
Source: https://github.com/ghalactic/vale-style/tree/main/.agents/skills/vale-style-authoring-actions
Command: npx skills add https://github.com/ghalactic/vale-style --skill vale-style-authoring-actions

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Vale , and includes scripts (resource) components.

What problem does it solve?

This Skill unit offers a comprehensive guide to creating and using Vale actions and fixers, which allow for dynamic fixes for custom Vale rules.

Core Features & Use Cases

  • Actions Overview: Learn about different types of actions, such as suggest, replace, remove, and edit.
  • Fixer Usage: Understand how to apply fixers like edit, remove, and replace to Vale rules.
  • Examples: Follow through practical examples to implement actions like converting camelCase to snake_case or suggesting alternative text.

Quick Start

Create a new Vale action in the 'scripts/' directory, write your function, and link it to a rule in your Vale style configuration.

Frequently Asked Questions about vale-style-authoring-actions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create custom Vale actions to fix linter errors?

To create custom Vale actions, you write a script in the 'scripts/' directory and link it to a rule in your Vale style configuration to dynamically fix linter errors. This enables automated suggestions and replacements for your documentation.

What are Vale fixers and how do they work?

Vale fixers are action types like `edit`, `remove`, and `replace` that apply dynamic fixes to custom Vale rules. They work by executing scripts that automatically modify text based on your style configuration.

Can I use Vale actions to convert camelCase to snake_case?

Yes, you can use Vale actions to convert camelCase to snake_case. The Skill provides practical examples for implementing this exact text transformation by writing a custom fixer and linking it to your Vale rule.

Do I need to understand Vale rule configurations to author fixers?

Yes, authoring Vale fixers requires a solid understanding of Vale rule configurations and scripting capabilities. You must properly configure your Vale styles to link scripts from the 'scripts/' directory to the relevant rules.

What is the difference between the suggest and replace actions in Vale?

The `suggest` action proposes alternative text to the user, while the `replace` action automatically swaps the matched text. Both are Vale action types used to implement custom fixes within your style rules.