Skip to content

[docs] Update documentation for features from 2026-04-04#569

Closed
danielmeppiel wants to merge 1 commit into
mainfrom
docs/skill-collision-warning-pr545-ba4f0b350370ee69
Closed

[docs] Update documentation for features from 2026-04-04#569
danielmeppiel wants to merge 1 commit into
mainfrom
docs/skill-collision-warning-pr545-ba4f0b350370ee69

Conversation

@danielmeppiel

Copy link
Copy Markdown
Collaborator

Documentation Updates - 2026-04-04

This PR updates the documentation based on features merged in the last 24 hours.

Features Documented

Changes Made

  • Updated CHANGELOG.md to add a Fixed entry under [Unreleased] for the cross-package native skill collision detection introduced in [fix] warn when two packages deploy a native skill with the same name #545.
  • Added a "Skill Name Collision Warning" troubleshooting section to docs/src/content/docs/guides/skills.md explaining the new warning message and how users can resolve the conflict.

Merged PRs Referenced

  • [fix] warn when two packages deploy a native skill with the same name #545 - [fix] warn when two packages deploy a native skill with the same name -- when two installed packages deploy a native skill with the same leaf directory name, APM now emits a warning identifying both the incoming package and the previous owner, and tells the user to remove one to resolve the conflict. Previously the second install silently overwrote the first.

Notes

No other PRs were merged in the last 24 hours. The CHANGELOG entry and troubleshooting note cover all user-facing aspects of #545.

Generated by Daily Documentation Updater ·

To install this agentic workflow, run

gh aw add githubnext/agentics/workflows/daily-doc-updater.md@b87234850bf9664d198f28a02df0f937d0447295
  • expires on Apr 6, 2026, 3:32 AM UTC

- Add CHANGELOG.md entry under [Unreleased] Fixed for the new
  cross-package native skill name collision warning
- Add 'Skill Name Collision Warning' troubleshooting section in
  docs/src/content/docs/guides/skills.md explaining the warning
  message and how to resolve the conflict

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@danielmeppiel danielmeppiel added automation Deprecated: use type/automation. Kept for issue history; will be removed in milestone 0.10.0. documentation Deprecated: use type/docs. Kept for issue history; will be removed in milestone 0.10.0. labels Apr 4, 2026
Copilot AI review requested due to automatic review settings April 4, 2026 03:33

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Updates user documentation to reflect the newly added native skill name collision warning behavior introduced in #545, ensuring users understand what the warning means and how to resolve it.

Changes:

  • Added a troubleshooting section describing the "Skill Name Collision Warning" and remediation steps.
  • Added a Fixed entry under [Unreleased] documenting the native-skill collision warning behavior.
Show a summary per file
File Description
docs/src/content/docs/guides/skills.md Adds troubleshooting guidance for native skill name collisions and how to resolve them.
CHANGELOG.md Documents the collision warning behavior under [Unreleased] -> Fixed.

Copilot's findings

  • Files reviewed: 2/2 changed files
  • Comments generated: 1

Comment on lines +383 to +385
```
[!] Skill 'humanizer': replaced 'org/other-package' -- remove one package to avoid this
```

Copilot AI Apr 4, 2026

Copy link

Choose a reason for hiding this comment

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

The example warning message does not match the actual collision warning emitted by SkillIntegrator. Current code formats the detail as "Skill '' from '' replaced '<prev_owner>' -- remove one package to avoid this"; the docs example omits the "from ''" portion (and uses a colon), but the surrounding text says the warning names both packages. Update the example (and any related wording) so it mirrors the real message format users will see.

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automation Deprecated: use type/automation. Kept for issue history; will be removed in milestone 0.10.0. documentation Deprecated: use type/docs. Kept for issue history; will be removed in milestone 0.10.0.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants