Skip to content

[Analytics] Instrumentation Agent Skill#34054

Open
iamEAP wants to merge 3 commits intomasterfrom
analytics/instrumentation-skill
Open

[Analytics] Instrumentation Agent Skill#34054
iamEAP wants to merge 3 commits intomasterfrom
analytics/instrumentation-skill

Conversation

@iamEAP
Copy link
Copy Markdown
Member

@iamEAP iamEAP commented Apr 24, 2026

What / Why

Been noticing a lot of slopalytics in PRs in our Backstage instance since the shift to genAI development workflows. Providing this skill in hopes that we can stem the tide.

✔️ Checklist

  • Added or updated documentation
  • All your commits have a Signed-off-by line in the message. (more info)

iamEAP added 2 commits April 24, 2026 14:53
Signed-off-by: Eric Peterson <ericpeterson@spotify.com>
Signed-off-by: Eric Peterson <ericpeterson@spotify.com>
Copilot AI review requested due to automatic review settings April 24, 2026 12:57
@iamEAP iamEAP requested review from a team as code owners April 24, 2026 12:57
@github-actions github-actions Bot added the area:documentation Improvements or additions to documentation label Apr 24, 2026
@backstage-goalie backstage-goalie Bot added size:medium Medium-sized pull requests receive no change in priority for reviews. waiting-for:review The PR needs a review and will be visible in the review queue unless already assigned an owner. labels Apr 24, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds documentation and a new “skill” entry aimed at improving consistency and signal-to-noise in analytics instrumentation for Backstage frontend plugins.

Changes:

  • Expanded the frontend analytics guide with guidance to prefer semantic/domain events and rely on @backstage/ui auto-tracked click events (with noTrack for overrides).
  • Added a new plugin-analytics-instrumentation skill document with principles, examples, and a review checklist.
  • Registered the new skill in the skills index.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 6 comments.

File Description
docs/frontend-system/building-plugins/08-analytics.md Adds guidance to avoid generic click/lifecycle events and leverage @backstage/ui auto-tracking with noTrack.
docs/.well-known/skills/plugin-analytics-instrumentation/SKILL.md Introduces a new skill doc covering analytics instrumentation principles, patterns, and testing guidance.
docs/.well-known/skills/index.json Registers the new skill in the skills catalog index.

Comment thread docs/frontend-system/building-plugins/08-analytics.md Outdated
Comment thread docs/.well-known/skills/plugin-analytics-instrumentation/SKILL.md Outdated
Comment thread docs/.well-known/skills/plugin-analytics-instrumentation/SKILL.md
Comment thread docs/.well-known/skills/plugin-analytics-instrumentation/SKILL.md Outdated
Comment thread docs/.well-known/skills/plugin-analytics-instrumentation/SKILL.md Outdated
Comment thread docs/.well-known/skills/plugin-analytics-instrumentation/SKILL.md
Signed-off-by: Eric Peterson <ericpeterson@spotify.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:documentation Improvements or additions to documentation size:medium Medium-sized pull requests receive no change in priority for reviews. waiting-for:review The PR needs a review and will be visible in the review queue unless already assigned an owner.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants