Skip to content

Translate skill descriptions to English - #11

Closed
Chachamaru127 wants to merge 1 commit into
mainfrom
codex/replace-technical-terms-with-english
Closed

Chachamaru127 wants to merge 1 commit into
mainfrom
codex/replace-technical-terms-with-english

Conversation

@Chachamaru127

@Chachamaru127 Chachamaru127 commented Jan 18, 2026 •

Copy link
Copy Markdown
Owner

Motivation

  • Normalize and English-localize skill front-matter description fields so triggers and exclusion notes are consistently phrased in English for better context compression and clearer intent detection.
  • Fix a YAML quoting issue in the dev-browser skill description to avoid nested double-quotes that can break YAML parsing in some tools.

Description

  • Updated the description front-matter for 24 skill metadata files under skills/*/SKILL.md to English-only phrasing and clearer trigger/exclusion language.
  • Normalized wording (e.g. Japanese phrases and mixed-language fragments replaced with concise English tokens like implementation, test failures, deployment, etc.).
  • Adjusted skills/dev-browser/SKILL.md to use single quotes around trigger phrases inside the double-quoted description to avoid nested-quote issues.
  • Only metadata description lines were changed; the body content of skills remains intact.

Testing

  • No automated tests were run as part of this change.

Codex Task

Summary by CodeRabbit

リリースノート

  • ドキュメント
    • 複数のスキルファイルの説明文をを日本語/バイリンガル形式から英語のみに統一更新しました
    • スキル使用時のトリガー条件と除外条件の説明をより簡潔で明確な英語表現に改善しました

✏️ Tip: You can customize this high-level summary in your review settings.

@coderabbitai

coderabbitai Bot commented Jan 18, 2026 •

Copy link
Copy Markdown

Walkthrough

26個のスキルの説明メタデータが日本語から英語に統一されました。各SKILL.mdファイルの説明フィールドが、日本語の用語を含むトリガー例から、英語のより簡潔な説明に変更されました。機能的な変更はありません。

Changes

Cohort / File(s) Summary
スキル説明フィールド翻訳
skills/2agent/SKILL.md, skills/auth/SKILL.md, skills/ci/SKILL.md, skills/codex-review/SKILL.md, skills/cursor-mem/SKILL.md, skills/deploy/SKILL.md, skills/dev-browser/SKILL.md, skills/docs/SKILL.md, skills/impl/SKILL.md, skills/maintenance/SKILL.md, skills/memory/SKILL.md, skills/parallel-workflows/SKILL.md, skills/plans-management/SKILL.md, skills/principles/SKILL.md, skills/review/SKILL.md, skills/session-init/SKILL.md, skills/session-memory/SKILL.md, skills/setup/SKILL.md, skills/troubleshoot/SKILL.md, skills/ui/SKILL.md, skills/verify/SKILL.md, skills/vibecoder-guide/SKILL.md, skills/workflow-guide/SKILL.md, skills/workflow/SKILL.md
YAML前置き内のdescriptionフィールドを日本語から英語に統一。日本語用語を含むトリガー例と除外条件を、より簡潔で言語に依存しない英語の説明に置き換え。メタデータのみの変更で、機能ロジックまたは制御フローへの影響なし。

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

  • feat: Claude Code 2.1.0 対応 - v2.7.0 #6: 同じスキルファイル群(SKILL.md)のYAML前置きを変更します。このPRは説明テキストを更新し、関連PRはメタデータフィールドを追加するため、共通のファイル群に対する連続した変更と考えられます。

Poem

ウサギが飛び跳ねてスキルを整理 🐰
日本語から英語へ、きれいな翻訳
26のファイル、説明はスッキリ
メタデータの統一、作業は完成 ✨
世界中のユーザーに、わかりやすく!

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed プルリクエストのタイトル「Translate skill descriptions to English」は、変更セットの主な目的を正確に要約しており、24個のスキルメタデータファイルの説明フィールドを日本語から英語に翻訳するという主要な変更を明確に表現しています。
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Chachamaru127 added a commit that referenced this pull request Jan 18, 2026
Merged PRs #10 and #11 to translate all documentation to English for better context compression:

**Changed files (49 total):**
- `.claude/rules/` (4 files): command-editing, harness-ui, hooks-editing, shell-scripts
- `commands/core/` (10 files): cc-cursor-cc, harness-init, harness-review-ci, harness-review, plan-with-agent-ci, plan-with-agent, skill-list, sync-status, work-ci, work
- `commands/handoff/` (1 file): handoff-to-cursor
- `commands/optional/` (11 files): ci-setup, codex-mode, codex-review, crud, harness-mem, harness-ui-setup, harness-ui, harness-update, lsp-setup, sync-ssot-from-memory
- `skills/*/SKILL.md` (24 files): All skill descriptions normalized to English

**Additional fixes:**
- Replaced example API key with `sk-REDACTED` to avoid Gitleaks detection
- Removed "in Japanese" from description example in command-editing.md
- Fixed YAML nested quote issue in dev-browser skill

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@Chachamaru127

Copy link
Copy Markdown
Owner Author

Merged into PR #10 as a combined English translation PR.

@Chachamaru127
Chachamaru127 deleted the codex/replace-technical-terms-with-english branch February 11, 2026 06:04
Chachamaru127 pushed a commit that referenced this pull request Apr 11, 2026
Add 5 new entries (items 8-12) to CHANGELOG.md [Unreleased] section,
documenting the Phase 39 improvements that emerged after Phase 38
completion. These are user-facing improvements that should ship with
v4.0.1 alongside the CC 2.1.89-2.1.100 adaptation.

## New [Unreleased] entries

**#8. /harness-review redesigned for non-expert readers**
- Information density MID / cognitive load MIN
- 4-layer issue structure (title → problem → action → severity → tech detail)
- JSON demoted to "📦 詳細データ" section
- Bare invocation default flow (Step 0)
- Scope cap at HEAD~10 when >10 commits since last tag
- Japanese output mandate for context: fork subagents

**#9. harness sync plugin.json auto-revert root fix**
- pluginJSON struct gets Skills []string field
- generatePluginJSON hardcodes ["./"]
- TestSync_GeneratesPluginJSON regression guard added

**#10. Test assertion hardening with pipe-token regex**
- test-memory-hook-wiring.sh contains("startup") → test("(^|\\|)startup($|\\|)")
- 6 edge cases verified (3 match, 3 reject)
- Prevents silent pass on typos like "startup-only"

**#11. Name consistency restored (HAR:* → harness-*)**
- 18 files reverted to match directory names
- 54 HAR: prefixes preserved in description fields for visual branding
- skill-editing.md SSOT rule restored

**#12. v3 cleanup residue finalized + test v4 migration**
- validate-plugin.sh: 36 pass/6 fail → 42 pass/0 fail
- check-consistency.sh: 2 problems → 0 problems
- 5 ghost files/dirs removed from repo root
- 4 test scripts migrated to v4 invocation pattern

## Format

Each entry follows the "今まで / 今後" pattern from
.claude/rules/github-release.md with concrete examples and rationale.
VERSION / plugin.json / harness.toml unchanged (not a release bump).

## Verification

- ./scripts/ci/check-consistency.sh: all pass
- ./tests/validate-plugin.sh: 42 pass / 0 fail
- 74 insertions in CHANGELOG.md only

Closes Phase 39.4.1. Next action: /harness-release for v4.0.1.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant