# Agent Skills — Henry Chen

> 23 skills in 7 plugins, published from https://github.com/Misoto22/skills (v0.15.0). This document is rendered from the repository's registry.json, the same source the pages under https://misoto22.com/skills render; the human pages are linked from every entry.

## Install

- Claude Code: `/plugin marketplace add Misoto22/skills` then `/plugin install all@misoto22` — `all` depends on every plugin and bookmark below; name one plugin instead to take a subject on its own.
- Codex: `codex plugin marketplace add https://github.com/Misoto22/skills` then `codex plugin add all@misoto22`
- Cursor, Windsurf, opencode and about seventy other agents: `npx skills add Misoto22/skills` — narrow it with `--skill <name>`. Listed on https://skills.sh/Misoto22/skills.
- claude.ai and Cowork: upload the `.skill` archive from https://github.com/Misoto22/skills/releases/latest. Every release carries SHA256SUMS and a signed build attestation.

## Writing (`writing`)

Prose aimed at a person — evidence-safe personal blog articles, outbound email under policy, and workplace message rewrites that preserve the underlying request.

Install: `/plugin install writing@misoto22`

- **email** — `/writing:email` — Draft, reply to, forward, format, send, or verify outbound email under a policy — drafting is the default, and sending stays blocked until a narrow local scope authorizes that exact message. Use when recipients, external disclosure, attachments, authorization, HTML bodies, or Sent-folder confirmation matter, and on requests such as write an email to, reply to this thread, draft a note to the client, forward this with a cover note, send it and confirm it arrived, 写封邮件给, 回一下这个, 帮我发出去, 这封邮件再改改. Not for triaging or summarising a mailbox you are not answering, chat and internal notes, or rewriting how a message sounds without sending it.
  page: https://misoto22.com/skills/email · source: https://github.com/Misoto22/skills/blob/main/plugins/writing/skills/email/SKILL.md · licence: MIT
- **tempering** — `/writing:tempering` — Rewrites blunt, sarcastic, or impatient workplace messages into professional ones that retain the underlying request, offering three registers from collegial to formally documented. Use when a draft is addressed to a colleague, manager, client, vendor, or cross-team counterpart and carries visible frustration — sarcasm, blame, exasperation, ultimatums, or lines such as "are you serious", "脑子有问题", "到底做不做", "有没有一个准信". Trigger on requests to make a message professional, soften it, tone it down, check whether it is too harsh, or work out how to say something without damaging the relationship, including 润色一下, 帮我改得客气点, 这样发出去会不会太冲, 怎么说才不得罪人. Also handles the reverse direction — plain-language interpretation of corporate phrasing when asked what a message actually means, 说人话, or decode this. Not for marketing copy, resumes, blog posts, or grammar cleanup without interpersonal stakes.
  page: https://misoto22.com/skills/tempering · source: https://github.com/Misoto22/skills/blob/main/plugins/writing/skills/tempering/SKILL.md · licence: MIT
- **personal-blog** — `/writing:personal-blog` — Use when researching, outlining, drafting, revising, or polishing a personal blog article—an explainer, idea essay, personal essay, cultural review, or technical post—or when asked to preserve voice in a personal blog draft, turn notes into a personal blog post, 写博客, or 写一篇博客. Not for newsletters, magazine profiles, manuscript editing, email, chat, repository documentation, marketing copy, fiction, academic papers, or generic grammar cleanup.
  page: https://misoto22.com/skills/personal-blog · source: https://github.com/Misoto22/skills/blob/main/plugins/writing/skills/personal-blog/SKILL.md · licence: MIT

## Docs (`docs`)

The face a repository shows a stranger — README, banner, licence, security and contribution policy, and the forge's own description and topics, written from what the repository's files say rather than from its name.

Install: `/plugin install docs@misoto22`

- **repo-polish** — `/docs:repo-polish` — Build or restore a repository's public face — README, hero banner, LICENSE, SECURITY.md, CONTRIBUTING.md, the forge's one-line About text, and its GitHub or GitLab topics — written from what the repository's own files say. Every pass runs unless flags narrow it. Use when asked to 装修一下仓库, 仓库装修, 美化仓库, 把开源文件补齐, 写个 readme, 加个 license, 补个安全策略, 设置仓库 topics, 仓库描述写一下, polish this repo, set the repo up properly, add a security policy, fill in the repository description, or tag a repository on GitHub. Not for API reference docs, changelogs, release notes, marketing landing pages, or the source code itself.
  page: https://misoto22.com/skills/repo-polish · source: https://github.com/Misoto22/skills/blob/main/plugins/docs/skills/repo-polish/SKILL.md · licence: MIT · arguments: `[--readme] [--banner] [--license] [--security] [--contributing] [--description] [--topics] [--audit] [--dry-run]`

## Dev (`dev`)

The loop around a change — pull the base branch level, land the change as a merged pull request, then remove what shipping left behind — and a steward that runs that loop across every active repository at once.

Install: `/plugin install dev@misoto22`

- **sync** — `/dev:sync` — Bring the local repository in line with its remote — fetch, prune, fast-forward the base branch, and report what diverged. It never rebases a feature branch, never resolves a conflict, and never discards a local commit. Use when asked to sync, pull latest, update from main, get up to date, catch up with remote, 同步一下, 拉一下最新的, 更新到最新, 跟 main 对齐, 更新一下代码. Not for shipping changes, deleting merged branches, or resolving a merge conflict.
  page: https://misoto22.com/skills/sync · source: https://github.com/Misoto22/skills/blob/main/plugins/dev/skills/sync/SKILL.md · licence: MIT · arguments: `[--base=<branch>] [--all]`
- **ship** — `/dev:ship` — Ship the current changes as a merged pull request — branch off, run the project's tests, commit, open the PR, wait for CI, merge, and clean up the worktree. Runs a preflight first that marks each step RUN or SKIP, so a clean tree on the base branch exits without doing anything. Use when asked to ship it, ship this, land it, get this merged, open a PR and merge it, push this up and merge, 发出去, 合掉, 开个 PR 合了, 把这些改动提上去, 推上去合并. Not for tagging a release, publishing a package, deploying, or writing a commit message without pushing it.
  page: https://misoto22.com/skills/ship · source: https://github.com/Misoto22/skills/blob/main/plugins/dev/skills/ship/SKILL.md · licence: MIT · arguments: `[branch-name] [--dry-run] [--no-test] [--draft] [--base=<branch>] [--bump=<version|major|minor|patch>] [--merge-strategy=<squash|merge|rebase>]`
- **cleanup** — `/dev:cleanup` — Remove what shipping left behind — local and remote branches whose pull request merged, worktrees for those branches, and ignored residue a move stranded, such as a __pycache__ that git mv could not see. Every deletion is verified against the forge first, and anything unmerged or unexplained is reported rather than removed. Use when asked to clean up, tidy the repo, delete merged branches, remove stale branches, prune the remote branches, clear out old worktrees, 清理一下, 清掉合并过的分支, 删掉没用的分支, 清理远程分支, 收拾一下仓库. Not for discarding uncommitted work, resetting a branch, or removing untracked files you have not been shown.
  page: https://misoto22.com/skills/cleanup · source: https://github.com/Misoto22/skills/blob/main/plugins/dev/skills/cleanup/SKILL.md · licence: MIT · arguments: `[--base=<branch>] [--branches] [--remote] [--worktrees] [--residue] [--no-remote] [--dry-run]`
- **retitle** — `/dev:retitle` — Normalize agent conversation titles onto a dated `MMDD｜TYPE｜subject` scheme — English by default, Chinese with `--lang=zh` — across Codex, Claude Code, and any client that exposes its session list. The date comes from creation time, the middle field from a closed set of nine types, and every rename is proposed as a two-column table before a single title is written. Use when asked to 规范对话名称, 整理会话标题, 统一对话命名, 批量重命名会话, 会话名太乱了, clean up my conversation titles, rename my chat sessions, or make my session names consistent. Not for renaming projects, folders, git branches, worktrees, or files; not for editing, archiving, pinning, or deleting the conversations themselves.
  page: https://misoto22.com/skills/retitle · source: https://github.com/Misoto22/skills/blob/main/plugins/dev/skills/retitle/SKILL.md · licence: MIT · arguments: `[--client=codex|claude-code] [--lang=en|zh] [--tz=<zone>] [--apply]`
- **steward** — `/dev:steward` — Sweep every repository your agent sessions have touched, found from the agent's own session records and any roots you name, and run the dev loop's housekeeping across all of them at once — fast-forward each base branch, remove what already merged, keep conversation titles in scheme, and report which branches are ready to merge, which pull requests are blocked, and which worktrees a live session still occupies. Built to run unattended on a schedule, so a question a pass would have stopped to ask lands in the report instead. Use when asked to 巡一遍所有项目, 大内总管, 看看哪些分支该合并了, 定时清理本地环境, 扫一下所有 worktree, sweep all my repos, check on every project, what needs merging across my projects, run the housekeeping, keep my local environment clean. Not for syncing or cleaning the one repository you are standing in, for shipping or merging a branch, or for renaming a single conversation.
  page: https://misoto22.com/skills/steward · source: https://github.com/Misoto22/skills/blob/main/plugins/dev/skills/steward/SKILL.md · licence: MIT · arguments: `[--roots=<dir,…>] [--since=<days>] [--only=<sync|cleanup|retitle|report>] [--dry-run] [--unattended]`
- **reunite** — `/dev:reunite` — Make every signed-in account see every conversation in the desktop app's sidebar. The app keeps one conversation index per account, so signing in as a second account hides the first account's history — this unions the indexes and brings a shared conversation's diverged titles back onto one name, adding entries and never removing one. Use when asked why sessions disappeared after switching accounts, where my old conversations went, share sessions between two accounts, merge the session lists, 换账号以后 session 都不见了, 会话历史没了, 两个账号共享会话, 把 session 列表合起来, 找回以前的对话. Not for deleting conversations, renaming them (that is retitle), or moving history between machines.
  page: https://misoto22.com/skills/reunite · source: https://github.com/Misoto22/skills/blob/main/plugins/dev/skills/reunite/SKILL.md · licence: MIT · arguments: `[--apply] [--into=all|current|<accountUuid>] [--no-titles] [--undo]`

## Astrology (`astrology`)

Natal charts and two-person synastry, each in two stages — one validated JSON chart artifact with recorded backend provenance and uncertainty, privacy-minimal by default unless archival mode is explicitly requested, then a separate evidence-linked Markdown reading.

Install: `/plugin install astrology@misoto22`

- **synastry** — `/astrology:synastry` — Use when two people's birth details need an uncertainty-aware JSON v2 synastry calculation, including 合盘, 星盘配对, exact times, bounded time windows, or date-only records. Not for interpreting an existing v2 artifact, legacy TXT, one-person natal charts, transits, forecasts, predictions, or compatibility scores.
  page: https://misoto22.com/skills/synastry · source: https://github.com/Misoto22/skills/blob/main/plugins/astrology/skills/synastry/SKILL.md · licence: AGPL-3.0-or-later
- **synastry-reading** — `/astrology:synastry-reading` — Use when $synastry hands off a JSON v2 artifact, or when someone supplies a synastry-chart schema 2.0 JSON path or object and asks for 合盘解读, interpretation, relationship dynamics, or an evidence-linked Markdown report. Not for legacy TXT, raw birth details, one-person natal charts, recalculation, transits, forecasts, predictions, or compatibility scores.
  page: https://misoto22.com/skills/synastry-reading · source: https://github.com/Misoto22/skills/blob/main/plugins/astrology/skills/synastry-reading/SKILL.md · licence: AGPL-3.0-or-later
- **natal-chart** — `/astrology:natal-chart` — Compute one person's natal chart from an exact birth date, minute, and place — planet positions with sign, house, dignity and retrograde state, the four angles, intra-chart aspects, sect, and the classical lots, written as canonical JSON plus data-only Markdown. Use for 本命盘, 星盘, 出生星图, natal chart, birth chart, my rising sign, my chart's aspects, or where a planet sits. Not for two-person 合盘, interpreting a chart that already exists, transits, progressions, returns, or any dated prediction.
  page: https://misoto22.com/skills/natal-chart · source: https://github.com/Misoto22/skills/blob/main/plugins/astrology/skills/natal-chart/SKILL.md · licence: AGPL-3.0-or-later
- **natal-reading** — `/astrology:natal-reading` — Explain a natal chart artifact someone already has — what the rising sign shapes, where the sect light sits, which aspects are tight enough to lean on, and what the angles and lots add. Writes a reader report plus an auditable evidence file, and a shareable ink-wash page on request. Use for 解读星盘, 看本命盘, 我的上升是什么意思, or asking what a placement or aspect pattern means. Not for computing a chart from raw birth details, 合盘 between two people, transits, progressions, returns, or predicting a dated event.
  page: https://misoto22.com/skills/natal-reading · source: https://github.com/Misoto22/skills/blob/main/plugins/astrology/skills/natal-reading/SKILL.md · licence: AGPL-3.0-or-later

## Chinese Metaphysics (`chinese-metaphysics`)

BaZi calculation and interpretation - reusable single-person charts, static natal readings, transparent compatibility scores, and separate relationship reports.

Install: `/plugin install chinese-metaphysics@misoto22`

- **bazi-chart** — `/chinese-metaphysics:bazi-chart` — Calculate one reusable BaZi chart from a named person's exact birth date, minute, and birthplace, write canonical JSON plus data-only Markdown, then start the natal reading automatically. Use for 八字排盘, 生辰八字, four pillars, or informal single-person birth details. Not for two-person compatibility, existing-chart interpretation, Da Yun, annual luck, or event forecasts.
  page: https://misoto22.com/skills/bazi-chart · source: https://github.com/Misoto22/skills/blob/main/plugins/chinese-metaphysics/skills/bazi-chart/SKILL.md · licence: MIT
- **bazi-reading** — `/chinese-metaphysics:bazi-reading` — Interpret a completed single-person BaZi JSON chart or equivalent verified four-pillar data as an evidence-linked static natal report. Use when a calculator hands off its artifact or someone asks to 解读八字, 看命局, explain day-master strength, structure, or favorable elements from an existing chart. Not for raw birth details, relationship matching, luck cycles, dated predictions, or incomplete source data.
  page: https://misoto22.com/skills/bazi-reading · source: https://github.com/Misoto22/skills/blob/main/plugins/chinese-metaphysics/skills/bazi-reading/SKILL.md · licence: MIT
- **bazi-compatibility** — `/chinese-metaphysics:bazi-compatibility` — Compare two people from reusable BaZi chart JSON files, two complete birth records, or one of each; write auditable interaction data and transparent general or relationship-specific scores before automatic interpretation. Use for 八字合婚, 合八字, two-person compatibility, 配不配, or whether two charts work together. Not for one-person natal work, reading an existing comparison, forecasting, or missing birth minutes.
  page: https://misoto22.com/skills/bazi-compatibility · source: https://github.com/Misoto22/skills/blob/main/plugins/chinese-metaphysics/skills/bazi-compatibility/SKILL.md · licence: MIT
- **bazi-compatibility-reading** — `/chinese-metaphysics:bazi-compatibility-reading` — Interpret a completed BaZi compatibility JSON artifact or equivalent verified comparison as a balanced, directional, evidence-linked relationship report. Use after the compatibility calculator or when asked to explain general, romance, marriage, friendship, family, or work scores already computed for two charts. Not for raw birth records, one-person readings, recalculation, predictions, or a binary destiny verdict.
  page: https://misoto22.com/skills/bazi-compatibility-reading · source: https://github.com/Misoto22/skills/blob/main/plugins/chinese-metaphysics/skills/bazi-compatibility-reading/SKILL.md · licence: MIT
- **ziwei-chart** — `/chinese-metaphysics:ziwei-chart` — Place one twelve-palace Zi Wei Dou Shu 命盘 from someone's stated birth moment, birthplace, and gender, recording palaces, stars, 生年四化, and 大限 windows as reusable placement data. Use for 紫微斗数, 紫微排盘, 排紫微, 紫微命盘, 十二宫, or purple star astrology. Not for 八字 four pillars, matching two people, comparing two systems against each other, 流年 or monthly transformations, or a 命盘 that has already been placed.
  page: https://misoto22.com/skills/ziwei-chart · source: https://github.com/Misoto22/skills/blob/main/plugins/chinese-metaphysics/skills/ziwei-chart/SKILL.md · licence: MIT
- **ziwei-reading** — `/chinese-metaphysics:ziwei-reading` — Interpret an already-placed Zi Wei 命盘 artifact, or equivalent verified twelve-palace data, writing a reader report plus a separate audit artifact and, when asked, an ink-wash HTML poster. Use for 解读紫微, 看命盘, 看十二宫, or explaining the stars sitting in 命宫, the 生年四化, and what each 大限 window emphasizes. Not for unplaced birth records, 八字 four pillars, comparing two systems against each other, matching two people, 流年, or dated predictions.
  page: https://misoto22.com/skills/ziwei-reading · source: https://github.com/Misoto22/skills/blob/main/plugins/chinese-metaphysics/skills/ziwei-reading/SKILL.md · licence: MIT
- **bazi-ziwei-cross** — `/chinese-metaphysics:bazi-ziwei-cross` — Read one person's finished 八字 artifact and finished 紫微 artifact against each other, recording every place the two systems agree, complement, or flatly contradict, without merging them into a single number. Use for 八字紫微综合, 双系统印证, 两盘合参, or asking whether the two systems say the same thing about one person. Not for placing either 命盘, reading one system by itself, matching two people, or forecasting.
  page: https://misoto22.com/skills/bazi-ziwei-cross · source: https://github.com/Misoto22/skills/blob/main/plugins/chinese-metaphysics/skills/bazi-ziwei-cross/SKILL.md · licence: MIT

## Brand (`brand`)

Raster visual identity work — confirmed styles, coherent logos and icons, and light/dark social banners generated through ChatGPT Image.

Install: `/plugin install brand@misoto22`

- **logo-banner** — `/brand:logo-banner` — Create cohesive raster logo, app-icon, favicon, and repository-hero systems through ChatGPT Image when a user asks to design or refresh visual identity, a logo, a banner, branding assets, or light and dark brand variants; stop clearly when the host lacks that generator rather than substituting another tool; not for code-drawn SVG icons, general website layout, or ordinary photo retouching.
  page: https://misoto22.com/skills/logo-banner · source: https://github.com/Misoto22/skills/blob/main/plugins/brand/skills/logo-banner/SKILL.md · licence: MIT

## Photography (`photography`)

Source-faithful photography presentation: sharp original-photo and supplied-art comparison boards with provenance and no aspect-ratio distortion.

Install: `/plugin install photography@misoto22`

- **photo-abstract-editorial-native** — `/photography:photo-abstract-editorial-native` — Assemble a source-faithful photograph with a supplied editorial abstraction panel as a sharp comparison board, preserving orientation, aspect ratio, source provenance, and lower-panel scale. Use for original-versus-abstract photography diptychs, photo comparison cards, or repairing blurred and stretched editorial boards; not for generating lower artwork or replacing a separately licensed art-direction skill.
  page: https://misoto22.com/skills/photo-abstract-editorial-native · source: https://github.com/Misoto22/skills/blob/main/plugins/photography/skills/photo-abstract-editorial-native/SKILL.md · licence: MIT

## Bookmarks

Other people's plugins, registered so they install from the same marketplace. Each is pinned to one commit; that pin is the whole guarantee for code the repository does not own.

- **codex** — https://github.com/openai/codex-plugin-cc (pinned db52e28) — `/plugin install codex@misoto22`
- **everything-claude-code** — https://github.com/affaan-m/everything-claude-code (pinned 623f2c0) — `/plugin install everything-claude-code@misoto22`
- **i-have-adhd** — https://github.com/ayghri/i-have-adhd (pinned b837bf1) — `/plugin install i-have-adhd@misoto22`
- **obsidian** — https://github.com/kepano/obsidian-skills (pinned a1dc48e) — `/plugin install obsidian@misoto22`
- **mattpocock-skills** — https://github.com/mattpocock/skills (pinned 84fdeff) — `/plugin install mattpocock-skills@misoto22`
- **warp** — https://github.com/warpdotdev/claude-code-warp (pinned e0e18e1) — `/plugin install warp@misoto22`

## Machine-readable

- registry.json: https://raw.githubusercontent.com/Misoto22/skills/main/registry.json
- Source: https://github.com/Misoto22/skills
- Site index for agents: https://misoto22.com/llms.txt