kotonoha 0.4.2 → 0.5.0

package/CHANGELOG.md

@@ -7,6 +7,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-10-20
+
+### Added
+
+- Add explicit `kotonoha install --agent
+  copilot|claude|all` selection for GitHub Copilot, Claude Code, or both.
+  Keep the Copilot default and independent `--skill` selection.
+- Preserve existing Skills in both roots, preflight explicit-skill conflicts
+  before copying, and allow `--target` overrides for a single agent.
+
+### Changed
+
+- Document both hosts and their installation/update paths. Extend
+  `tech-writer`'s prose Skill discovery to Claude project and personal roots.
+- Keep npm installation free of automatic Skill writes or interactive setup.
+
+### Fixed
+
+- Shorten `tech-writer`'s description to the Agent Skills 1,024-character
+  limit so hosts discover all seven bundled Skills. Add a regression check.
+
 ## [0.4.2] - 2026-10-20
 
 ### Added
@@ -190,4 +211,5 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 [0.1.4]: https://github.com/nahisaho/kotonoha/compare/v0.1.2...v0.1.4
 [0.1.5]: https://github.com/nahisaho/kotonoha/compare/v0.1.4...v0.1.5
 [0.4.2]: https://github.com/nahisaho/kotonoha/compare/d76ef4a...v0.4.2
-[Unreleased]: https://github.com/nahisaho/kotonoha/compare/v0.4.2...HEAD
+[0.5.0]: https://github.com/nahisaho/kotonoha/compare/v0.4.2...v0.5.0
+[Unreleased]: https://github.com/nahisaho/kotonoha/compare/v0.5.0...HEAD

package/README-ja.md

@@ -1,6 +1,6 @@
 # kotonoha
 
-kotonohaは、コンサルティング分析、技術文書、日本語表現、プレゼンテーション設計を支援するGitHub Copilot CLIスキルを提供します。曖昧な課題の構造化から、文書化、日本語表現の改善、プレゼンテーション設計までを一連の流れとして支援します。
+kotonohaは、GitHub CopilotとClaude Code向けのスキルを提供します。曖昧な課題の構造化から、文書化、日本語表現の改善、プレゼンテーション設計までを一連の流れとして支援します。
 
 `consulting-analyst`は、課題を論点、仮説、証拠、選択肢、提言へ構造化します。分析結果を受け取った`tech-writer`は、README、設計文書、Blueprint、White Paper、提案書などへ内容を落とし込みます。日本語の表現品質は`japanese-prose`がGiNZAベースの診断で改善します。プレゼンテーションが必要な場合は、`presentation-planner`がシナリオ、スライド構成、デザイン仕様、PPTX作成スキル向けの引き継ぎ情報を生成します。
 
@@ -155,7 +155,8 @@ White Paper向けの分析を作成して
 
 ### 前提条件
 
-- GitHub Copilot CLIがインストールされていること
+- GitHub Copilot（CLIまたは対応IDEのエージェントモード）かClaude Codeがインストールされていること
+- インストーラー用のNode.js 18以上とnpm
 - tech-writerの構造lintを実行する場合はPython 3.9以上
 - 同梱`japanese-prose`の文章lint、読解負荷分析、アウトライン抽出、用語検査、編集前後の不変条件検査を実行する場合はPython 3.10以上と`uv`。GiNZA、`ja_ginza`、spaCy、Markdown解析用の依存関係は、各スクリプトの初回実行時に`uv`が解決
 
@@ -168,6 +169,34 @@ npm install --save-dev kotonoha
 npx kotonoha install
 ```
 
+`npm install`はパッケージの導入だけを行います。エージェントの選択画面は表示せず、スキルディレクトリにも自動で書き込みません。
+
+### GitHub Copilot・Claude Code・両方を選択
+
+`--agent`はkotonoha `0.5.0`以降で利用できます。`0.4.2`などの旧版では使えないため、先にnpmパッケージを更新してください。
+
+```bash
+npx kotonoha install --agent copilot   # .github/skills/
+npx kotonoha install --agent claude    # .claude/skills/
+npx kotonoha install --agent all       # 両方のディレクトリ
+```
+
+未指定時は従来どおり`--agent copilot`です。`--agent`で配置先のエージェント、`--skill`で導入するスキルを選びます。両エージェントには同じSkillファイル、スクリプト、テンプレートを配置します。エージェント本体のインストール、認証設定、各スキルのPython・Node実行依存の準備は行いません。
+
+エージェントとスキルの選択は組み合わせられます。
+
+```bash
+npx kotonoha install --agent claude --skill tech-writer
+npx kotonoha install --agent all --skill obsidian-bases
+npx kotonoha install --agent all --force
+```
+
+既存ディレクトリの保護と`--force`は、選択した各配置先に適用します。明示した単一スキルがどちらかの配置先に存在する場合、コピー開始前に処理を止めます。ただし、コピー中のファイルシステムエラーでは、それ以前のコピーが残ることがあります。複数の配置先をまとめて元に戻す機能はありません。
+
+単一エージェントでは`--target`で配置先を変更できます。`--agent all`と`--target`は併用できません。配置先を個別に変える場合は、エージェントごとに実行します。
+
+この選択はファイルの配置先を決めるもので、エージェント間の隔離ではありません。Copilotも`.claude/skills`を認識するため、Claude向けに配置してもCopilotからの読み込みは防げません。対応する配置先は、公式資料（[CopilotのSkill説明](https://docs.github.com/en/copilot/concepts/agents/about-agent-skills)、[Claude CodeのSkill説明](https://code.claude.com/docs/en/skills)）を参照してください。
+
 ### 同梱スキルをまとめてインストール
 
 `kotonoha install`は、まだ存在しない同梱スキルをすべてインストールします。`consulting-analyst`、`tech-writer`、`japanese-prose`、`obsidian-vault`、`obsidian-canvas`、`obsidian-bases`、`presentation-planner`を`.github/skills/`へインストールします。
@@ -232,7 +261,8 @@ consulting-analyst、tech-writer、japanese-prose、obsidian-vault、obsidian-ca
 ```bash
 npx kotonoha install --skill consulting-analyst
 npx kotonoha install --skill presentation-planner
-npx kotonoha install --target .claude/skills
+npx kotonoha install --agent claude
+npx kotonoha install --agent claude --target ~/.claude/skills
 npx kotonoha install --target ~/.copilot/skills
 ```
 
@@ -272,8 +302,12 @@ npmパッケージを更新しても、コピー済みのスキルは自動更
 
 ```bash
 npx kotonoha install --force
+npx kotonoha install --agent claude --force
+npx kotonoha install --agent all --force
 ```
 
+上記のうち、初回の導入と同じ`--agent`に対応するコマンドを1つ実行します。最初のコマンドが更新するのは、既定のCopilot向け配置先だけです。
+
 スキルを1つだけ更新する場合は、次のように実行します。
 
 ```bash
@@ -293,7 +327,7 @@ npx kotonoha install --target ~/.copilot/skills --force
 
 ```bash
 npx kotonoha --version
-git diff -- .github/skills
+git diff -- .github/skills .claude/skills
 ```
 
 `--force`なしで`npx kotonoha install`を実行しても既存のスキルディレクトリは更新されず、不足しているスキルだけがインストールされます。
@@ -314,9 +348,9 @@ cp -r skills/obsidian-bases /path/to/your-repo/.github/skills/obsidian-bases
 cp -r skills/presentation-planner /path/to/your-repo/.github/skills/presentation-planner
 ```
 
-## Copilotに文書作成を依頼
+## Copilot・Claude Codeに文書作成を依頼
 
-Copilot CLIセッションで必要な文書種別を依頼すると、対応するスキルが自動的に呼び出されます。
+CopilotまたはClaude Codeのセッションで必要な文書種別を依頼すると、対応するスキルが自動的に呼び出されます。
 
 - 「READMEを書いて」「この設計書をレビューして」「PR説明文を書いて」「この手順書を分かりやすくして」
 - 「要件定義書を作って」「承認済み要件からシステム設計書を書いて」「移行計画とRunbookを作って」

package/README.md

@@ -1,6 +1,6 @@
 # kotonoha
 
-kotonoha provides GitHub Copilot CLI skills for consulting analysis, technical
+kotonoha provides skills for GitHub Copilot and Claude Code: consulting analysis, technical
 documents, Japanese prose, and presentation planning. `consulting-analyst`
 structures ambiguous problems into issue trees, hypotheses, evidence, option
 comparisons, and recommendations. `tech-writer` turns that reasoning into
@@ -251,7 +251,8 @@ handoff without inventing missing evidence.
 
 ### Prerequisites
 
-- GitHub Copilot CLI installed
+- GitHub Copilot (CLI or a supported IDE agent mode) or Claude Code installed
+- Node.js 18+ and npm for the installer
 - Python 3.9+ for tech-writer's structural lint
 - Python 3.10+ and `uv` for the edit-invariant gate and bundled GiNZA
   diagnostics such as prose lint,
@@ -268,6 +269,48 @@ npm install --save-dev kotonoha
 npx kotonoha install
 ```
 
+`npm install` installs the package only; it does not write to your agent's
+skill directories or prompt you to choose an agent.
+
+### Choose GitHub Copilot, Claude Code, or both
+
+Agent selection requires kotonoha `0.5.0` or later. Older packages such as
+`0.4.2` do not support `--agent`; update the npm package before using it.
+
+```bash
+npx kotonoha install --agent copilot   # .github/skills/
+npx kotonoha install --agent claude    # .claude/skills/
+npx kotonoha install --agent all       # both directories
+```
+
+The default is `--agent copilot`, preserving existing installations.
+`--agent` chooses the destination agent(s); `--skill` chooses the bundled
+skill(s). Both agents receive the same Skill files, scripts and templates.
+The installer does not install either agent application, configure credentials,
+or prepare Python/Node runtime dependencies for individual skills.
+
+You can combine agent and skill selection:
+
+```bash
+npx kotonoha install --agent claude --skill tech-writer
+npx kotonoha install --agent all --skill obsidian-bases
+npx kotonoha install --agent all --force
+```
+
+Existing-directory protection and `--force` apply separately in each selected
+root. An explicitly selected skill that already exists in either root blocks
+the operation before any Skill is copied. A later filesystem/copy error can
+still leave earlier copies installed; this is not a transaction across roots.
+
+For one agent, `--target` overrides its default root. Combining `--target`
+with `--agent all` is rejected; use separate commands for custom roots.
+
+Agent selection controls file placement, not isolation: Copilot can also
+discover `.claude/skills`. Installing for Claude does not prevent Copilot from
+loading those files. See the official
+[Copilot Skill locations](https://docs.github.com/en/copilot/concepts/agents/about-agent-skills)
+and [Claude Code Skills](https://code.claude.com/docs/en/skills).
+
 ### Install all bundled skills together
 
 `kotonoha install` installs every packaged skill that is not already present.
@@ -364,7 +407,8 @@ one skill, or use another supported skill directory:
 ```bash
 npx kotonoha install --skill consulting-analyst
 npx kotonoha install --skill presentation-planner
-npx kotonoha install --target .claude/skills
+npx kotonoha install --agent claude
+npx kotonoha install --agent claude --target ~/.claude/skills
 npx kotonoha install --target ~/.copilot/skills
 ```
 
@@ -411,8 +455,13 @@ skills. Reinstall all packaged skills after the package update:
 
 ```bash
 npx kotonoha install --force
+npx kotonoha install --agent claude --force
+npx kotonoha install --agent all --force
 ```
 
+Choose the command matching the original `--agent`; these are alternatives.
+The first updates only the default Copilot destination.
+
 To update only one skill:
 
 ```bash
@@ -434,7 +483,7 @@ committing them:
 
 ```bash
 npx kotonoha --version
-git diff -- .github/skills
+git diff -- .github/skills .claude/skills
 ```
 
 Running `npx kotonoha install` without `--force` is safe but does not update
@@ -459,9 +508,9 @@ cp -r skills/obsidian-bases /path/to/your-repo/.github/skills/obsidian-bases
 cp -r skills/presentation-planner /path/to/your-repo/.github/skills/presentation-planner
 ```
 
-## Ask Copilot for the document you need
+## Ask Copilot or Claude Code for the document you need
 
-Just ask for the document type you need in a Copilot CLI session, and it's
+Just ask for the document type you need in a Copilot or Claude Code session, and it's
 invoked automatically.
 
 - "Write a README", "Review this design doc", "Write the PR description",

package/bin/kotonoha.js

@@ -4,13 +4,19 @@ const fs = require("node:fs");
 const path = require("node:path");
 
 const packageJson = require("../package.json");
+const agentTargets = {
+  copilot: ".github/skills",
+  claude: ".claude/skills",
+};
 
 function printUsage() {
   console.log(`Usage:
-  kotonoha install [--target <directory>] [--skill <name|all>] [--force]
+  kotonoha install [--agent <copilot|claude|all>] [--target <directory>] [--skill <name|all>] [--force]
 
 Options:
-  --target <directory>  Skill directory root (default: .github/skills)
+  --agent <name|all>    Agent to install for (default: copilot)
+                       copilot: .github/skills; claude: .claude/skills; all: both
+  --target <directory>  Override the skill root for one agent; cannot combine with --agent all
   --skill <name|all>    Skill to install (default: all)
   --force               Replace existing selected skill installations
   --help                 Show this help
@@ -23,7 +29,8 @@ function fail(message) {
 }
 
 function parseInstallOptions(args) {
-  let target = ".github/skills";
+  let agent = "copilot";
+  let target;
   let skill = "all";
   let force = false;
 
@@ -35,6 +42,25 @@ function parseInstallOptions(args) {
       continue;
     }
 
+    if (argument === "--agent") {
+      const value = args[index + 1];
+      if (!value || value.startsWith("--")) {
+        throw new Error("--agent requires copilot, claude, or all");
+      }
+      agent = value;
+      index += 1;
+      continue;
+    }
+
+    if (argument.startsWith("--agent=")) {
+      const value = argument.slice("--agent=".length);
+      if (!value) {
+        throw new Error("--agent requires copilot, claude, or all");
+      }
+      agent = value;
+      continue;
+    }
+
     if (argument === "--target") {
       const value = args[index + 1];
       if (!value || value.startsWith("--")) {
@@ -76,7 +102,14 @@ function parseInstallOptions(args) {
     throw new Error(`unknown option: ${argument}`);
   }
 
-  return { target, skill, force };
+  if (agent !== "all" && !Object.hasOwn(agentTargets, agent)) {
+    throw new Error(`unknown agent: ${agent}; available agents: copilot, claude, all`);
+  }
+  if (agent === "all" && target !== undefined) {
+    throw new Error("--target cannot be combined with --agent all; install each agent separately to use custom directories");
+  }
+
+  return { agent, target, skill, force };
 }
 
 function install(args) {
@@ -89,7 +122,10 @@ function install(args) {
   }
 
   const skillsRoot = path.resolve(__dirname, "..", "skills");
-  const targetRoot = path.resolve(process.cwd(), options.target);
+  const agents = options.agent === "all" ? Object.keys(agentTargets) : [options.agent];
+  const targetRoots = agents.map((agent) =>
+    path.resolve(process.cwd(), options.target ?? agentTargets[agent]),
+  );
 
   if (!fs.existsSync(skillsRoot)) {
     fail(`packaged skills not found at ${skillsRoot}`);
@@ -118,9 +154,16 @@ function install(args) {
     }
   }
 
-  const existingDestinations = selectedSkills
-    .map((skill) => path.join(targetRoot, skill))
-    .filter((destination) => fs.existsSync(destination));
+  const destinations = targetRoots.flatMap((targetRoot) =>
+    selectedSkills.map((skill) => ({
+      skill,
+      targetRoot,
+      destination: path.join(targetRoot, skill),
+    })),
+  );
+  const existingDestinations = destinations
+    .filter(({ destination }) => fs.existsSync(destination))
+    .map(({ destination }) => destination);
 
   if (existingDestinations.length > 0 && !options.force && !installAll) {
     fail(
@@ -129,10 +172,16 @@ function install(args) {
     return;
   }
 
-  fs.mkdirSync(targetRoot, { recursive: true });
-  for (const skill of selectedSkills) {
+  for (const targetRoot of targetRoots) {
+    try {
+      fs.mkdirSync(targetRoot, { recursive: true });
+    } catch (error) {
+      fail(`failed to prepare skill root ${targetRoot}: ${error.message}`);
+      return;
+    }
+  }
+  for (const { skill, targetRoot, destination } of destinations) {
     const source = path.join(skillsRoot, skill);
-    const destination = path.join(targetRoot, skill);
     if (fs.existsSync(destination) && !options.force) {
       console.log(
         `Skipped ${skill} (${destination} already exists; use --force to replace)`,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "kotonoha",
-  "version": "0.4.2",
-  "description": "GitHub Copilot CLI skills for consulting analysis, technical writing, Japanese prose, Obsidian vaults, Canvas and Bases, and PPTX planning.",
+  "version": "0.5.0",
+  "description": "Skills for GitHub Copilot and Claude Code: consulting analysis, technical writing, Japanese prose, Obsidian vaults, Canvas and Bases, and PPTX planning.",
   "license": "MIT",
   "author": "nahisaho",
   "repository": {
@@ -28,6 +28,7 @@
   "keywords": [
     "copilot",
     "github-copilot",
+    "claude-code",
     "skill",
     "technical-writing",
     "consulting",

package/skills/obsidian-bases/references/workflow.md

@@ -14,6 +14,10 @@ replacement authority. Do not overwrite local customizations without consent.
 npx kotonoha install --skill obsidian-bases
 ```
 
+This defaults to Copilot's `.github/skills`. Add `--agent claude` for Claude
+Code's `.claude/skills`, or `--agent all` for both. Resolve `<bases-dir>` from
+the installed Skill in the selected root.
+
 Installation copies authored assets and the canonical private lockfile, not
 `node_modules`. Before dependency preparation explain the local installation
 directory and possible package-registry traffic; get separate permission.

package/skills/obsidian-canvas/references/workflow.md

@@ -20,6 +20,8 @@ kotonoha install --skill obsidian-canvas
 kotonoha install --skill obsidian-vault
 ```
 
+上記はCopilot向けの導入例である。Claude Codeでは両コマンドに`--agent claude`、両方には`--agent all`を付ける。CanvasとVaultの兄弟Skillは、エージェントごとの同じルートに置く。
+
 添削にはjapanese-proseも必要である。通常の図の編集では必須にしない。
 初回の依存準備で通信する場合は、対象と目的を説明して別に許可を得る。
 

package/skills/obsidian-vault/references/workflow.md

@@ -77,6 +77,8 @@ npx kotonoha install --skill tech-writer
 npx kotonoha install --skill japanese-prose
 ```
 
+上記はCopilot向けの導入例である。Claude Codeでは各コマンドに`--agent claude`、両方には`--agent all`を付け、必要な兄弟Skillも同じルートへ導入する。既定のルートはCopilotが`.github/skills`、Claude Codeが`.claude/skills`である。以下の起動例では、選択したルートにパスを合わせる。
+
 既存のjapanese-proseが古い場合は共通ゲートを利用できず、依存不足となる。
 既存Skillのローカル変更を確認・退避し、利用者が更新を許可してから、対象Skillだけを`--force`付きで再導入する。
 

package/skills/tech-writer/SKILL.md

@@ -1,39 +1,17 @@
 ---
 name: tech-writer
 description: >-
-  Helps structure and polish technical documents: README, design docs/ADRs,
-  API reference, PR descriptions/commit messages/issue reports, release
-  notes/CHANGELOG, user manuals/how-to guides, code comments/docstrings,
-  requirements definitions, system designs, test plans, operations runbooks,
-  migration plans, security designs/threat models, technical proposals,
-  Blueprints, White Papers, RFI/RFP procurement documents, Obsidian notes
-  and templates, and Qiita/Zenn articles. Use for requests
-  like "write a README", "draft a design doc", "define system requirements",
-  "write a system design", "create a test plan", "write an operations
-  runbook", "plan a migration", "create a threat model", "write a technical
-  proposal", "create a Blueprint", "write a White Paper", "draft an RFI",
-  "create an RFP", "write this PR description", "clean up my commit
-  message", "make this how-to guide clearer", "write API docs", "summarize
-  the release notes", "create an Obsidian note", "write a Zenn article",
-  "write this up for Qiita", as
-  well as
-  Japanese-language equivalents (「READMEを書いて」「設計ドキュメントを作って」
-  「要件定義書を作って」「システム設計書を書いて」「テスト計画書を作って」
-  「運用設計書を書いて」「移行計画を作って」「脅威モデルを作って」
-  「技術提案書を書いて」「Blueprintを作って」「ホワイトペーパーを書いて」
-  「RFIを作って」「RFPを作って」「PRの説明文を書いて」
-  「コミットメッセージを整えて」「手順書を分かりやすくして」
-  「APIドキュメントを整備して」「リリースノートをまとめて」
-  「Obsidian用のノートを作って」「Obsidianのテンプレートを作って」
-  「Zennの記事を書いて」「Qiitaに投稿する記事を書いて」). Especially useful when
-  the request is a bare goal without enough context to start (e.g. "I want
-  to write a README" / "○○を書きたい"), since this skill drives a one
-  question-at-a-time intake before writing. Supports both Japanese and
-  English documents, with Japanese as the primary target. Owns document
-  structure, information completeness, and reader fit; for living Japanese
-  documents, it invokes kotonoha's original bundled `japanese-prose` skill,
-  which uses GiNZA for sentence-level naturalness, word choice, rhythm, and
-  repeated AI-like pattern analysis.
+  Structures, writes, reviews, and scores technical documents: README,
+  design docs/ADRs, API references, requirements, system designs, test plans,
+  operations runbooks, migration plans, security designs/threat models,
+  technical proposals, Blueprints, White Papers, RFI/RFP, PR descriptions,
+  commit messages, issue reports, release notes/CHANGELOG, manuals/how-to
+  guides, comments/docstrings, Obsidian notes/templates, and Qiita/Zenn
+  articles. Use when asked to create, improve, review, or score these
+  documents in Japanese or English, including a bare goal without context.
+  Asks one question at a time before writing. Owns structure, completeness,
+  traceability, and reader fit; delegates sentence-level Japanese wording
+  to kotonoha's original bundled japanese-prose skill with GiNZA diagnostics.
 license: MIT
 argument-hint: "[write|review|score] [doctype] <target file or request>"
 ---
@@ -333,8 +311,10 @@ Load `japanese-prose` through the host's skill-loading mechanism. When only
 installed skill files are exposed, resolve the sibling path
 `<tech-writer-dir>/../japanese-prose/SKILL.md` first, then check
 `.github/skills/japanese-prose/SKILL.md`,
+`.claude/skills/japanese-prose/SKILL.md`,
 `.copilot/skills/japanese-prose/SKILL.md`, and
-`$HOME/.copilot/skills/japanese-prose/SKILL.md`. Load the discovered
+`$HOME/.copilot/skills/japanese-prose/SKILL.md`, then
+`$HOME/.claude/skills/japanese-prose/SKILL.md`. Load the discovered
 `SKILL.md` and follow its quick or full workflow. A standard
 `npx kotonoha install` installs this sibling skill automatically. Treat the
 pass as unavailable only when someone copied or installed tech-writer without

package/skills/tech-writer/references/japanese-prose-optimization.md

@@ -50,8 +50,10 @@ Never trade technical precision for conversational phrasing.
    skill-loading mechanism. If the host exposes only skill files, resolve
    `<tech-writer-dir>/../japanese-prose/SKILL.md` first, then check
    `.github/skills/japanese-prose/SKILL.md`,
+   `.claude/skills/japanese-prose/SKILL.md`,
    `.copilot/skills/japanese-prose/SKILL.md`, and
-   `$HOME/.copilot/skills/japanese-prose/SKILL.md`; expand `$HOME`, load the
+   `$HOME/.copilot/skills/japanese-prose/SKILL.md`, then
+   `$HOME/.claude/skills/japanese-prose/SKILL.md`; expand `$HOME`, load the
    discovered skill,
    and follow its workflow.
 2. Ask the loaded skill to review and rewrite only the Japanese prose under