allergen-detection

Detect and annotate EU 1169/2011 allergens in PDF menus.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/TheDarkMagic/vibe-tools --skill allergen-detection
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: allergen-detection
Source: https://github.com/TheDarkMagic/vibe-tools/tree/main/.agent/skills/allergen-detection
Command: npx skills add https://github.com/TheDarkMagic/vibe-tools --skill allergen-detection

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pymupdf, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This tool detects and labels the 14 EU allergens defined in Regulation (EU) No 1169/2011 directly within restaurant menus presented as PDF documents, streamlining compliance checks and kitchen communication.

Core Features & Use Cases

  • Automated extraction and annotation of allergens on menu PDFs with color-consistent badges that align to the dish title.
  • EU allergen code mapping (including menu-specific legends) to produce a final labeled PDF plus an allergen_map.json for review.
  • Triggerable via file upload or keyword prompts (e.g., check allergen, EU1169) to generate compliant outputs for EU markets.

Quick Start

Provide a menu PDF to the tool and run the annotate process to obtain a labeled PDF and the corresponding allergen map.

Frequently Asked Questions about allergen-detection

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

FAQPage Schema
How do I detect EU 1169 allergens in a PDF menu?

Detecting EU 1169 allergens in a PDF menu requires uploading the document to trigger the annotation process. The tool maps the 14 regulated allergens and outputs a labeled PDF plus an allergen_map.json for compliance review.

What is EU 1169/2011 compliance for restaurant menus?

EU 1169/2011 compliance for restaurant menus mandates declaring 14 specific allergens. This tool automates the compliance check by identifying these allergens in PDF menus and producing a labeled PDF and allergen map.

Do I need PyMuPDF installed to annotate allergens in PDF menus?

Yes, PyMuPDF is required to annotate allergens in PDF menus. A working Python environment with this dependency is necessary to extract text, map EU 1169 allergens, and apply color-consistent badges to the PDF.

Can I extract allergen legends from menus in various languages?

Yes, the tool extracts allergen legends from menus in various languages. It applies EU allergen code mapping to interpret menu-specific legends and generates an accurate allergen_map.json for compliance review.

What output do I get after checking a menu for allergens?

After checking a menu for allergens, you receive a labeled PDF with color-consistent badges aligned to dish titles and an allergen_map.json file. These outputs streamline compliance checks and kitchen communication.

Are there limitations when annotating allergens directly in PDF documents?

Limitations when annotating allergens in PDF documents include the need for a working PDF workflow to extract text accurately. Complex layouts or scanned menus without a text layer may hinder the extraction and mapping process.