Annotate Source Files
Skill Verified ActiveAdd PUT workflow annotations to source files using the correct language-specific comment prefix. Covers annotation syntax, skeleton generation via put_generate(), multiline annotations, .internal variables, and validation. Supports 30+ languages with automatic comment prefix detection. Use after analyzing a codebase and having an annotation plan, when adding workflow documentation to new or existing source files, or when documenting data pipelines, ETL processes, or multi-step computations.
To enrich source files with structured workflow annotations, enabling the extraction of data for visualization and documentation, especially for data pipelines and computations.
Features
- Add PUT workflow annotations to source files
- Supports 30+ languages with automatic comment prefix detection
- Generates annotation skeletons via `put_generate()`
- Handles single-line and multiline annotation styles
- Validates annotations and generates workflow diagrams
Use Cases
- Use after analyzing a codebase and having an annotation plan
- Adding workflow documentation to new or existing source files
- Documenting data pipelines, ETL processes, or multi-step computations
- Enriching auto-detected workflows with manual labels and connections
Non-Goals
- Does not support Python triple-quote strings for annotations
- Block comment syntax is not supported for # or -- prefix languages
- Does not automatically execute the generated workflows or diagrams
Installation
/plugin install agent-almanac@pjt222-agent-almanacQuality Score
VerifiedTrust Signals
Similar Extensions
Add New Opc Skill
100Checklist and automation guide for adding a new skill to the OPC Skills project. Ensures all required files, metadata, logos, and listings are created before release. Use when adding a new skill, publishing a skill, or preparing a skill for release.
Teach Guidance
100Guide a person in becoming a better teacher and explainer. AI coaches content structuring, audience calibration, explanation clarity, Socratic questioning technique, feedback interpretation, and reflective practice for technical presentations, documentation, and mentoring. Use when a person needs to present technical content and wants preparation coaching, wants to write better documentation or tutorials, struggles to explain concepts across expertise levels, is mentoring a colleague, or is preparing for a talk or knowledge-sharing session.
Prepare Inspection Readiness
100Prepare an organisation for regulatory inspection by assessing readiness against agency-specific focus areas (FDA, EMA, MHRA). Covers warning letter and 483 theme analysis, mock inspection protocols, document bundle preparation, inspection logistics, and response template creation. Use when a regulatory inspection has been announced or is anticipated, when a periodic self-assessment is due, when new systems have been implemented since the last inspection, or after a significant audit finding that may attract regulatory attention.
External Context
100Invoke parallel document-specialist agents for external web searches and documentation lookup
Deepinit
100Deep codebase initialization with hierarchical AGENTS.md documentation
Readme I18n
100Use when the user wants to translate a repository README, make a repo multilingual, localize docs, add a language switcher, internationalize the README, or update localized README variants in a GitHub-style repository.