Skip to content

#215 building-blocks: lead description with Use-this-when trigger + disambiguate from content-driven-development - #249

Merged
trieloff merged 2 commits into
mainfrom
trieloff/skill-desc-building-blocks
Jul 6, 2026
Merged

#215 building-blocks: lead description with Use-this-when trigger + disambiguate from content-driven-development#249
trieloff merged 2 commits into
mainfrom
trieloff/skill-desc-building-blocks

Conversation

@trieloff

@trieloff trieloff commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

Addresses #215.

Problembuilding-blocks opened with the noun phrase "Guide for…" and had no disambiguation from content-driven-development, weakening routing.

Solution — Rewrote the description so the Use this when … trigger is the first sentence and added a For the overall development process use content-driven-development disambiguation. Content-only change to the frontmatter description.

Validated with npm run validate. Generated with AI assistance.


Pull Request opened by Augment Code | View session

@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 b989c54.

@trieloff trieloff added the ai-generated Pull request contains code generated or co-authored by AI tools label Jul 6, 2026
@trieloff
trieloff marked this pull request as ready for review July 6, 2026 18:05
@trieloff
trieloff requested a review from shsteimer as a code owner July 6, 2026 18:05
Copilot AI review requested due to automatic review settings July 6, 2026 18:05

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 building-blocks skill’s frontmatter description to improve skill routing by leading with a “Use this when…” trigger and explicitly disambiguating it from content-driven-development.

Changes:

  • Rewrote the building-blocks frontmatter description so the first sentence is a “Use this when…” trigger.
  • Added explicit disambiguation pointing users to content-driven-development for the overall development process.

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

---
name: building-blocks
description: Guide for implementing code changes in AEM Edge Delivery Services. Handles block development (new or modified), core functionality changes (scripts.js, styles, delayed.js, etc.), or both. Use this skill for all implementation work guided by the content-driven-development workflow.
description: "Use this when implementing code changes in AEM Edge Delivery Services, whether new or modified blocks, core functionality (scripts.js, styles, delayed.js, etc.), or both. Covers the hands-on implementation work guided by the content-driven-development workflow. For the overall development process use content-driven-development."
@trieloff
trieloff merged commit fb42b41 into main Jul 6, 2026
9 checks passed
@trieloff
trieloff deleted the trieloff/skill-desc-building-blocks branch July 6, 2026 18:16
@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