AGENT SKILL

current-slide

Resolve which slide, page, and (optionally) selected element the user is currently viewing in the open-slide dev server. Consult this whenever the user references "this page", "this slide", "this element", "the slide I'm on", "the current page", or any deictic reference to slide content without naming it. Re-read `node_modules/.open-slide/current.json` at the start of every such turn — the user navigates between turns, so a value you read earlier in the conversation is almost certainly stale.

License 许可
MIT
最近更新
2026-11-15
Stars
★ 852
Forks
63

01 前言 Front Matter

name
current-slide
description
Resolve which slide, page, and (optionally) selected element the user is currently viewing in the open-slide dev server. Consult this whenever the user references "this page", "this slide", "this element", "the slide I'm on", "the current page", or any deictic reference to slide content without naming it. Re-read `node_modules/.open-slide/current.json` at the start of every such turn — the user navigates between turns, so a value you read earlier in the conversation is almost certainly stale.

03 SKILL.md 正文

Where is the user right now?

When the user says "fix this page", "tweak this heading", or "the slide I'm looking at", they almost never name the slide id, page number, or element — they mean wherever they are in the dev viewer. Before asking "which slide?" or "which element?", check the file the dev server writes on every navigation and inspector pick.

Re-read on every deictic turn — never reuse a prior read

current.json is a live cursor, not a fact about the conversation. The user moves between slides, pages, and elements freely between your turns — including while you were doing other work. Read the file fresh at the start of every new turn that uses a deictic reference, even if:

  • you already read it earlier in this same conversation,
  • you just finished editing the slide it pointed to,
  • the user's new message sounds like a continuation ("now make it bigger", "also fix this one", "keep going").

A "continue editing" follow-up is exactly the case where the user has likely just navigated to a different slide or picked a different element. Trusting your last read here will silently edit the wrong file. Re-read, compare slideId / pageIndex / selection against what you used last time, and act on the new values.

How to read it

node_modules/.open-slide/current.json

Path is relative to the project root (the user's cwd, the directory that contains slides/ and package.json). Use the Read tool. The file is JSON.

What you get

{
  "slideId": "q2-roadmap",
  "pageIndex": 2,
  "pageNumber": 3,
  "totalPages": 8,
  "slideTitle": "Q2 Roadmap",
  "view": "slides",
  "pagePath": "slides/q2-roadmap/index.tsx",
  "selection": {
    "line": 42,
    "column": 6,
    "tagName": "h1",
    "text": "Q2 Roadmap"
  },
  "updatedAt": "2026-05-09T14:32:11.123Z"
}
  • slideId — folder name under slides/. Use as-is for any /__slides/<id>/... API or as the URL segment.
  • pageIndex — 0-based, for use with the page array in index.tsx (export default [Cover, Body, ...]).
  • pageNumber — 1-based, for use in messages to the user ("page 3 of 8") and for the URL ?p=N.
  • pagePath — relative path to the slide source. Hand straight to Read / Edit.
  • view — "slides" (canvas view) or "assets" (asset manager). If "assets", the user is browsing files for that slide rather than viewing a page.
  • selection — null if nothing is selected. Otherwise, the JSX element the user picked in the inspector overlay:
    • line (1-indexed) and column (0-indexed) point to the JSX opening tag inside pagePath. This is the canonical handle — match against the source line, not the rendered DOM.
    • tagName is the rendered DOM tag, lowercased ("h1", "div", "img").
    • text is a trimmed text snippet (≤120 chars) from the element's textContent, useful as a sanity check that you're looking at the right node.
    • Selection auto-clears whenever the user navigates to a different slide or page.
  • updatedAt — ISO timestamp of the last navigation or selection change. Use it to detect staleness.

When to use this

  • The user references the current slide/page deictically: "this", "here", "the page I'm on", "the slide I'm looking at", "what I'm working on".
  • The user references a specific element: "this heading", "this image", "the button I just clicked", "tighten this", "change the color of this". If selection is non-null, that's the element they mean.
  • Before asking "which slide?" or "which element?" as a clarifying question — check this file first.
  • Before guessing from git log, recently-edited files, or the most recent slide folder.

When NOT to use this

  • The user names a slide explicitly ("edit q2-roadmap") — use that name directly.
  • The apply-comments workflow already finds the right file via @slide-comment markers; it doesn't need this skill.
  • For listing or discovering slides — read slides/ directly.

Staleness — verify before acting

updatedAt is the last time the user navigated. Treat it like a cache:

  • Fresh (under ~5 minutes old): trust it. Open pagePath, do the work.
  • Older than ~5 minutes: confirm with the user before editing. The dev server may not be running; the user may have switched contexts.
  • Hours/days old: ignore it. Ask the user which slide they mean.

A newer updatedAt than the one you saw last turn is the normal signal that the user has moved — switch to the new slideId / pageIndex / selection without asking.

When the file is missing

  • The dev server hasn't been opened on a slide yet, or has never run.
  • Don't create the file or guess. Ask the user which slide they mean, or suggest they open the slide in the dev server first.

Example — page-level reference

User: "tighten the spacing on this page"

  1. Read node_modules/.open-slide/current.json.
  2. Check updatedAt is recent.
  3. Read pagePath (e.g. slides/q2-roadmap/index.tsx).
  4. Identify the page at pageIndex in the default-exported array.
  5. Consult the slide-authoring skill for spacing rules, then edit that page in place.

If current.json is missing or stale, ask: "Which slide and page should I tighten? The dev server hasn't published a current page recently."

Example — element-level reference

User: "make this bigger"

  1. Read node_modules/.open-slide/current.json.
  2. If selection is non-null, the user means that element. Read pagePath, jump to selection.line, and find the JSX opening tag near that line/column. Confirm with the snippet in selection.text and the tagName.
  3. Consult slide-authoring for type-scale and layout rules before editing.
  4. Edit the JSX node in place.

If selection is null, fall back to the page-level flow above — and consider asking "which element?" since the user used a deictic but hasn't picked one in the inspector.

04 同仓库更多 Skills

BotHarness
BotHarness/DeepSeekBot

slide-authoring

Technical reference for writing or editing open-slide pages — file contract, 1920×1080 canvas, type scale, layout, palette/visual direction, assets, speaker notes, stepped reveals, page transitions, and morph transitions. Consult this whenever you are about to write or modify any file under `slides/<id>/`, including from inside the `create-slide` or `apply-comments` workflows, or for any ad-hoc slide edit. Triggers on phrases like "edit slide", "tweak this page", "fix the layout", "change the palette", "reveal one by one", "add a transition", "morph transition", "write the speaker notes", "generate the script / talk track", "investigate the slide framework", "how do slides work here".

★ 852
BotHarness
BotHarness/DeepSeekBot

create-theme

Use this skill when the user wants to create, draft, author, or extract a slide theme in this open-slide repo. Triggers on phrases like "create a theme", "make a theme called X", "extract a theme from <slide>", "build a theme from these images". Produces two paired files under `themes/` — `<id>.md` (palette, typography, layout, fixed Title/Footer components, motion) and `<id>.demo.tsx` (a runnable demo slide that the dev-UI Themes panel previews). Do NOT use for editing real slides — only for authoring the theme bundle.

★ 852
BotHarness
BotHarness/DeepSeekBot

create-slide

Use this skill when the user wants to create, draft, author, or generate new slides / a presentation in this open-slide repo. Triggers on phrases like "make slides about X", "make a deck about X", "create a presentation", "draft slides for", "new slide", "a deck with speaker notes / a script", or when the user asks to add content under `slides/`. Do NOT use for editing the framework itself — only for authoring content inside `slides/<id>/`.

★ 852
BotHarness
BotHarness/DeepSeekBot

apply-comments

Apply pending @slide-comment markers written by the open-slide inspector tool. Use when the user asks to "apply comments", "process slide comments", "apply the inspector comments", or references markers left inside `slides/<id>/index.tsx`.

★ 852
BotHarness
BotHarness/DeepSeekBot

writing-shape

Writing, exploit: shape raw material into an article, paragraph by paragraph.

★ 852
BotHarness
BotHarness/DeepSeekBot

writing-fragments

Writing, explore: mine raw fragments, no structure yet.

★ 852