add-announcement_skill

Overview

This skill helps add announcement cards to the Agenta sidebar banner system. It supports quick changelog entries for product updates and also guides adding complex custom banners for special UI or logic. Use it to make announcements appear at the bottom of the sidebar where users can dismiss them.

How this skill works

Simple changelog announcements are added to a JSON data file that the sidebar banner system reads and surfaces by priority. A priority queue shows one banner at a time, persists dismissals in localStorage, and uses Jotai atoms for reactive state. For advanced needs, you can register custom banner types, assign priority, and create banners with custom interactions in the activeBannersAtom or eeBannersAtom.

When to use it

• Publish a short product update or changelog entry that links to docs
• Announce new features, improvements, or integrations to users
• Display time-limited promotions or feature rollouts
• Create non-dismissible or interactive notices (use custom banners)
• Show trial or upgrade warnings in the Enterprise edition

Best practices

• Use date-based unique IDs: changelog-YYYY-MM-DD-feature-slug
• Keep titles under ~40 characters and descriptions under ~100 characters
• Write user-focused messaging: start with what the user can do
• Always link to a corresponding changelog documentation page
• Test locally by clearing localStorage and verifying display

Example use cases

• Add a changelog entry for a new Playground PDF upload feature
• Announce LangChain integration with a short actionable description
• Notify users about a performance improvement on the observability page
• Create a custom banner for trial expiration with an upgrade button
• Show a non-dismissible maintenance or critical alert via a custom banner