Repository navigation
docs: add AI agent skills for the Kyma CLI (v3) - #2975
Conversation
Adds a skills/ directory with four AI coding-agent skills for the open-source Kyma CLI v3, in SAP AI Skills Library format (SKILL.md + name/description frontmatter; agent-agnostic). Skills: kyma-cli (orientation, authorize, completion, app push), kyma-module-lifecycle (full lifecycle incl. channel semantics), kyma-app-deploy (push, update-in-place / SSA behavior, inject), kyma-troubleshoot (read-only-first diagnosis, common failure table). Based on kyma-project#2974 by @Jan0412, extended with: - kyma alpha authorize command group (user/group/sa/repository) - app push idempotency / Server-Side Apply update-in-place semantics - correct shell completion install instructions - regular vs fast channel explanation - catalog output format corrected from live cluster testing (v3.5.0)
|
|
|
|
✅ Proposed changes verification passedThis pull request comes with up-to-date documentation and no illegal standard output usages. Find more detailed information in the |
1 similar comment
✅ Proposed changes verification passedThis pull request comes with up-to-date documentation and no illegal standard output usages. Find more detailed information in the |
✅ Proposed changes verification passedThis pull request comes with up-to-date documentation and no illegal standard output usages. Find more detailed information in the |
2 participants
Description
Changes proposed in this pull request:
skills/directory with four AI coding-agent skills for the open-source Kyma CLI (v3), in SAP AI Skills Library format (SKILL.md+name/descriptionfrontmatter; agent-agnostic — works with Claude Code, Codex, Cursor, etc.):kyma-cli— general orientation: install, command groups (kyma module,kyma app,kyma alpha), RBAC authorization, dashboard, kubeconfig, completion, diagnostics.kyma-module-lifecycle— full module lifecycle: discover → enable → configure → verify → manage/unmanage → delete, incl. KLM prerequisites and channel semantics.kyma-app-deploy— deploying apps withkyma app push(source/Dockerfile/image),--expose, Istio injection, env/secret injection, and update-in-place (SSA) behavior.kyma-troubleshoot— read-only-first diagnosis viakyma alpha diagnose+kubectl, with a common-failure reference table.skills/README.mddescribing the format and scope.This is based on #2974 by @Jan0412, extended with the following corrections and additions after code review and live testing against Kyma CLI v3.5.0:
kyma alpha authorizeadded — the full command group (user,group,serviceaccount,repository) was absent from all skills. Covers flags, examples, and dry-run.kyma app pushupdate-in-place behavior documented — second run uses Kubernetes Server-Side Apply and updates the existing Deployment/Service/APIRule in-place; no--replaceflag needed.kyma completion zshonly prints to stdout; correct permanent install paths (fpath/ Homebrew) added.regular(stable/production) vsfast(newer/testing) explained with a note that not all modules publish to every channel.kyma module catalogalways outputsNAME | AVAILABLE VERSIONS | ORIGINwith channel info encoded as3.11.0(regular), 3.12.0(fast)tuples.Related issue(s)
See also #2974