Skip to content

aidenlx/zotlit / .agents/skills/docs-screenshot

docs-screenshot

Verified

Make a screenshot or illustration for the docs site, changelog, or blog — stage the scene in the running apps, capture the windows, and compose them over a wallpaper. Use when a docs page needs a new or updated image.

Docs screenshot

A docs image is a composition: one or more captures, each a layer framed as a macOS window or a callout, over a wallpaper. It matches the CleanShot X style of the images under apps/docs/public/img/.

Steps

  1. Plan the shot. Name the one thing the reader must see, then pick the layers that show it: a whole window, two windows side by side, a window with a zoomed callout. Done when you can write the image's alt text in one sentence.

  2. Stage the scene on real data that the apps made. Open the demo Vault Case — pnpm fixture open --for 10m --vault-case demo --local-api — and wrap the rest of the walk in pnpm desktop-slot run --exclusive --for <duration> -- …, an Exclusive Hold, so no other run's window moves during the capture; exit 75 means blocked by the holders it names. Read docs/fixture.md for what it holds. When the shot needs data the Fixture lacks, create it in Zotero with Zotero's own tools, then add the resulting rows to the Fixture Spec, so the next rebuild reproduces the scene. Drive the apps with /obsidian-debug and /zotero-rdp-debug. Done when every element in the planned shot is on screen with realistic content — no test titles, no placeholder text.

  3. Capture each layer as a PNG in .scratch/:

    • Obsidian: obsidian-cli.ts vault=<id> dev:screenshot path=<abs> gives the window content at 2×, without a frame. Frame it with the default layer options.
    • A capture that already has its own window frame: set lights, border, and shadow to false.
    • screencapture returns a black image when the terminal lacks Screen Recording permission. Use the app's own capture, or ask the user to grant the permission.

    Done when each capture shows its planned state. Look at each capture, and confirm through the DOM when a capture may be stale.

  4. Compose with the script beside this file:

    node .agents/skills/docs-screenshot/compose.mjs <out.webp> <capture.png | layout.json>
    

    A single capture becomes one centred window. For any other arrangement, write a layout file in .scratch/ — layers with position, scale, crop, and chrome options. compose.mjs --help prints the layout shape.

  5. Place the .webp under apps/docs/public/img/<collection>/, and reference it with a root-relative /img/... path and alt text that says what the reader sees. The rules for images are in apps/docs/AGENTS.md → Images.

  6. Verify. Look at the final image at full size, then run pnpm exec turbo run build --filter=@zotlit/docs. Done when the image shows the planned message and the build passes.

Wallpaper

wallpaper.webp is the macOS Tahoe Light wallpaper, cropped to 16:10 at 3840×2400. It is the default backdrop for every image, so the docs images stay consistent. Set "wallpaper" in a layout file to use a different image for one composition.

rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.Stars: 468kUpdated Claude CodeCodexVerifiedInstall
academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file).Stars: 197kUpdated Claude CodeCodexUnverifiedInstall
doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.Stars: 197kUpdated Claude CodeCodexVerifiedInstall