Repository navigation
docs(skill): cut SKILL.md to an 8 KB core with references - #377
Merged
Merged
Conversation
An agent carries SKILL.md in every turn of its session; the 20 KB skill cost about 5,000 input tokens per turn. The core keeps discovery, the profile rule, answering from stored meetings, the limits on writes and the output shape, and links six references (search, people and projects, prepare, archive, zoom-live, setup) with the rest, moved verbatim or tightened. Names removed in 0.77.0 are corrected: meetings link --event-id, and meetings create|update|cancel|invitation instead of remote-meetings. scripts/check-agent-docs.ts validates every reference's links and command paths, checks the core links each one and caps the core at 8,500 bytes; CI runs it. The package ships skills/zoom-cli/. ZM-30: do not release before the cli-base and cli-core that deliver references. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…l occurrences, filters in search Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
leemour
added a commit
that referenced
this pull request
Nov 16, 2026
#378) Moves zm to `@wirecat/cli-core` 0.681.0 and `@wirecat/cli-base` 0.106.0 and prepares 0.78.0, so the skill cut from #377 reaches npm with its `references/`. Release approved by the owner on 2026-11-16. cli-core 0.681.0 makes `skill install` write `references/*.md` beside `SKILL.md` and lets `skill show <name>` print one. Before, only `SKILL.md` was installed and its links to `references/` led nowhere. ## What changed - `package.json`, `src/version.ts`: 0.78.0. `CHANGELOG.md`: `changes/` fragments collected into `## 0.78.0 — 16.11.2026`. - `docs/commands.md` regenerated: `skill show [name]`; meetings have one more field (cli-core's optional `call`). - `contracts/help.snap`: "Works with" names notion. - `contracts/upgrade.json`: store schema 67 (was 66). - `lint/baseline/unknown-verb.json`: dropped the stale `meetings invitation` entry the lint asked to remove. - `src/command-boundaries.test.ts`: `events list` under a meetings tool now marks title, description and location untrusted. zm's `SHELL_OVERRIDES.skill` still matches the shared command: no `contract.unacknowledged-override` at start. ## Conformance - Local, on this branch: `standards:check`, `lint`, `typecheck`, `test:coverage` (755 passed), `test:matrix` (344 tested, 0 missing), `contracts:check`, `contracts:upgrade`, `docs:check`, `generate:check`, `version:check`, `lint:commands`, `security:no-leak`, `package:check`, `smoke:node`, `smoke:bun`, `check:agent-docs` — all green. - Built bin in a temp HOME with the keyring unreachable: `zm skill install` wrote `SKILL.md` and all 6 `references/*.md` into both `.claude/skills/zoom-cli/` and `.agents/skills/zoom-cli/`; `zm skill show search` printed `references/search.md` byte for byte. - No live check against Zoom: the change is the dependency bump and the skill text; no Zoom request path changed in this repository. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
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
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.
Task
Cut the agent skill so an agent that loads it pays about 2,000 tokens by default, with no rule lost.
Why
An agent carries SKILL.md in every turn of its session. A timed agent test (2026-11-16) showed a large skill adds thousands of input tokens per turn and pushes sessions past their time budget. zm's skill was 19,877 bytes (about 5,000 tokens). Same pattern as whatsapp-cli#406.
What
skills/zoom-cli/SKILL.md: 19,877 → 7,866 bytes. Frontmatter (description sharpened for questions stored meetings can answer), discovery, the profile rule, answering from meetings and recordings, writes that need the owner, output, and an index (when to read each file; relative link,zm skill show <part>, GitHub fallback).skills/zoom-cli/references/: search, people-and-projects, prepare, archive, zoom-live, setup (20,692 bytes in all). Text moved verbatim or tightened.meetings link --event-id(wasmeetings update --event-id),meetings create|update|cancel|invitation(wasremote-meetings), the series id comes frommeetings scheduled, and--dry-runshows the command and permission rather than the request. Added from 0.77.0:meetings show/meetings listask Zoom by default (--offlinereads the store only),--start-timefor create,--occurrence-idfor cancel, theremote-meetingspermission key, themeeting:read:past_meetingscope.scripts/check-agent-docs.ts(pnpm check:agent-docs, run in CI after the build): validates the core and every reference's links and command paths withvalidateSkill, checks the core links each reference, caps the core at 8,500 bytes.scripts/package-check.ts: the package shipsskills/zoom-cli/.references/(0.106.0 or later) and the cli-core that serves them over MCP (skillResources; cli-core 0.678.0 on npm still serves only SKILL.md). Checked: with cli-base 0.102.1zm skill install --for agentsinto a temporary HOME writes only SKILL.md, andzm skill show searchfails.Testing
--help; its findings were fixed (the--offlinetrap,--dry-runwording, cancel occurrences, create start time, search filters moved to search, "same over MCP" back onprojects scan, overlap note beside passages, sharper index triggers).pnpm check:agent-docs(also shown failing on a planted bad link and command),pnpm docs:check,pnpm lint, scripts typecheck,pnpm package:check,npm pack --dry-runlists all reference files, the skill tests insrc/cli-execution.test.ts.🤖 Generated with Claude Code