--- name: feimacode-open-design-recurring description: "Set up a design that rebuilds itself on a schedule (a weekly report deck, next week's social posts, a refreshed one-pager), or run one such job — one job file, one supervised run, then a one-line prompt for the scheduler — use whenever the user wants a design made again every day, every week or every month, on a schedule, or as a recurring job, or when a prompt says \"Run the Open Design job \", even if they don't mention Open Design" license: "MIT" metadata: decimalai-skill-id: "59db809d-a619-4863-9d3d-0b264b511eb2" decimalai-version-id: "c0cf2a5b-364e-4229-bb84-873c68c81c66" decimalai-version: "2" decimalai-body-sha256: "d25427c93adc5109d3509f46b98ed0b8a0cd005ad6845b8fd601197f306371da" decimalai-name: "feimacode/open-design-recurring" decimalai-format: "1" decimalai-invocation: "model" decimalai-category: "design-media" decimalai-source: "https://app.decimal.ai/s/feimacode-open-design-recurring@2/SKILL.md" --- Recurring Open Design jobs: one job file describes what to make each period, and a scheduler runs it. Request: "$ARGUMENTS" — or, if that is empty, the user's request in this conversation (if it isn't clear, ask the user: "What should be rebuilt, from which sources, and how often?") **How to talk to the user.** Many people using Open Design don't write code, so: - Use the user's own words. If they say "artifact", "design tokens" or give a file path, use those terms back; otherwise use the plain words below. - Keep the machinery out of replies: no tool names, no ids like `od:prototype:poster-hero`, no internal files (`.artifact.json`, `.comments.json`, `config.json`), and not the words "register", "manifest", "sidecar", "entry" or "surface", unless the user used them first. - Explain a print term the first time it comes up, in one short clause, and not again. - Say where a file is the way the user would find it ("in your Open Design folder, under seed-swap-flyer"). Give a raw path only where the user can click it (Claude Code, Claude Desktop's Code tab, VS Code) or asks for it. - End each reply that finishes a step with one line on what they can do next, with at most two options ("Want it in Instagram sizes too, or is it ready to print?"). | Instead of | Say | |---|---| | artifact, entry, registered | your design, saved | | design system, active design system | your style (the first time: "a saved style: colours, fonts and spacing") | | surface, skill, template, recipe | kind of design, starting layout, or nothing | | workspace, output directory | your folder, your Open Design folder | | bleed | print edge ("a few millimetres extra that the printer trims off") | | trim size | final size | | preflight findings, errors | "I checked it and fixed…", "one thing to look at:" | | export | save as PDF, save as an image | | inline preview, MCP App | the preview above | If the request names a job file (".open-design/jobs/.job.md", usually "Run the Open Design job …"), go to **Run**. Otherwise go to **Set up**. If `start_open_design_job_run` isn't one of your tools (VS Code has no scheduler, so it doesn't offer it), you can still write the job file in **Set up**, but say that scheduled runs need Claude Code or Claude Desktop with the Open Design MCP server, and stop there. ## Run 1. Call `start_open_design_job_run` with the job path (and `runNow: true` only when the person asked for a fresh run in this conversation, never from a scheduled prompt). 2. If it returns `skip`, report the reason in one line and stop. Make no changes. 3. If it asks you to check out the state branch, do that and call it again. 4. Otherwise follow its steps in order. This run is unattended: don't ask questions, never publish publicly and never post to social networks. 5. End with `finish_open_design_job_run`, follow the steps it returns, and reply with its summary. ## Set up ### 1. Agree the job With the person, settle: - **What** to make, and with which recipe: `open-design-deck-from-source` for a report deck or one-pager from data, `open-design-social-post` for a batch of posts, `open-design-poster` for a print piece, `open-design-docs` for pages from Markdown. - **Sources**: workspace files (a CSV, a CHANGELOG, a report), or data a connector pulls (a sheet in Google Drive, a Notion database). Each connector source needs a `snapshot` workspace path the pulled data is saved to, so every number stays traceable. - **How often**: `day`, `week` or `month`, and the time zone (an IANA name such as `Europe/Berlin`). - **One file or one per period**: `mode: update` rewrites the same design each period (a living report); `mode: series` keeps one file per period, with `{period}` in the target (a weekly social batch). - **Outputs**: export formats (`pdf`, `png`, `pptx`, `standalone` …). PNG, PDF, PowerPoint and video need a browser; runs without one record them as skipped. - **Delivery**: `preview` (the private Claude artifact, the default), `pr` (a pull request from the state branch), or a connector action such as "Post the preview link to #design in Slack". Never a public publish or a social post: the scheduler's prompt can't stand in for the person's yes, so the job tools refuse those. - **Checks**: `best-effort` (default) or `required`, which holds back the PR and connector deliveries when a run had no browser for the visual check. ### 2. Write the job file Write `.open-design/jobs/.job.md` (the id is lowercase with hyphens and matches the file name): ```markdown --- id: weekly-kpis title: Weekly KPI deck recipe: open-design-deck-from-source period: week timezone: Europe/Berlin mode: update target: .open-design/weekly-kpis/weekly-kpis.html outputs: [pdf] sources: - data/kpis.csv - connector: Pull last week's signups from the "Metrics" sheet in Google Drive snapshot: data/snapshots/signups.csv deliver: [preview, pr] checks: best-effort --- A five-slide KPI update for the leadership team: headline numbers first, then signups, revenue and churn against last week, with one takeaway per slide. ``` The brief is the body: write everything a run needs to decide without asking, since nobody answers questions mid-run. ### 3. One supervised run Run it now, with the person watching: call `start_open_design_job_run` and follow **Run**. Here you may ask questions; fold the answers back into the brief so later runs don't need them. If the start result lists problems by field, fix the job file and start again. When the run publishes the private preview, add its link to the job's frontmatter as `preview: { url: "" }`, so every later run republishes the same artifact. ### 4. Schedule it Give the person the exact prompt to save, and the steps for where they work: > Run the Open Design job `.open-design/jobs/.job.md` - **Claude Code cloud scheduled task** (claude.ai/code/routines, or `/schedule`): runs without their computer. The repository needs the Open Design MCP server and skills committed (`npx @feimacode/open-design-agent-kit init --tool claude`, then commit `.mcp.json` and `.claude/skills`, and the job file). There's no browser by default, so PNG, PDF and PowerPoint outputs are skipped unless the environment's setup script installs one. The run log lives on the state branch `claude/open-design-job-`. Schedule a few minutes past the hour, mid-period. - **Claude Desktop local scheduled task** (Code tab, Routines, New, Local): runs on their computer with local files and Chrome, only while the app is open and the computer is awake; a missed run gets one catch-up run, which the job skips if the period is already done. Tell them to click **Run now** once and approve each tool, so later runs aren't stopped by a prompt. - **`/loop`** in an open session: only for trying the job out; it stops when the session closes. - **Cowork scheduled tasks** aren't supported yet: the Open Design server runs only on the desktop. Point them to the [recurring jobs guide](https://github.com/feimacode/open-design-agent-kit/blob/main/docs/guides/recurring-jobs.md) for details.