Skip to content

Docs: install the skill, scene transitions, capability gap audit - #23

Merged
jasp402 merged 1 commit into
mainfrom
docs/install-skill-and-transitions
Oct 24, 2026
Merged

jasp402 merged 1 commit into
mainfrom
docs/install-skill-and-transitions

Conversation

@jasp402

@jasp402 jasp402 commented Oct 24, 2026

Copy link
Copy Markdown
Owner

What

  • README: new "Install the skill" section (claude.ai / Claude Desktop / Claude Code), how to build and test the ZIP, and what a connector-only user loses.
  • Skill ZIP: npm run build:skill (reproducible, no dependencies; enforces Anthropic's documented name and 200-char description limits). SKILL.md description shortened from 293 to 198 characters (the current release ZIP exceeds the documented limit).
  • Scene transitions: real contract documented (fade, slide, push, wipe, clockWipe, iris, zoom, flip, blur; dir, ease, defaults, ignored cases), new reference section, tested example, compact transitions + start fields in get_capabilities, and SCENE*/TRANSITION_* warnings in validate_json.
  • docs/CAPABILITY-GAP-AUDIT.md: Studio capability vs what the model is told, the "hundred skills" question, proposed on-demand recipe architecture, roadmap, analysis of why S1 text did not render.

Token impact (estimates, tiktoken cl100k)

Always loaded: +53 (tools/list +69, skill front matter -16). get_capabilities result: -164 despite the additions. Skill body +69 and motion-design.md +713 are loaded on demand only.

Verified

npm test 103/103. Example accepted by local and live validate_json (only CONTRACT_NOT_CHECKED). .hcmotion round-trips through the Studio's decodeHcmotion/checkComposition and transitionAt (read-only, via tsx). ZIP passes zipfile.testzip(), unzip -t and an independent reader. npx skills add installs to ~/.claude/skills.

Not verified

Skills upload on a real Free claude.ai account; Claude Desktop UI; Claude Code loading the skill; claude.ai dropping instructions (community reports only); how transitions look in a browser; S1 hypotheses H1/H2.
The live server is still the old version; the new warnings appear after deploy.

- README: "Install the skill" for claude.ai, Claude Desktop and Claude Code, how to build and test the ZIP, and what a connector-only user loses.
- scripts/build-skill-zip.mjs (npm run build:skill): reproducible skill ZIP; enforces Anthropic's name and 200-char description limits. SKILL.md description shortened from 293 to 198 chars.
- Scene transitions: document the real contract (fade, slide, push, wipe, clockWipe, iris, zoom, flip, blur), add a tested example, expose it compactly in get_capabilities (with a short start guide for connector-only users) and warn on SCENE*/TRANSITION_* problems in validate_json.
- get_capabilities: shared properties listed once (commonProperties), result is smaller even with the additions.
- docs/CAPABILITY-GAP-AUDIT.md: what Studio can do vs what the model is told, the "hundred skills" question, proposed recipe architecture, roadmap.
@vercel

vercel Bot commented Oct 24, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
hypercodemotion-mcp-service Building Building Preview Oct 24, 2026 10:38pm UTC

@jasp402
jasp402 merged commit 3dd2acf into main Oct 24, 2026
4 checks passed
@jasp402
jasp402 deleted the docs/install-skill-and-transitions branch October 24, 2026 22:44

This branch was successfully deployed

1 active deployment
Preview — cb05a94e Deployed Oct 24, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant