structured-edit

What problem does it solve?

This Skill addresses the common and frustrating failures in LLM code editing caused by subtle differences in file content, such as whitespace, encoding, or concurrent modifications, by implementing a robust read-verify-edit pattern.

Core Features & Use Cases

• LSP Integration: Leverages Language Server Protocol (LSP) for precise code element location (definitions, references, symbols).
• Read-Verify-Edit Pattern: Ensures content is read fresh, verified against expectations, and then edited with unique context, drastically reducing "string not found" errors.
• Use Case: When an LLM needs to modify a specific function in a large codebase, this Skill ensures it accurately locates the function using LSP, reads its current state, confirms it's the expected code, and then applies the modification using surrounding lines as unique identifiers, preventing common edit failures.

Quick Start

Use the structured-edit skill to locate the definition of the 'calculate_total' function in the file 'utils.py' and then edit it to return the sum of its arguments.