yachiyo

Use when the user asks how Yachiyo itself works — what a feature does, what a setting changes, how to set up providers, skills, workspaces, channels, schedules, memory, or sync, where files live, or "what can you do". Reads the official documentation at yachiyo.ringo.sh so answers come from the current docs instead of memory.

Override built-in Markstream node renderers and add trusted custom tags. Use when Codex needs to apply `setCustomComponents`, install `VueRendererMarkdown` with scoped Vue app components, keep overrides scoped with `customId`, map override keys like `image`, `code_block`, `mermaid`, or `link`, or wire `customHtmlTags` and nested renderers for tags such as `thinking`.

Install and wire markstream-vue, markstream-react, markstream-vue2, markstream-angular, or markstream-svelte into an existing repository. Use when Codex needs to choose the right package, install the smallest peer-dependency set, fix CSS/reset order, choose Vue 3 renderer mode, decide between `content`, `nodes`, and Vue 3 virtual-scroll coordination, or add a minimal working renderer example.

Audit and migrate existing Markdown rendering to Markstream. Use when Codex needs to replace another renderer, classify direct vs custom vs plugin-heavy usage, preserve behavior during adoption, migrate custom renderers into scoped Markstream overrides, or decide when `nodes` streaming is worth adopting.

Integrate markstream-react into a React 18+ or Next app. Use when Codex needs to add the React renderer, import CSS correctly, choose between `content` and `nodes`, keep Next client boundaries safe, convert renderer overrides, or prepare a repo for `react-markdown` migration.

Use this skill for browser automation with the useBrowser tool — opening pages, taking snapshots, clicking and filling elements, handling page state, capturing screenshots, extracting page data, and verifying web flows. The user can see and interact with the browser window directly, and you may ask them to handle blocking steps (e.g. CAPTCHA, login, 2FA). Re-snapshot after page changes, use isolated sessions when needed, and always close the browser session when done.

Coding discipline reference for software engineering tasks. Read when starting any nontrivial code work — greenfield projects, bug fixing, writing tests, refactoring, iterating on existing codebases, writing docs, or explaining a codebase. Hub skill that points to task-specific reference files; load the reference that matches the task before editing.

Use this skill for Word document work such as reading `.docx` files, extracting content, editing existing documents, generating new `.docx` files, replacing text, updating tables, handling images, and preserving document structure. Prefer the smallest reliable workflow, keep the original file unchanged unless asked otherwise, and verify the result before finishing.

Use this skill to monitor, inspect, and interact with the user's Ghostty terminal sessions via AppleScript. List terminals, check working directories and running processes, send commands, manage windows/tabs/splits, and navigate between panes. macOS only — requires Ghostty with AppleScript enabled.

Complete reference for the Yachiyo CLI — soul traits, provider management, agent profiles, config, thread search, scheduled tasks, channel users/groups, group monitor status control, and send commands

Use this skill when you need to inspect, click, type, drag, scroll, or screenshot native macOS app windows — Safari, Finder, TextEdit, Xcode, Slack desktop, System Settings, or any other native macOS application. Triggers include requests like "click the Save button in X", "automate Finder", "read the AX tree of Y", "screenshot Xcode window", "type into TextEdit", "drag to reorder in Z", and any GUI task outside a browser.

Use this skill to automate Mail, Notes, Reminders, and Calendar on macOS via AppleScript. Create and list emails, notes, reminders, and calendar events using bundled Python wrapper scripts. macOS only.

Capture screenshots on macOS via AppleScript. Use when the user wants you to take a screenshot of their screen, a specific window, or a selected area. Supports saving to a file or copying to the clipboard. macOS only.

Use this skill for PDF work such as reading text, extracting tables, merging files, splitting pages, rotating pages, converting pages to images, creating simple PDFs, and filling forms. Start with the smallest reliable tool, preserve the source file unless the user asks to overwrite it, and verify the output before finishing.

Use this skill for presentation work such as reading `.pptx` files, extracting slide text, editing existing decks, creating new slide decks, updating speaker notes, and preserving template structure. Start with the narrowest reliable workflow, keep the original deck untouched unless asked otherwise, and verify slide output before finishing.

Use this skill when the user wants to create or update a Yachiyo skill. Create Yachiyo skills under `~/.yachiyo/skills/custom/`, define a clear trigger description, keep `SKILL.md` lean, and add references or scripts only when they materially help.

Use this skill for spreadsheet work such as reading `.xlsx`, `.xlsm`, `.csv`, or `.tsv` files, cleaning tabular data, editing workbooks, creating spreadsheets, adding formulas, formatting sheets, and validating output. Prefer the smallest reliable workflow, keep source files untouched unless asked otherwise, and verify formulas and structure before finishing.

Query the local Zotero library via its HTTP server (port 23119) — search items, browse collections/tags, read notes and full-text content, export citations, and use Better BibTeX JSON-RPC when available. Use when the user mentions Zotero, citations, bibliography, reference library, or academic papers.