hyday

Hyday Skills

中文版本：README.zh-TW.md

Agent skills for Hyday — a desktop notes & journal app.

These skills follow the Agent Skills specification so they can be used by any skills-compatible agent, including Claude Code, Codex CLI, and OpenCode.

Once installed, your AI agent will know how to read and write notes inside your Hyday vault correctly — frontmatter shape, journal filename conventions, the five Life Log marks, where files go, and what the whiteboard can and cannot do.

If you only do one thing

Install hyday-markdown first. Every other skill builds on its conventions (frontmatter shape, #tag / @(entity) / [[backlink]] syntax), and 80% of an agent's value in Hyday is "write me a note that won't break Hyday's parser." hyday-lifelog, hyday-vault-layout, and hyday-whiteboard are worth adding once that one is in place — but a single hyday-markdown already gets the agent past the most common failure mode (writing files Hyday can't read back cleanly).

Quick start for agents

The first thing any Hyday skill does is locate the vault root: the folder on disk where the user's notes live. Read it from Hyday's config file before doing anything else:

• macOS: ~/Library/Application Support/Hyday/settings.json → journalPath field
• Windows: %APPDATA%\Hyday\settings.json → journalPath field
• Fallback: ~/.hyday-recovery (same JSON shape)
• Last resort: ask the user

See skills/hyday-vault-layout/SKILL.md Step 0 for the full resolution chain and sanity checks. Every other skill assumes you've already done this — skipping it means writing to the wrong directory or failing silently.

Installation

Pick ONE of the methods below. Installing through more than one (e.g. plugin marketplace + npx skills) puts duplicate SKILL.md files in your Claude Code session and behavior gets confusing — pick the one that fits your agent and stick with it.

Claude Code plugin marketplace (recommended for Claude Code)

/plugin marketplace add mukiwu/hyday-skills
/plugin install hyday@hyday-skills

Update / remove later via /plugin commands. This is the cleanest path if Claude Code is your only agent.

npx skills (cross-agent: Claude Code / Codex CLI / OpenCode)

# install
npx skills add https://github.com/mukiwu/hyday-skills
# (or with SSH)
npx skills add git@github.com:mukiwu/hyday-skills.git

# list installed
npx skills list

# update (all / or a specific one)
npx skills update
npx skills update hyday-skills

# remove
npx skills remove hyday-skills

After update, restart your agent (Cmd+Q Claude Code and reopen) so the new SKILL.md files reload.

Manually

Claude Code

Clone this repo somewhere and copy the skills/ directory into your project's .claude/skills/. Claude Code auto-loads every SKILL.md inside .claude/skills/.

From your Hyday vault folder (or wherever you launch Claude Code from):

# clone once
git clone https://github.com/mukiwu/hyday-skills.git ~/hyday-skills

# install into a Claude Code workspace
mkdir -p .claude/skills
cp -R ~/hyday-skills/skills/* .claude/skills/

# (optional) install the whiteboard MCP server too
cp -R ~/hyday-skills/mcp-servers .claude/
cd .claude/mcp-servers/hyday-whiteboard && npm install && cd -

Then add the MCP server entry to your .mcp.json (see mcp-servers/hyday-whiteboard/README.md). See the Claude Skills documentation for the full reference.

Codex CLI

Copy the skills/ directory into your Codex skills path (typically ~/.codex/skills/):

git clone https://github.com/mukiwu/hyday-skills.git /tmp/hyday-skills
mkdir -p ~/.codex/skills
cp -R /tmp/hyday-skills/skills/* ~/.codex/skills/

See the Agent Skills spec for the standard skill format.

OpenCode

Clone the full repo into ~/.opencode/skills/:

git clone https://github.com/mukiwu/hyday-skills.git ~/.opencode/skills/hyday-skills

OpenCode auto-discovers SKILL.md files. Restart OpenCode after cloning.

Skills