Skip to content

jtenniswood/espcontrol / .agents/skills/mock-feature-screens

mock-feature-screens

Verified

Create realistic EspControl feature screen mockups by fitting actual editor screenshots into the local device photo templates, with custom card colours, soft reflections and gentle blur. Use for device feature illustrations and requested configuration screenshots or documentation integration; not for generic image generation or changing firmware behaviour.

FileKindSize
SKILL.mdskill md4.9 KB
agents/openai.yamlconfig257 B
assets/weather-example.jsonconfig398 B
references/capture.mdmarkdown3.6 KB
scripts/capture-preview.cjsscript5.1 KB
scripts/compose-screen.cjsscript6.9 KB

references/capture.md

View on GitHub
# Capture the actual EspControl preview

Use the active repository's installed development dependencies. The capture helper builds a fresh test bundle into a temporary directory and uses the existing browser smoke harness to simulate a panel. It does not connect to a real device or Home Assistant.

```sh
node <skill-dir>/scripts/capture-preview.cjs \
  --repo <active-worktree> \
  --config <fixture.json> \
  --out <screen-preview.png>
```

For a configuration-dialog screenshot, add `--admin-slot <slot>` and `--admin-out <settings.png>`. Both options are required together. This captures the configured card's real editor without changing its settings.

If the host shell lacks Node or packages, use `load_workspace_dependencies`, put the returned Node binary directory on PATH for the build subprocess, and make `sharp` available through NODE_PATH for compositing. Prefer the repository's existing dependency install for the web build and Playwright. Browser launch may require the host's normal execution approval.

## Fixture format

Supply a JSON object with `buttons` (slot-to-saved-card-record mapping), `settings` including `button_order`, and optionally `subpages`. These are native configuration fields used by the repository's `nativeConfigState` browser fixture. Do not infer record syntax from the number of semicolons: inspect examples and current model code for the requested card type.

The included `assets/weather-example.json` shows all four weather modes using supported `card_off_color` options: cyan `00B8CF`, blue `0457D9`, sky blue `0083D6`, forecast blue `075ACB`. Use a feature-appropriate subset or palette when requested.

Common grid tokens for this square device are an unsuffixed slot for 1×1, `w` for 2×1, `b` for 2×2, `x` for 3×1, `h` for 3×2 and `q` for 3×3. Verify tokens against `src/webserver/model/grid.ts` when needed. Fit the screen rather than adding empty placeholder cells to the illustration.

Both supported photo templates show a square ESP32-P4-86 display and work with the same captured screen. The helper captures that device profile at a consistent scale. For another device shape, use a matching template and capture profile instead of stretching this square example.

## Harness compatibility

The helper exposes a small set of functions from `scripts/check_web_browser_smoke.js` before its main test entrypoint; it does not run the full test suite. If that file, entrypoint or helper names change, it stops with a compatibility error. Inspect and adapt the capture bridge to the current repository rather than editing production code or reusing a stale screenshot.

If a requested detail popup is not represented by the browser preview, explain that limitation. Use an actual supplied screen capture or implement a faithful source-based reference with explicit agreement; do not label a guessed UI as an actual screenshot.

## Local template setup

No original photo templates are tracked in the repository. Existing users can keep them in the personal skill's `assets` directory. For another machine, keep the supplied transparent-screen images in a local folder using the filenames `device-template.webp` and `device-template-2.webp` (convert PNG to lossless WebP when needed), then set `ESPCONTROL_MOCK_TEMPLATE_DIR` to that folder. The helper accepts lossless WebP or PNG content. You can also pass an explicit local image path instead of an alias.

An explicit `ESPCONTROL_MOCK_TEMPLATE_DIR` is authoritative: a missing file reports an error instead of falling back to a different directory. Both templates use the same square preview and `--glass` finish. Keep this local asset folder outside the checkout; only finished mockups belong in documentation assets.
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: 472kUpdated 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: 198kUpdated 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: 198kUpdated 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: 198kUpdated Claude CodeCodexVerifiedInstall