Skip to content

feat: add new styling and accessibility Skills#13261

Merged
ilhan007 merged 16 commits intomainfrom
docs/ai-tooling-page
Mar 13, 2026
Merged

feat: add new styling and accessibility Skills#13261
ilhan007 merged 16 commits intomainfrom
docs/ai-tooling-page

Conversation

@ilhan007
Copy link
Copy Markdown
Contributor

@ilhan007 ilhan007 commented Mar 12, 2026

Summary

Adds Agent Skills that teach AI coding assistants how to work with UI5 Web Components:

  • styling — CSS shadow parts, custom states, CSS variables, tag-level styling, and addCustomCSS as a last resort
  • accessibility — accessibility APIs (accessibleName, accessibleNameRef, accessibleDescription, accessibleRole, accessibilityAttributes), label-input relationships, invisible messaging, icon modes, high contrast theming, and tooltips

Additionally, restructures the documentation website:

  • CLI — new page for project scaffolding and component generation
  • MCP Server — extracted into its own focused page
  • Skills — new page listing available skills and how to use them
  • Introduction — added "AI-Ready" bullet to Key Features
  • Syntax highlighting — enabled bash and json Prism languages in Docusaurus
  • Renumbered sidebar to: CLI > MCP Server > Skills > Development > Contributing > Migration Guides > Releases > FAQ

Test plan

  • Website builds successfully
  • Sidebar order is correct
  • No broken internal links
  • Code blocks render with syntax highlighting

Surface the MCP server, llms.txt, AGENTS.md, and AI components
package on the docs website so developers can discover AI-assisted
development tooling.
@ui5-webcomponents-bot
Copy link
Copy Markdown
Collaborator

ui5-webcomponents-bot commented Mar 12, 2026

🧹 Preview deployment cleaned up: https://pr-13261--ui5-webcomponents.netlify.app

@ui5-webcomponents-bot ui5-webcomponents-bot temporarily deployed to preview March 12, 2026 10:20 Inactive
@ui5-webcomponents-bot ui5-webcomponents-bot temporarily deployed to preview March 12, 2026 13:21 Inactive
@ui5-webcomponents-bot ui5-webcomponents-bot temporarily deployed to preview March 13, 2026 16:00 Inactive
- Split "AI Development" into focused pages:
  CLI, MCP Server, and Skills
- Add CLI page for project scaffolding
  and component generation
- Add Skills page for Agent Skills
- Add AI-Ready bullet to Introduction
- Add bash/json Prism highlighting
- Add styling Agent Skill (SKILL.md)
- Renumber sidebar and fix broken links
@ilhan007 ilhan007 changed the title docs: add AI Tooling page docs: restructure AI docs into CLI, MCP Server, and Skills pages Mar 13, 2026
@ilhan007 ilhan007 changed the title docs: restructure AI docs into CLI, MCP Server, and Skills pages feat: add new styling Skill Mar 13, 2026
@ui5-webcomponents-bot ui5-webcomponents-bot temporarily deployed to preview March 13, 2026 16:45 Inactive
- Add sidebar-sparkle class for highlighting new doc pages
- Align NEW/EXP/DEPR component badges to consistent style
- Vertically center all sidebar badges
@ui5-webcomponents-bot ui5-webcomponents-bot temporarily deployed to preview March 13, 2026 16:59 Inactive
@ilhan007 ilhan007 requested a review from pskelin March 13, 2026 17:23
Covers accessibility APIs, label-input
relationships, invisible messaging, icon
modes, high contrast themes, and tooltips.
@ui5-webcomponents-bot ui5-webcomponents-bot temporarily deployed to preview March 13, 2026 17:38 Inactive
@ilhan007 ilhan007 changed the title feat: add new styling Skill feat: add new styling and accessibility Skills Mar 13, 2026
Remove npx skills add instructions that don't
work. Skills are auto-discovered in the repo
and manually copied for external projects.
Skills are discoverable via npx skills add
once the branch is merged to main.
@ui5-webcomponents-bot ui5-webcomponents-bot temporarily deployed to preview March 13, 2026 18:21 Inactive
@ui5-webcomponents-bot ui5-webcomponents-bot temporarily deployed to preview March 13, 2026 18:29 Inactive
@ui5-webcomponents-bot ui5-webcomponents-bot temporarily deployed to preview March 13, 2026 18:49 Inactive
Adds an "Ask AI" dropdown button to all doc page headers that lets
users copy page content or open it in AI tools (Claude, ChatGPT, v0,
GitHub Copilot) with a pre-filled prompt about the page being viewed.

Component pages include a "View source" link to the GitHub source file.
@ui5-webcomponents-bot ui5-webcomponents-bot temporarily deployed to preview March 13, 2026 19:20 Inactive
Use float:right so the button consistently aligns next to the h1
on both component pages (synthetic title) and regular doc pages
(title from markdown content). Remove the Layout swizzle.
@ilhan007 ilhan007 merged commit 3c8381a into main Mar 13, 2026
12 of 13 checks passed
@ilhan007 ilhan007 deleted the docs/ai-tooling-page branch March 13, 2026 19:39
@ui5-webcomponents-bot ui5-webcomponents-bot temporarily deployed to preview March 13, 2026 19:39 Inactive
ilhan007 added a commit that referenced this pull request Mar 13, 2026
* docs: add AI Tooling page to documentation website

Surface the MCP server, llms.txt, AGENTS.md, and AI components
package on the docs website so developers can discover AI-assisted
development tooling.

* docs: align page title with sidebar label

* docs: update

* docs: restructure AI docs into CLI, MCP Server, Skills

- Split "AI Development" into focused pages:
  CLI, MCP Server, and Skills
- Add CLI page for project scaffolding
  and component generation
- Add Skills page for Agent Skills
- Add AI-Ready bullet to Introduction
- Add bash/json Prism highlighting
- Add styling Agent Skill (SKILL.md)
- Renumber sidebar and fix broken links

* docs: add NEW badge to MCP Server and Skills, align sidebar badges

- Add sidebar-sparkle class for highlighting new doc pages
- Align NEW/EXP/DEPR component badges to consistent style
- Vertically center all sidebar badges

* feat: add addCustomCSS as last resort in styling skill

* feat: add accessibility Agent Skill

Covers accessibility APIs, label-input
relationships, invisible messaging, icon
modes, high contrast themes, and tooltips.

* docs: fix Skills page installation instructions

Remove npx skills add instructions that don't
work. Skills are auto-discovered in the repo
and manually copied for external projects.

* docs: restore npx skills add instructions

Skills are discoverable via npx skills add
once the branch is merged to main.

* docs: fix GitHub org references from SAP/ui5-webcomponents to UI5/webcomponents

* docs: improve homepage title and meta description

* docs: refine addCustomCSS guidance in styling skill

* fix: pin sidebar badges to header row in expanded categories

* docs: add "Ask AI" dropdown to documentation pages

Adds an "Ask AI" dropdown button to all doc page headers that lets
users copy page content or open it in AI tools (Claude, ChatGPT, v0,
GitHub Copilot) with a pre-filled prompt about the page being viewed.

Component pages include a "View source" link to the GitHub source file.

* fix: align Ask AI button with page title using float right

Use float:right so the button consistently aligns next to the h1
on both component pages (synthetic title) and regular doc pages
(title from markdown content). Remove the Layout swizzle.
@ui5-webcomponents-bot
Copy link
Copy Markdown
Collaborator

🎉 This PR is included in version v2.21.0-rc.1 🎉

The release is available on v2.21.0-rc.1

Your semantic-release bot 📦🚀

@ui5-webcomponents-bot
Copy link
Copy Markdown
Collaborator

🎉 This PR is included in version v2.21.0 🎉

The release is available on v2.21.0

Your semantic-release bot 📦🚀

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

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants