Branch: refs/heads/screenshot-framing Home: https://github.com/xwiki/xwiki-dev-llm Commit: 3b99c44b4dd15b93488e3a03263fcdce1a9e6b56 https://github.com/xwiki/xwiki-dev-llm/commit/3b99c44b4dd15b93488e3a03263fcd... Author: Vincent Massol <[email protected]> Date: 2026-08-14 (Fri, 14 Aug 2026) Changed paths: M .claude-plugin/marketplace.json M kimi.plugin.json M opencode.jsonc M xwiki/.claude-plugin/plugin.json M xwiki/okf/conventions/documentation.md M xwiki/skills/xwiki-doc-writing/SKILL.md M xwiki/skills/xwiki-doc-writing/tools/README.md M xwiki/skills/xwiki-doc-writing/tools/docshot.sh Log Message: ----------- [Misc] Capture how a documentation screenshot is framed * okf/conventions/documentation.md: new durable rule next to the screenshot standards. A step's screenshot carries the element to act on plus the nearest landmark that fixes its position (the panel holding it, the screen title above it, the list it follows) and nothing else, the test being whether a reader without the UI in front of them still knows where the action happens. Only a procedure's entry step keeps the surrounding chrome. The `size` follows from the region framed rather than the region being stretched to fill a size, and the existing capture-width bullet now says the width comes from *cropping* a region, not from shrinking a wider capture — which is also why a whole-window shot at `extra` is the blurriest of the options. The red box marks what the step asks for: on a "review the listed accounts" step it belongs around the list, not around the button under it. * skills/xwiki-doc-writing: framing added to the attachment step and as its own review-checklist item, since a page whose every step repeats the same window passes every other check. * skills/xwiki-doc-writing/tools/docshot.sh: takes `x,y,w,h` as the capture target, so a region can be shot at the exact `size` width without resampling; a narrower region is refused rather than upscaled into blur. Two traps documented in tools/README.md, because both fail silently: the CLI has no `--clip` (hence a transparent clip element) and macOS `sips -c` crops from the centre with `--cropOffset` as a no-op, which saves a plausible PNG of the wrong part of the page. A box selector may be prefixed `union:` for one box around several elements, and the box padding is now symmetric — it used to sit flush against the element's right and bottom edges. * Bumped the plugin version to 1.0.27 (patch, content edit) in all five synced fields. Co-Authored-By: Claude Opus 5 (1M context) <[email protected]> To unsubscribe from these emails, change your notification settings at https://github.com/xwiki/xwiki-dev-llm/settings/notifications