validating-and-publishing-canvases — Claude Code skill
The validating-and-publishing-canvases skill for Claude Code checks PostHog Canvas source projects and publishes them with version guards. It verifies declared capabilities and handles merge conflicts without data loss.
no license 148 installs ★ 101 updated 2026-10-24
npx skills add PostHog/ai-plugin --skill validating-and-publishing-canvases -a claude-codeWhat validating-and-publishing-canvases does
The skill inspects PostHog Canvas source trees before deployment to ensure clean builds. It tracks the current_version_id baseline and checks that platform dependencies remain untouched. Adding unauthorized npm packages immediately fails validation.
Runtime permissions require explicit registration under capabilities. The host enforces exact HTTPS origins, PostHog insight identifiers, capture events, and read-only connector tools. Any private hostnames or loopback targets like localhost trigger validation failures.
Publishing applies via ordered string replacements through canvas-edit-create or full project uploads. Server-side checks guard against race conditions, rejecting concurrent overwrites with a 409 conflict.
What it helps with
- validate PostHog Canvas source files against platform requirements
- declare external HTTPS origins and PostHog API capabilities
- publish canvas updates via structured text operations
- resolve version conflict errors without overwriting changes
Example prompts for the agent
- Validate the PostHog canvas project and inspect reported diagnostics
- Add external HTTPS origin to canvas capabilities and push the edit
- Resolve version conflict 409 for the current canvas publish
How to install validating-and-publishing-canvases
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill validating-and-publishing-canvases -a claude-code2Manually: put the files in place
~/.claude/skills/validating-and-publishing-canvases/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/validating-and-publishing-canvases/
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill validating-and-publishing-canvases -a codex2Manually: put the files in place
.agents/skills/validating-and-publishing-canvases/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill validating-and-publishing-canvases -a cursor2Manually: put the files in place
.cursor/skills/validating-and-publishing-canvases/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install PostHog/ai-plugin skills/validating-and-publishing-canvases2Manually: put the files in place
.github/skills/validating-and-publishing-canvases/SKILL.md1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill validating-and-publishing-canvases -a gemini-cli2Platform CLI
gemini skills install https://github.com/PostHog/ai-plugin --path skills/validating-and-publishing-canvasesManually: put the files in place
.devin/skills/validating-and-publishing-canvases/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill validating-and-publishing-canvases -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about validating-and-publishing-canvases
How to install validating-and-publishing-canvases in Claude Code?
Run npx skills add PostHog/ai-plugin --skill validating-and-publishing-canvases -a claude-code. The definition lands in ~/.claude/skills/validating-and-publishing-canvases/SKILL.md.
What does validating-and-publishing-canvases do?
It guides safe authoring and deployment of PostHog Canvases, running pre-publish checks on capabilities, file structures, and version state.
Which network hosts pass validation in capabilities?
Only public HTTPS endpoints specifying scheme, host, and optional port are accepted. Internal domains, wildcards, and localhost entries cause immediate validation errors.