Working On Frontend
Developmentworking-on-frontendWorking On Frontend is an Agent Skill for development published in the misskey-dev/misskey repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use whenever editing or adding code under `packages/frontend/`, or editing `locales/ja-JP.yml` for frontend-facing UI text — including Vue 3 SFCs (`Mk*` components), i18n keys (`i18n.ts.<key>` / `i18n.tsx.<key>()`), SCSS Modules, theme/CSS variables, `os.*` UI helpers, and Storybook stories. Covers SPDX (HTML comment form), `<script setup lang="ts">` conventions, type-only defineProps, `ja-JP.yml`-only locale editing (other locale yml files are Crowdin-managed and must not be edited), and accessibility. Must be consulted before any frontend or UI-locale change to avoid CI failures, lost translations, and reviewer pushback. This is NOT waived by having already invoked brainstorming, writing-plans, or any other upstream skill — invoke this at implementation time regardless of what preceded it.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/misskey-dev/misskey/blob/HEAD/.claude/skills/working-on-frontend/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/working-on-frontend, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
working-on-frontend
packages/frontend/ (Misskey Web クライアント) を編集するとき、最初に参照するスキル。Vue 3 SFC / SCSS Modules / i18n / os.* / Storybook / アクセシビリティの 手順 と 背景知識 をまとめている。
SKILL.md 本体は references への索引だけ。具体的な手順や規約は該当ファイルを Read すること (progressive disclosure)。
他スキル実行後も免除されない。 brainstorming / writing-plans / その他アップストリームスキルを先に呼んでいても、packages/frontend/ に触れる実装フェーズに入る時点でこのスキルを呼ぶこと。
作業別ワークフロー (tasks)
タスク単位の完結したチェックリスト。新しい何かを足すときに開く。
- 新規 / 既存
Mk*Vue コンポーネントを追加・改修する → references/tasks/adding-mk-component.md - i18n キーを追加・改修する (
locales/ja-JP.yml編集) → references/tasks/adding-i18n-key.md
共通知識 (knowledge)
タスクに紐付かない参照リファレンス。SFC を 編集する 場面 (新規追加でなくても) で踏みうる規約。
<script setup>/ type-onlydefineProps/defineEmits/ generic SFC / v-model 連動など SFC 規約 → references/knowledge/component-conventions.mdi18n.ts.<key>/i18n.tsx.<key>(...)の使い分け / HTML タグ埋め込み / 動的キー切替 / 既存キーのリネーム手順 → references/knowledge/i18n-usage.md- SCSS Modules /
--MI_THEME-*--MI-*CSS 変数 / グローバル utility class (_button等) → references/knowledge/scss-modules.md os.alert/os.confirm/os.popup等 UI ヘルパー (ブラウザ標準alert()直呼びは禁止) → references/knowledge/os-api.md*.stories.impl.ts併設規則 + 複数 story / argTypes / layout / action パターン → references/knowledge/storybook.md- frontend Vitest / Playwright E2E の書き方と前提 → references/knowledge/frontend-testing.md
必ず最後に通る場所
frontend の変更を commit / PR にする前に、必ず shipping-misskey-change の最終チェックリストに従う。pnpm lint / SPDX / ja-JP.yml のみ編集確認 / CHANGELOG をまとめて確認する。
.vue を追加・変更したなら、その出口で vue-component-reviewer agent (この skill の規約を review-mode から機械チェックする専門 reviewer) を Task で起動すると、SPDX 形式・命名・i18n・SCSS 変数・a11y・Storybook 併設の逸脱を取りこぼしにくい。