Skip to content

Feat(create): add skill for @sap-ux/create cli#4846

Open
heimwege wants to merge 4 commits into
mainfrom
feat/create/cli-skill
Open

Feat(create): add skill for @sap-ux/create cli#4846
heimwege wants to merge 4 commits into
mainfrom
feat/create/cli-skill

Conversation

@heimwege

@heimwege heimwege commented Jun 16, 2026

Copy link
Copy Markdown
Contributor

Add MCP Skill for @sap-ux/create CLI

Introduces a new MCP skill (sap-fiori-create-cli) in @sap-ux/fiori-mcp-server that gives AI agents a structured reference for all @sap-ux/create CLI commands. The skill is auto-generated at build time from the existing README.md, so it stays in sync automatically.

How it works

  • packages/create/scripts/generate-skill.js reads README.md, strips badges/header/usage, prepends YAML frontmatter + behavioral guidance, and writes SKILL.md to packages/fiori-mcp-server/skills/sap-fiori-create-cli/
  • The build script in packages/create/package.json runs generate-skill.js after the existing generate-readme.js step
  • The skill version is automatically taken from package.json so it always reflects the current CLI version

Workflow sub-skill pattern

The generator supports inline workflow guides for specific commands. Drop a file at:

packages/fiori-mcp-server/skills/sap-fiori-create-cli/references/<command>-<subcommand>.md

On the next build, a pointer is automatically injected into SKILL.md next to that command:

For the full workflow guide including prerequisites and manual steps, read references/<command>-<subcommand>.md.

This allows self-contained workflow skills (e.g. for convert preview-config) to live inside the CLI skill — one install, no dependencies.

Changes

  • packages/create/scripts/generate-skill.js — new build script
  • packages/create/package.json — extend build script
  • packages/fiori-mcp-server/skills/sap-fiori-create-cli/SKILL.md — generated skill (do not edit manually)
  • packages/fiori-mcp-server/skills/sap-fiori-create-cli/references/convert-preview-config.md — first workflow guide: full migration workflow for convert preview-config including prerequisites, manual HTML sandbox init migration, Karma and WebdriverIO config updates
  • .changeset/chilly-terms-sink.md — minor bump for @sap-ux/fiori-mcp-server, patch for @sap-ux/create

@heimwege heimwege added create @sap-ux/create fiori-mcp @sap-ux/fiori-mcp labels Jun 16, 2026
@changeset-bot

changeset-bot Bot commented Jun 16, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 1a8104f

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages
Name Type
@sap-ux/fiori-mcp-server Minor
@sap-ux/create Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@heimwege heimwege changed the title Feat/create/cli skill Feat(create): add skill for @sap-ux/create cli Jun 16, 2026
@heimwege heimwege marked this pull request as ready for review June 18, 2026 08:10
@heimwege heimwege requested review from a team as code owners June 18, 2026 08:10
@hyperspace-insights

Copy link
Copy Markdown
Contributor

Summary

The following content is AI-generated and provides a summary of the pull request:


Add MCP Skill for @sap-ux/create CLI

New Feature

✨ Introduces a new MCP skill (sap-fiori-create-cli) for the @sap-ux/fiori-mcp-server package that exposes the full @sap-ux/create CLI command reference to AI agents. The skill is auto-generated at build time from the existing README.md of the @sap-ux/create package, ensuring it stays in sync with the CLI documentation.

The generated skill includes behavioral guidance for AI agents:

  • Always invoke via npx -y @sap-ux/create@latest (no global install)
  • Use --simulate before any write operation
  • Pass passwords via --password env:MY_VAR (never plain-text)
  • CF project limitations for certain subcommands (add annotations, change data-source, change inbound)

Changes

  • .changeset/chilly-terms-sink.md: Adds a changeset marking @sap-ux/fiori-mcp-server as a minor bump and @sap-ux/create as a patch bump.
  • packages/create/package.json: Extends the build script to invoke the new generate-skill.js script after the existing generate-readme.js step.
  • packages/create/scripts/generate-skill.js: New build-time script that reads README.md and package.json, strips badges/header/usage sections, prepends YAML frontmatter and behavioral guidance, and writes the resulting SKILL.md to the fiori-mcp-server skills directory.
  • packages/fiori-mcp-server/skills/sap-fiori-create-cli/SKILL.md: Auto-generated skill file providing AI agents with structured documentation for all @sap-ux/create CLI commands (generate, add, convert, remove, update, change, list, get) including all options and behavioral guidance.

  • 🔄 Regenerate and Update Summary
  • ✏️ Insert as PR Description (deletes this comment)
  • 🗑️ Delete comment
PR Bot Information

Version: 1.25.0

  • File Content Strategy: Full file content
  • Summary Prompt: Default Prompt
  • LLM: anthropic--claude-4.6-sonnet
  • Event Trigger: pull_request.ready_for_review
  • Correlation ID: cd970b5b-d354-4d6d-9378-7b8e14b41e55
  • Output Template: Default Template

@hyperspace-insights hyperspace-insights Bot 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.

The PR has two issues to address: the changeset summary prefix must be uppercased (FEAT: not feat:) to pass CI validation, and the cross-package write from generate-skill.js into fiori-mcp-server creates an implicit coupling not reflected in the dependency graph. Both have been flagged above.

PR Bot Information

Version: 1.25.0

  • File Content Strategy: Full file content
  • LLM: anthropic--claude-4.6-sonnet
  • Event Trigger: pull_request.ready_for_review
  • Correlation ID: cd970b5b-d354-4d6d-9378-7b8e14b41e55
  • Agent Instructions:

'@sap-ux/create': patch
---

feat: add skill for usage of @sap-ux/create cli

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.

Best Practices: The changeset summary prefix feat: is lowercase but the repo enforces uppercase prefixes (FEAT:, FIX:, BUMP:) via pnpm validate:changesets — this will fail the CI changeset validation gate.

Suggested change
feat: add skill for usage of @sap-ux/create cli
FEAT: add skill for usage of @sap-ux/create cli

Double-check suggestion before committing. Edit this comment for amendments.


Please provide feedback on the review comment by checking the appropriate box:

  • 🌟 Awesome comment, a human might have missed that.
  • ✅ Helpful comment
  • 🤷 Neutral
  • ❌ This comment is not helpful

const PACKAGE_JSON_PATH = path.resolve(__dirname, '../package.json');
const SKILL_OUTPUT_PATH = path.resolve(
__dirname,
'../../fiori-mcp-server/skills/sap-fiori-create-cli/SKILL.md'

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.

Maintainability: The generate-skill.js build script for @sap-ux/create writes directly into @sap-ux/fiori-mcp-server's source tree, but there is no declared dependency between these packages. Building fiori-mcp-server independently (or running tsc --build without the full build script) will leave a stale or missing SKILL.md, with no error surfaced to the consumer.


Please provide feedback on the review comment by checking the appropriate box:

  • 🌟 Awesome comment, a human might have missed that.
  • ✅ Helpful comment
  • 🤷 Neutral
  • ❌ This comment is not helpful

devinea
devinea previously approved these changes Jun 18, 2026

@devinea devinea left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

new skill and generate script look useful
changeset ✅

@sonarqubecloud

Copy link
Copy Markdown

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

Labels

create @sap-ux/create fiori-mcp @sap-ux/fiori-mcp

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants