Add plonecli Agent Skill and 'skill install/update' command#98
Merged
Conversation
git pull --ff-only fails when origin has been rebased or force-pushed. Since the copier-templates clone is plonecli-managed, refresh it via fetch + hard-reset to origin/<branch> instead.
Install vhs, agg, ttyd (plus asciinema and ffmpeg) in the devcontainer so demo screencasts can be rendered from scripted tapes. Add three vhs tapes covering the main plonecli template categories — backend, REST API, classic UI — and the recording-driver prompt that documents pacing and prompt-driving conventions.
Re-applies the claude-code-devcontainer template: host Claude config sync in setup-claude.sh, drop OpenCode, split firewall rules for Plone/PyPI and remove defunct statsig/opencode hosts, preserve container on stop for fast restart, and track copier answers (incl. extra_mounts for the live copier-templates bind and terminal-recording toolchain).
Documents create/add/setup/serve/test/debug/update/config commands, with template/subtemplate gating and reconfigure flows. Reference docs cover project creation, feature subtemplates, and maintenance. Corrects the addon vs backend_addon distinction (addon is a composite of backend_addon + zope-setup, not an alias), notes that the invoke harness (tasks.py) comes from the zope-setup layer, and documents the PLONECLI_TEMPLATES_DIR override for templates discovery. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
MrTango
changed the title
Relocate the bundled Agent Skill to plonecli/skills/plonecli (canonical, ships in the wheel) and expose it at the repo root via .agents/skills and .claude/skills symlinks. Add a 'skill' command that installs the same SKILL.md into a project or user scope following the Agent Skills open standard, so Claude Code, Codex, Gemini CLI, Cursor and other compatible agents load it from one source.
Convert the 15 MB animated GIF screencast to a 4.2 MB VP9 WebM and point the vhs tape at the new output. The bulky GIF is also dropped from the branch history so it never enters the repository pack.
MrTango
force-pushed
the
add-plonecli-skill
branch
from
32f0f65 to
8b6c4dc
Compare
Add a Demo section with an HTML5 video embed of the WebM screencast and a fallback link for renderers that do not play inline video.
Instruct the skill to scaffold a GenericSetup upgrade step via 'plonecli add upgrade_step' whenever profiles/default XML changes must reach already-installed sites. Document the subtemplate prompts, what it modifies, and which profile changes need a step.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
plonecliAgent Skill that teaches AI coding agents how to scaffold and develop Plone packages with the copier-template based plonecli, including reference docs for the create, add, and maintain workflows.plonecli/skills/plonecli/(single source, included in the wheel) and expose it at the repo root via.agents/skills/plonecliand.claude/skills/ploneclisymlinks.plonecli skill install | update | statusto install the skill into a project (default) or globally for the user (--scope user). Following the Agent Skills open standard, it writes one copy to.agents/skills/plonecli(the standard discovery path) and links it from.claude/skills/plonecli, so Claude Code, Codex, Gemini CLI, Cursor and other compatible agents all load the sameSKILL.md. Supports--copy(no symlinks) and--force.docs/demo-backend.gif) for the existingdemo-backend.tape.Test plan
tests/test_skill.pycovers install/update/status, the existing-install guard, copy-only, and the CLI command (7 tests).claude/skills/ploneclisymlink