using-code-directives

What problem does it solve?

Reading and editing code that contains inline directives like @implement, @docs, @refactor, @test, or @todo can be error-prone and inconsistent. This skill provides a structured approach to recognizing directives, executing their instructions, and applying the correct post-action transformations to keep code clean and maintainable.

Core Features & Use Cases

• Recognize and extract directives from source across languages.
• Load and apply the appropriate reference (implement.md, docs.md, refactor.md, test.md, todo.md) to guide the change.
• Execute the directive instructions and perform post-action transformations (transform into documentation blocks, inline comments, or directive removal) based on context.
• Safety and hygiene: validate external references, check for prompt-injection patterns, and ensure changes are auditable.

Quick Start

Identify a directive in code, consult the correct reference, apply the change, and remove the directive.