add-announcement

Helps add announcement cards to the sidebar banner system. Use when adding changelog entries, feature announcements, updates, or promotional banners to the Agenta sidebar. Handles both simple changelog entries and complex custom banners.

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, well-structured skill with concrete examples and a clear verified workflow, held back by verbosity and a lack of progressive disclosure — the same JSON format is repeated several times and all advanced content is kept inline rather than split into reference files.

Suggestions

Consolidate the three full changelog.json example blocks (format, Step 2, Examples) into a single canonical example plus a compact format spec to reduce redundancy.

Extract the 'Custom Banners (Advanced)' section into a references/ file (e.g. custom-banners.md) and link to it from the body, improving progressive disclosure and trimming the main file.

Merge the overlapping 'Best Practices', 'Next Steps After Adding Announcement', and 'Example Workflow' sections into one concise checklist.

Dimension	Reasoning	Score
Conciseness	Mostly useful but verbose: the changelog.json format is shown in full three times across the format block, Step 2, and the Example section, the localStorage test line is repeated 3x, and 'Next Steps', 'Example Workflow', and 'Best Practices' overlap heavily.	2 / 3
Actionability	Provides concrete file paths, copy-paste-ready JSON examples with real IDs and links, and an executable bash workflow with git add/commit commands — fully actionable.	3 / 3
Workflow Clarity	Steps are clearly sequenced (Step 1-4) with an explicit verification step (Step 3: valid JSON, ID uniqueness, link check) and a concrete local test step (Step 4: clear localStorage + refresh + confirm banner appears); the edit is low-risk and non-destructive so no elaborate retry loop is required.	3 / 3
Progressive Disclosure	Well-organized into clear sections but monolithic at ~220 lines with no bundle references; the 'Custom Banners (Advanced)' section and the three illustrative examples are inline content that could be split into separate reference files.	2 / 3
	Total	10 / 12 Passed

Description

90%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A well-constructed description that clearly states both its purpose and explicit trigger conditions, scoped to a specific subsystem. Its only weakness is that the capability list is somewhat narrow rather than a broad multi-action catalog.

Dimension	Reasoning	Score
Specificity	Names the domain and several concrete actions ('add announcement cards', 'Handles both simple changelog entries and complex custom banners'), but the action list is clustered around announcement-adding rather than a broad, comprehensive catalog of distinct capabilities.	2 / 3
Completeness	Explicitly answers both what ('Helps add announcement cards to the sidebar banner system') and when ('Use when adding changelog entries, feature announcements, updates, or promotional banners') with an explicit 'Use when' trigger.	3 / 3
Trigger Term Quality	Includes natural terms a user would say — 'changelog entries', 'feature announcements', 'updates', 'promotional banners' — giving good coverage of likely phrasings.	3 / 3
Distinctiveness Conflict Risk	Scoped to the specific 'Agenta sidebar' banner system with distinct triggers, giving it a clear niche unlikely to conflict with unrelated skills.	3 / 3
	Total	11 / 12 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
allowed_tools_field	'allowed-tools' contains unusual tool name(s)	Warning

	Total	15 / 16 Passed

Repository: Agenta-AI/agenta
Path: .claude/skills/add-announcement/SKILL.md
Commit: 93872a6

Reviewed: 5 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.