create-or-update-sample-topic

What problem does it solve?

This skill eliminates the inconsistent, error-prone process of manually creating or updating sample topics for the Microsoft Employee Self-Service agent, ensuring all changes adhere to the project's strict schema, UX, and validation rules defined in the core AGENTS.md guide, reducing PR review cycles and rework.

Core Features & Use Cases

• Guided new topic creation: Walks developers through every required step (archetype selection, persona definition, trigger configuration, input/output setup, UX state branching) to build a new sample topic from scratch that matches existing project standards.
• Safe bug fix workflow: Provides a structured tracing process for fixing existing topics, ensuring minimal, targeted changes that preserve existing functionality and avoid unintended side effects.
• Enforced compliance guardrails: Automatically applies hard file-scope, security, and schema rules to prevent common mistakes like renaming files, adding unsupported keys, or including sensitive internal data.
• Use Case: An ESS agent developer needs to add a new sample topic for employee health insurance enrollment. This skill guides them through all required steps, ensures the topic matches the structure of existing sibling topics, and validates the output before submission.

Quick Start

Use the create-or-update-sample-topic skill to build a new compliant sample topic for employee health insurance requests following the project's AGENTS.md guidelines.