luigidemasi opened a new issue, #124: URL: https://github.com/apache/camel-kit/issues/124
## Description Update the website documentation in this repository's `docs/` Antora component for the Claude native skill discovery and workspace migration introduced by #117 (implementation issue #103). On main at `5a28f0c545463e4ef43be81adb9b2532ea2afbb2`, these pages still describe the previous behavior: - [`agents.adoc`](https://github.com/apache/camel-kit/blob/5a28f0c545463e4ef43be81adb9b2532ea2afbb2/docs/modules/ROOT/pages/agents.adoc#L34) says initialization writes Claude slash-command files under `.claude/commands/`. - [`getting-started.adoc`](https://github.com/apache/camel-kit/blob/5a28f0c545463e4ef43be81adb9b2532ea2afbb2/docs/modules/ROOT/pages/getting-started.adoc#L194) includes that directory in the generated Claude layout. - [`skills.adoc`](https://github.com/apache/camel-kit/blob/5a28f0c545463e4ef43be81adb9b2532ea2afbb2/docs/modules/ROOT/pages/skills.adoc#L83) omits Claude's native discovery and invocation metadata. ## Required updates - [ ] Describe native `.claude/skills/<skill>/SKILL.md` discovery and the nine public skills, without duplicate generated command stubs. - [ ] Explain the hyphenated `user-invocable` metadata and the four internal skills (`camel-design`, `camel-implement`, `camel-test`, `camel-verify`), which carry `user-invocable: false` and `disable-model-invocation: true`. Internal guides remain available to the pipeline through file reads. - [ ] Explain contextual descriptions without promising that a model will always select a particular skill automatically. - [ ] Document regeneration: remove only workflow-owned legacy command filenames; preserve unrelated custom commands, including custom `camel-*.md` names. Advise backing up custom edits to generated files first. - [ ] Document rejection of symbolic links in managed/legacy Claude directory paths before initialization writes, and doctor compatibility with legacy `agent.folder=.claude/commands` configuration. - [ ] Keep release-versus-development wording accurate: do not present the post-#117 behavior as part of released 0.4.1. - [ ] Audit related generated-layout tables and cross-links under `docs/` for the same outdated claims. ## Validation Compare the documented layout and migration behavior with fresh and regenerated Claude workspaces after #117. Build the Antora documentation and check affected pages, links, and literal paths in the rendered output. Website impact: **required**. This issue tracks that work within `apache/camel-kit/docs/`. Related implementation: #103 and #117. This documentation follow-up remains open independently of the implementation PR. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
