What problem does it solve? Turning an existing source file into a learning resource by hand is slow and error-prone: comments can break indentation, encoding, or compilation, and explanations often miss the reader's actual knowledge level. This Skill annotates code files with clear, level-appropriate educational comments while guaranteeing the file still compiles and keeps its original structure. ## Core Features & Use Cases - Configurable teaching depth: Tune comment detail, repetitiveness, user knowledge, and educational level (scales 1-3) so explanations fit beginners, intermediate, or advanced readers. - Safety-preserving annotation: Maintains file encoding, line endings, indentation style, and compilation correctness; never alters namespaces, imports, or module declarations. - Line growth targets with hard limits: Expands files by 125% using comments only, capped at 400 new lines (300 for files over 1,000 lines), and refines existing notes on re-runs instead of reapplying growth. - Use Case: A team modernizing a legacy Natural/Adabas system asks the agent to annotate a Java 21 service file so new team members can learn the language constructs directly from real code, with numbered notes referencing related explanations. ## Quick Start Ask the agent to add educational comments to a specific source file, for example: add educational comments to src/main/java/PaymentService.java with comment detail 2 and user knowledge 2.
