What problem does it solve?
Editing the Facebook/Instagram comment automation code in ChatbotX is risky: silent failures like misread parent_id values, composite post id mismatches, and skip paths without logs can silently drop every top-level comment in production. This Skill maps the entire comment-automation subsystem and documents the traps so changes land correctly the first time.
Core Features & Use Cases
- Codebase Map: Locates every relevant file across the worker handlers, webhook parsers, database schemas, dedup ledger, and the fb-comments/ig-comments builder features.
- Trap Documentation: Explains seven known failure modes, including the
parent_id equals post_id pitfall, composite post id normalization, mandatory skip logging, and the difference between AIAgent comment replies and DM auto-responders.
- Step-by-Step Recipes: Provides ordered procedures for adding a new filter option (schema, service, loop guard, builder form, i18n, tests) and a new reply type (schema, public/private dispatch, dedup counting, worker job wiring).
- Use Case: When adding a new comment filter option, follow the recipe to update the Zod partials, add a service query reusing the dedup index, insert a guarded skip with
logAutomationSkipped, surface the toggle in the builder form, and extend the worker test suite.
Quick Start
Ask the assistant to add a new filter option to the Facebook comment automation and have it follow the documented recipe including skip logging and tests.
