neon-format

Parse, validate, and format NEON configuration data using the Neon API.

41|4|Updated Jan 4, 2026
One-click install
npx skills add https://github.com/nette/claude-code --skill neon-format
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: neon-format
Source: https://github.com/nette/claude-code/tree/main/plugins/nette/skills/neon-format
Command: npx skills add https://github.com/nette/claude-code --skill neon-format

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

NEON configuration is a core part of Nette applications. This skill helps developers parse, validate, and format NEON data to prevent misconfigurations and runtime errors.

Core Features & Use Cases

  • Parsing & Validation: Read Neon data, decode to PHP values, and validate keys and structures.
  • Encoding & Formatting: Convert PHP values back to Neon with proper indentation and entities.
  • Use Case: Ensure config.neon in a Nette project adheres to schema, with a quick lint check before deployment.

Quick Start

Decode a Neon string and re-encode it with proper formatting to verify correct parsing, indentation, and entity handling.

Frequently Asked Questions about neon-format

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

FAQPage Schema
How do I validate NEON configuration files in a Nette PHP project?

You can validate NEON configuration files by decoding the data into PHP values and checking the keys and structures. This process prevents misconfigurations and runtime errors before deploying your Nette application.

What is the best way to format NEON data to ensure correct indentation and entity handling?

The best way to format NEON data is to decode the string into PHP values and re-encode it using the Neon::encode API. This ensures proper indentation and correct entity handling for your configuration.

How does parsing NEON data with the nette/neon library work?

Parsing NEON data works by using the Neon::decode or Neon::decodeFile APIs to convert NEON configuration strings or files into native PHP values. This allows developers to read, validate, and manipulate the configuration programmatically.

Can I lint a config.neon file for syntax errors before deployment?

Yes, you can perform a quick lint check on a config.neon file by decoding the data and re-encoding it. If parsing succeeds and formats correctly, your configuration is structurally sound and ready for deployment.

Do I need the nette/neon library installed to parse and encode NEON configurations?

Yes, you need the nette/neon library installed in your PHP project. The skill leverages the Neon API directly from this library to operate on NEON strings and files for decoding, encoding, and validation.

Why does my NEON configuration fail to parse correctly in PHP?

NEON configuration parsing fails when there are structural misconfigurations or invalid syntax in the file. Decoding the data into PHP values helps identify these specific key and structure errors before they cause runtime issues.