Skip to content

#215 docs-search: lead description with Use-this-when trigger - #258

Merged
trieloff merged 2 commits into
mainfrom
trieloff/skill-desc-docs-search
Jul 6, 2026
Merged

#215 docs-search: lead description with Use-this-when trigger#258
trieloff merged 2 commits into
mainfrom
trieloff/skill-desc-docs-search

Conversation

@trieloff

@trieloff trieloff commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

Addresses #215.

Problemdocs-search's trigger was the second sentence rather than the opening line, weakening routing.

Solution — Rewrote the description so the Use this when … trigger is the first sentence, following the recommended Use this when <trigger>. Covers <topics>. pattern. Content-only change to the frontmatter description.

Validated with npm run validate. Generated with AI assistance.


Pull Request opened by Augment Code | View session

@trieloff trieloff added the ai-generated Pull request contains code generated or co-authored by AI tools label Jul 6, 2026
@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

Tessl Plugin Lint

⚠️ edge-delivery-services — 1 warning(s)
⚠ Skill 'code-review': SKILL.md is approximately 10315 tokens (recommended maximum: 5000). Consider moving detailed content to separate reference files.

✔ Plugin adobe/aem-edge-delivery-services@0.1.0 is valid

✅ All 1 plugin(s) lint passed with 1 warning(s) total.

Updated by tessl-lint for commit deaa94b.

@trieloff
trieloff marked this pull request as ready for review July 6, 2026 18:02
@trieloff
trieloff requested a review from shsteimer as a code owner July 6, 2026 18:02
Copilot AI review requested due to automatic review settings July 6, 2026 18:02

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

Updates the docs-search skill’s frontmatter description so routing guidance starts with a clear “Use this when …” trigger, improving skill selection reliability per issue #215.

Changes:

  • Rewrote the docs-search SKILL.md frontmatter description to lead with “Use this when …”.
  • Kept the change content-only (frontmatter description).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

---
name: docs-search
description: Searches the aem.live documentation for information on AEM Edge Delivery Services features. Use this skill when you need more information about a feature, want guidance on how to implement a feature, and using existing tools you have to search the web isn't turning up relevant results.
description: "Use this when you need more information about an AEM Edge Delivery Services feature or guidance on how to implement one, and your existing web-search tools are not turning up relevant results. Covers searching the aem.live documentation."
@trieloff
trieloff merged commit c3feebc into main Jul 6, 2026
9 checks passed
@trieloff
trieloff deleted the trieloff/skill-desc-docs-search branch July 6, 2026 18:11
@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

🎉 This PR is included in version 1.0.1 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

🎉 This PR is included in version 2.0.1 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

🎉 This PR is included in version 1.0.1 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

🎉 This PR is included in version 1.2.1 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

🎉 This PR is included in version 2.0.1 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

🎉 This PR is included in version 2.0.1 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

@github-actions

github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

🎉 This PR is included in version 2.2.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

@github-actions

Copy link
Copy Markdown
Contributor

🎉 This PR is included in version 1.0.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ai-generated Pull request contains code generated or co-authored by AI tools released

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants