ae-agent-skills 0.2.7 → 0.3.0

package/CSXS/manifest.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<ExtensionManifest Version="7.0" ExtensionBundleId="com.yumehiko.aeagentskill" ExtensionBundleVersion="0.2.7" ExtensionBundleName="ae-agent-skill" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+<ExtensionManifest Version="7.0" ExtensionBundleId="com.yumehiko.aeagentskill" ExtensionBundleVersion="0.3.0" ExtensionBundleName="ae-agent-skill" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
     <ExtensionList>
-        <Extension Id="com.yumehiko.aeagentskill.panel" Version="0.2.7" />
+        <Extension Id="com.yumehiko.aeagentskill.panel" Version="0.3.0" />
     </ExtensionList>
     <ExecutionEnvironment>
         <HostList>

package/README.ja.md

@@ -1,35 +1,67 @@
 # ae-agent-skills
 
-`ae-agent-skill`（After Effects CEP パネル）、`ae-cli`、Codex/Gemini 向け skill を1コマンドで導入するリポジトリです。
+`ae-agent-skills`は、コーディングエージェント（Codex / Gemini / Claude Code）からAdobe After Effectsを操作できるようにするためのリポジトリです。
+`ae-agent-skill`（After Effects CEP パネル）、`ae-cli`、エージェント向け skill を導入し、コンポジション作成や既存シーン編集をエージェントに依頼できるようになります。
 
 English README: [README.md](README.md)
 
-## インストール（clone不要）
+## クイックスタート
+
+1. インストールする。
 
 ```bash
 npx ae-agent-skills install
 ```
 
-実行内容:
+2. After Effects を再起動し、`ウィンドウ > 機能拡張 (ベータ) > ae-agent-skill` を開く。
+3. Codex、Gemini、または Claude Code を起動し、After Effects操作を依頼する。
+
+最初の依頼例（コンポジション作成）:
+
+```text
+$aftereffects-declarative を使って、1920x1080 / 30fps / 5秒のコンポジションを作成して。
+背景はダークグレー、中央に「Hello AE Agent」のテキストを配置し、
+0.5秒でフェードインするアニメーションを追加して。
+```
+
+Claude Code では slash command として呼び出します。
+
+```text
+/aftereffects-declarative を使って、1920x1080 / 30fps / 5秒のコンポジションを作成して。
+背景はダークグレー、中央に「Hello AE Agent」のテキストを配置し、
+0.5秒でフェードインするアニメーションを追加して。
+```
+
+4. エージェントの処理完了後、After Effects 上でコンポジションが作成されたことを確認する。
+
+エージェントを明示してインストールする場合:
+
+```bash
+npx ae-agent-skills install --agent codex
+npx ae-agent-skills install --agent gemini
+npx ae-agent-skills install --agent claude
+npx ae-agent-skills install --agent all
+```
+
+## インストール時に行われること
 
-1. `--agent` 未指定なら、`codex` / `gemini` / `both` の選択を表示します。
+1. `--agent` 未指定なら、`codex` / `gemini` / `claude` / `both` / `all` の選択を表示します。
 2. 署名済み ZXP を `UPIA` または `ExManCmd` でインストールします。
 3. `ae-cli` と agent skill をインストールします。
 4. `~/ae-agent-skills/` を初期化し、`work/`・`done/`・`scene.schema.json`・`references/` を配置します。
 
-## エージェントで実行
+`both` は後方互換のため Codex + Gemini、`all` は Codex + Gemini + Claude Code です。
+Claude Code の個人 skill は `~/.claude/skills/<skill-name>/SKILL.md` にインストールされます。
+Claude Code 用の slash command は `~/.claude/commands/<command>.md` にインストールされます。
 
-導入後:
+## どの skill を使うか
 
-1. After Effects を再起動する。
-2. `ウィンドウ > 機能拡張 (ベータ) > ae-agent-skill` を開く。
-3. コーディングエージェントで以下の skill を呼び出す。
-- `$aftereffects-declarative`（通常の構成作成向け）
-- `$aftereffects-cli`（個別編集・デバッグ向け）
+- `$aftereffects-declarative`: 新規コンポジション作成や全体構成を作るとき（通常はこちら）
+- `$aftereffects-cli`: 既存シーンの一部修正、プロパティ単位の調整、デバッグ
 
 ## ドキュメント
 
 - CLI利用方法: [docs/cli.ja.md](docs/cli.ja.md)
 - 開発者向け情報: [docs/development.ja.md](docs/development.ja.md)
-- 宣言型 skill 本体: [.codex/skills/aftereffects-declarative/SKILL.md](.codex/skills/aftereffects-declarative/SKILL.md)
-- レガシーCLI skill 本体: [.codex/skills/aftereffects-cli/SKILL.md](.codex/skills/aftereffects-cli/SKILL.md)
+- 宣言型 skill 本体: [templates/skills/aftereffects-declarative.SKILL.md](templates/skills/aftereffects-declarative.SKILL.md)
+- CLI skill 本体: [templates/skills/aftereffects-cli.SKILL.md](templates/skills/aftereffects-cli.SKILL.md)

package/README.md

@@ -1,35 +1,67 @@
 # ae-agent-skills
 
-One-command installer for `ae-agent-skill` (After Effects CEP panel), `ae-cli`, and Codex/Gemini skills.
+`ae-agent-skills` enables coding agents (Codex / Gemini / Claude Code) to operate Adobe After Effects.
+It installs `ae-agent-skill` (After Effects CEP panel), `ae-cli`, and agent skills so you can ask your agent to create compositions or edit existing scenes.
 
 Japanese README: [README.ja.md](README.ja.md)
 
-## Install (No clone)
+## Quick Start
+
+1. Install:
 
 ```bash
 npx ae-agent-skills install
 ```
 
-What happens:
+2. Restart After Effects, then open `Window > Extensions (Beta) > ae-agent-skill`.
+3. Launch Codex, Gemini, or Claude Code and ask it to perform an After Effects task.
+
+First request example (create a composition):
+
+```text
+Use $aftereffects-declarative to create a 1920x1080, 30fps, 5-second composition.
+Set a dark gray background, place "Hello AE Agent" text at the center,
+and add a 0.5-second fade-in animation.
+```
+
+In Claude Code, invoke the skill as a slash command:
+
+```text
+Use /aftereffects-declarative to create a 1920x1080, 30fps, 5-second composition.
+Set a dark gray background, place "Hello AE Agent" text at the center,
+and add a 0.5-second fade-in animation.
+```
+
+4. After the agent finishes, confirm the composition is created in After Effects.
+
+To choose an agent explicitly:
+
+```bash
+npx ae-agent-skills install --agent codex
+npx ae-agent-skills install --agent gemini
+npx ae-agent-skills install --agent claude
+npx ae-agent-skills install --agent all
+```
+
+## What the installer does
 
-1. The installer asks which agent to configure (`codex` / `gemini` / `both`) if `--agent` is omitted.
-2. It installs the signed ZXP extension via `UPIA` or `ExManCmd`.
-3. It installs `ae-cli` and agent skills.
-4. It initializes `~/ae-agent-skills/` with `work/`, `done/`, `scene.schema.json`, and `references/`.
+1. Prompts for target agent (`codex` / `gemini` / `claude` / `both` / `all`) when `--agent` is omitted.
+2. Installs the signed ZXP extension via `UPIA` or `ExManCmd`.
+3. Installs `ae-cli` and agent skills.
+4. Initializes `~/ae-agent-skills/` with `work/`, `done/`, `scene.schema.json`, and `references/`.
 
-## Run with your agent
+`both` means Codex + Gemini for backward compatibility. `all` means Codex + Gemini + Claude Code.
+Claude Code user skills are installed under `~/.claude/skills/<skill-name>/SKILL.md`.
+Claude Code slash commands are installed under `~/.claude/commands/<command>.md`.
 
-After installation:
+## Which skill to use
 
-1. Restart After Effects.
-2. Open `Window > Extensions (Beta) > ae-agent-skill`.
-3. Run your coding agent and call one of these skills:
-- `$aftereffects-declarative` for normal composition building.
-- `$aftereffects-cli` for command-by-command edits/debug.
+- `$aftereffects-declarative`: default for new composition building and overall scene structure
+- `$aftereffects-cli`: best for surgical edits, property-level tweaks, and debugging
 
 ## Docs
 
 - CLI usage: [docs/cli.md](docs/cli.md)
 - Development: [docs/development.md](docs/development.md)
-- Declarative skill source: [.codex/skills/aftereffects-declarative/SKILL.md](.codex/skills/aftereffects-declarative/SKILL.md)
-- Legacy CLI skill source: [.codex/skills/aftereffects-cli/SKILL.md](.codex/skills/aftereffects-cli/SKILL.md)
+- Declarative skill source: [templates/skills/aftereffects-declarative.SKILL.md](templates/skills/aftereffects-declarative.SKILL.md)
+- CLI skill source: [templates/skills/aftereffects-cli.SKILL.md](templates/skills/aftereffects-cli.SKILL.md)

package/bin/ae-agent-setup-lib.mjs

@@ -0,0 +1,453 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import readline from 'node:readline';
+import { fileURLToPath } from 'node:url';
+
+export const DEFAULT_REPO = 'yumehiko/ae-agent-skills';
+export const AGENT_WORKSPACE_NAME = 'ae-agent-skills';
+
+export const SKILL_SOURCES = [
+  { sourceName: 'aftereffects-cli.SKILL.md', destinationName: 'aftereffects-cli' },
+  { sourceName: 'aftereffects-declarative.SKILL.md', destinationName: 'aftereffects-declarative' },
+];
+
+export const CLAUDE_COMMAND_SOURCES = [
+  { sourceName: 'aftereffects-cli.md', destinationName: 'aftereffects-cli.md' },
+  { sourceName: 'aftereffects-declarative.md', destinationName: 'aftereffects-declarative.md' },
+];
+
+export const WORKSPACE_RESOURCE_SOURCES = [
+  { source: ['schemas', 'scene.schema.json'], destination: ['scene.schema.json'] },
+  { source: ['examples', 'scene.example.json'], destination: ['references', 'scene.example.json'] },
+  { source: ['docs', 'cli.ja.md'], destination: ['references', 'cli.ja.md'] },
+  { source: ['docs', 'cli.md'], destination: ['references', 'cli.md'] },
+];
+
+export const AGENT_REGISTRY = [
+  {
+    id: 'codex',
+    destRoot({ home, env }) {
+      const codexHome = env.CODEX_HOME || path.join(home, '.codex');
+      return path.join(codexHome, 'skills');
+    },
+    isDetected({ home, env, fsModule }) {
+      return Boolean(env.CODEX_HOME) || fsModule.existsSync(path.join(home, '.codex'));
+    },
+  },
+  {
+    id: 'gemini',
+    destRoot({ home }) {
+      return path.join(home, '.gemini', 'skills');
+    },
+    isDetected({ home, fsModule }) {
+      return fsModule.existsSync(path.join(home, '.gemini'));
+    },
+  },
+  {
+    id: 'claude',
+    destRoot({ home }) {
+      return path.join(home, '.claude', 'skills');
+    },
+    commandsRoot({ home }) {
+      return path.join(home, '.claude', 'commands');
+    },
+    isDetected({ home, fsModule }) {
+      return fsModule.existsSync(path.join(home, '.claude'));
+    },
+  },
+];
+
+const AGENT_ALIASES = {
+  both: ['codex', 'gemini'],
+  all: AGENT_REGISTRY.map((agent) => agent.id),
+};
+
+export function getRepoRoot() {
+  return path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+}
+
+export function printHelp(output = console.log) {
+  output(`ae-agent-setup
+
+Usage:
+  ae-agent-setup install [options]
+
+Options:
+  --agent <codex|gemini|claude|both|all>
+                              Agent target. If omitted, interactive selection is shown.
+                              "both" means codex+gemini for backward compatibility.
+                              "all" means codex+gemini+claude.
+  --repo <owner/repo>          GitHub repository for release and CLI install (default: ${DEFAULT_REPO}).
+  --zxp <path-or-url>          Local ZXP path or direct download URL.
+  --skip-extension             Skip ZXP extension installation.
+  --skip-cli                   Skip ae-cli installation.
+  --skip-skills                Skip skill installation.
+  -h, --help                   Show this help.
+`);
+}
+
+export function parseArgs(argv) {
+  const opts = {
+    agent: '',
+    repo: DEFAULT_REPO,
+    zxp: '',
+    skipExtension: false,
+    skipCli: false,
+    skipSkills: false,
+  };
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (arg === '--agent') {
+      opts.agent = argv[i + 1] || '';
+      i += 1;
+      continue;
+    }
+    if (arg === '--repo') {
+      opts.repo = argv[i + 1] || '';
+      i += 1;
+      continue;
+    }
+    if (arg === '--zxp') {
+      opts.zxp = argv[i + 1] || '';
+      i += 1;
+      continue;
+    }
+    if (arg === '--skip-extension') {
+      opts.skipExtension = true;
+      continue;
+    }
+    if (arg === '--skip-cli') {
+      opts.skipCli = true;
+      continue;
+    }
+    if (arg === '--skip-skills') {
+      opts.skipSkills = true;
+      continue;
+    }
+    if (arg === '-h' || arg === '--help') {
+      opts.help = true;
+      continue;
+    }
+    throw new Error(`Unknown argument: ${arg}`);
+  }
+
+  return opts;
+}
+
+export function expandAgentTarget(agentArg) {
+  const value = String(agentArg || '').toLowerCase();
+  const direct = AGENT_REGISTRY.find((agent) => agent.id === value);
+  if (direct) return [direct.id];
+  if (AGENT_ALIASES[value]) return [...AGENT_ALIASES[value]];
+  throw new Error(`Invalid --agent value: ${agentArg}`);
+}
+
+export function getDetectedAgents({ home = os.homedir(), env = process.env, fsModule = fs } = {}) {
+  return AGENT_REGISTRY
+    .filter((agent) => agent.isDetected({ home, env, fsModule }))
+    .map((agent) => agent.id);
+}
+
+export function getSkillInstallTargets(
+  agentArg,
+  { home = os.homedir(), env = process.env } = {},
+) {
+  return expandAgentTarget(agentArg).map((agentId) => {
+    const agent = AGENT_REGISTRY.find((entry) => entry.id === agentId);
+    return {
+      kind: agent.id,
+      destRoot: agent.destRoot({ home, env }),
+    };
+  });
+}
+
+export function getClaudeCommandInstallTarget({ home = os.homedir() } = {}) {
+  const claude = AGENT_REGISTRY.find((entry) => entry.id === 'claude');
+  return claude.commandsRoot({ home });
+}
+
+function ask(question) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+
+export async function resolveAgent(agentArg) {
+  if (agentArg) {
+    expandAgentTarget(agentArg);
+    return agentArg.toLowerCase();
+  }
+
+  const detected = getDetectedAgents();
+  const recommended = detected[0] || 'codex';
+  console.log('Select which coding agent should receive skills:');
+  console.log(`  1) codex${recommended === 'codex' ? ' (recommended)' : ''}`);
+  console.log(`  2) gemini${recommended === 'gemini' ? ' (recommended)' : ''}`);
+  console.log(`  3) claude${recommended === 'claude' ? ' (recommended)' : ''}`);
+  console.log('  4) both (codex + gemini)');
+  console.log('  5) all (codex + gemini + claude)');
+
+  if (!process.stdin.isTTY) {
+    console.log(`No interactive terminal detected. Defaulting to: ${recommended}`);
+    return recommended;
+  }
+
+  const answer = await ask('Enter 1, 2, 3, 4, or 5 [1]: ');
+  if (!answer || answer === '1') return 'codex';
+  if (answer === '2') return 'gemini';
+  if (answer === '3') return 'claude';
+  if (answer === '4') return 'both';
+  if (answer === '5') return 'all';
+  throw new Error(`Invalid selection: ${answer}`);
+}
+
+export function run(cmd, args, options = {}) {
+  const pretty = `${cmd} ${args.join(' ')}`.trim();
+  console.log(`$ ${pretty}`);
+  const res = spawnSync(cmd, args, { stdio: 'inherit', ...options });
+  if (res.error) {
+    throw new Error(`Command failed: ${pretty}\n${res.error.message}`);
+  }
+  if (res.status !== 0) {
+    throw new Error(`Command failed with exit code ${res.status}: ${pretty}`);
+  }
+}
+
+export function commandExists(cmd) {
+  const res = spawnSync('which', [cmd], { stdio: 'pipe', encoding: 'utf8' });
+  return res.status === 0;
+}
+
+export function detectInstaller() {
+  if (commandExists('upia')) return { cmd: 'upia', args: ['--install'] };
+  if (commandExists('UPIA')) return { cmd: 'UPIA', args: ['--install'] };
+
+  const knownUpiaPaths = [
+    '/Library/Application Support/Adobe/Adobe Desktop Common/RemoteComponents/UPI/UnifiedPluginInstallerAgent/UnifiedPluginInstallerAgent.app/Contents/MacOS/UnifiedPluginInstallerAgent',
+    '/Library/Application Support/Adobe/Adobe Desktop Common/HDBox/UPIA/UnifiedPluginInstallerAgent',
+  ];
+  for (const knownUpiaPath of knownUpiaPaths) {
+    if (fs.existsSync(knownUpiaPath)) return { cmd: knownUpiaPath, args: ['--install'] };
+  }
+
+  if (commandExists('ExManCmd')) return { cmd: 'ExManCmd', args: ['--install'] };
+  return null;
+}
+
+function fetchJson(url) {
+  return new Promise((resolve, reject) => {
+    const req = fetch(url, {
+      headers: {
+        Accept: 'application/vnd.github+json',
+        'User-Agent': 'ae-agent-setup',
+      },
+    });
+    req.then(async (res) => {
+      if (!res.ok) {
+        reject(new Error(`Request failed: ${res.status} ${res.statusText}`));
+        return;
+      }
+      try {
+        const body = await res.json();
+        resolve(body);
+      } catch (err) {
+        reject(err);
+      }
+    }).catch(reject);
+  });
+}
+
+function downloadToFile(url, destination) {
+  return fetch(url, {
+    headers: {
+      Accept: 'application/octet-stream',
+      'User-Agent': 'ae-agent-setup',
+    },
+  }).then(async (res) => {
+    if (!res.ok) {
+      throw new Error(`Download failed: ${res.status} ${res.statusText}`);
+    }
+    const data = Buffer.from(await res.arrayBuffer());
+    fs.writeFileSync(destination, data);
+    return destination;
+  });
+}
+
+export async function resolveZxpPath(opts) {
+  if (opts.zxp) {
+    if (opts.zxp.startsWith('http://') || opts.zxp.startsWith('https://')) {
+      const output = path.join(fs.mkdtempSync(path.join(os.tmpdir(), 'ae-agent-zxp-')), 'extension.zxp');
+      console.log(`Downloading ZXP from URL: ${opts.zxp}`);
+      await downloadToFile(opts.zxp, output);
+      return output;
+    }
+
+    const local = path.resolve(process.cwd(), opts.zxp);
+    if (!fs.existsSync(local)) {
+      throw new Error(`ZXP not found: ${local}`);
+    }
+    return local;
+  }
+
+  console.log(`Fetching latest release from GitHub: ${opts.repo}`);
+  const release = await fetchJson(`https://api.github.com/repos/${opts.repo}/releases/latest`);
+  const asset = (release.assets || []).find((a) => typeof a.name === 'string' && a.name.endsWith('.zxp'));
+  if (!asset) {
+    throw new Error(`No .zxp asset found in latest release of ${opts.repo}`);
+  }
+
+  const output = path.join(fs.mkdtempSync(path.join(os.tmpdir(), 'ae-agent-zxp-')), asset.name);
+  console.log(`Downloading asset: ${asset.name}`);
+  await downloadToFile(asset.browser_download_url, output);
+  return output;
+}
+
+export function installSkills(
+  agent,
+  { root = getRepoRoot(), home = os.homedir(), env = process.env } = {},
+) {
+  const sourceRoot = path.join(root, 'templates', 'skills');
+  const targets = getSkillInstallTargets(agent, { home, env });
+
+  for (const target of targets) {
+    fs.mkdirSync(target.destRoot, { recursive: true });
+    for (const skill of SKILL_SOURCES) {
+      const source = path.join(sourceRoot, skill.sourceName);
+      const destination = path.join(target.destRoot, skill.destinationName);
+      if (!fs.existsSync(source)) {
+        throw new Error(`Skill source not found: ${source}`);
+      }
+      fs.rmSync(destination, { recursive: true, force: true });
+      fs.mkdirSync(destination, { recursive: true });
+      fs.copyFileSync(source, path.join(destination, 'SKILL.md'));
+      console.log(`Installed ${target.kind} skill: ${destination}`);
+    }
+  }
+
+  if (expandAgentTarget(agent).includes('claude')) {
+    installClaudeCommands({ root, home });
+  }
+}
+
+export function installClaudeCommands({ root = getRepoRoot(), home = os.homedir() } = {}) {
+  const sourceRoot = path.join(root, 'templates', 'claude', 'commands');
+  const destRoot = getClaudeCommandInstallTarget({ home });
+  fs.mkdirSync(destRoot, { recursive: true });
+
+  for (const command of CLAUDE_COMMAND_SOURCES) {
+    const source = path.join(sourceRoot, command.sourceName);
+    const destination = path.join(destRoot, command.destinationName);
+    if (!fs.existsSync(source)) {
+      throw new Error(`Claude command source not found: ${source}`);
+    }
+    fs.copyFileSync(source, destination);
+    console.log(`Installed claude command: ${destination}`);
+  }
+}
+
+export function setupAgentWorkspace({ root = getRepoRoot(), home = os.homedir() } = {}) {
+  const workspaceRoot = path.join(home, AGENT_WORKSPACE_NAME);
+  const workDir = path.join(workspaceRoot, 'work');
+  const doneDir = path.join(workspaceRoot, 'done');
+  const refsDir = path.join(workspaceRoot, 'references');
+
+  fs.mkdirSync(workDir, { recursive: true });
+  fs.mkdirSync(doneDir, { recursive: true });
+  fs.mkdirSync(refsDir, { recursive: true });
+
+  for (const resource of WORKSPACE_RESOURCE_SOURCES) {
+    const source = path.join(root, ...resource.source);
+    const destination = path.join(workspaceRoot, ...resource.destination);
+    if (!fs.existsSync(source)) {
+      throw new Error(`Workspace resource not found: ${source}`);
+    }
+    fs.copyFileSync(source, destination);
+  }
+
+  console.log(`Prepared workspace: ${workspaceRoot}`);
+}
+
+export function installCli(repo) {
+  if (!commandExists('python3')) {
+    throw new Error('python3 is required to install ae-cli.');
+  }
+  const spec = `git+https://github.com/${repo}.git`;
+  run('python3', ['-m', 'pip', 'install', '--user', '--upgrade', spec]);
+
+  const helpRes = spawnSync('ae-cli', ['--help'], { stdio: 'inherit' });
+  if (helpRes.status !== 0) {
+    console.log('ae-cli was installed, but not found on PATH.');
+    console.log('Run this once in your shell profile if needed:');
+    console.log('  export PATH="$HOME/Library/Python/3.*/bin:$PATH"');
+  }
+}
+
+export async function installCommand(opts) {
+  console.log('Starting ae-agent setup...');
+  setupAgentWorkspace();
+
+  const agent = await resolveAgent(opts.agent);
+  console.log(`Selected agent target: ${agent}`);
+
+  if (!opts.skipExtension) {
+    const installer = detectInstaller();
+    if (!installer) {
+      throw new Error('Neither UPIA nor ExManCmd was found. Install one of them and run again.');
+    }
+
+    const zxpPath = await resolveZxpPath(opts);
+    console.log(`Installing extension via ${installer.cmd}...`);
+    run(installer.cmd, [...installer.args, zxpPath]);
+  } else {
+    console.log('Skipping extension installation (--skip-extension).');
+  }
+
+  if (!opts.skipCli) {
+    console.log('Installing ae-cli...');
+    installCli(opts.repo);
+  } else {
+    console.log('Skipping ae-cli installation (--skip-cli).');
+  }
+
+  if (!opts.skipSkills) {
+    console.log('Installing agent skills...');
+    installSkills(agent);
+  } else {
+    console.log('Skipping skill installation (--skip-skills).');
+  }
+
+  console.log('Setup finished.');
+  console.log('Next actions:');
+  console.log('  1) Fully restart After Effects.');
+  console.log('  2) Open the panel: Window > Extensions (Beta) > ae-agent-skill.');
+  console.log('  3) Run: ae-cli health');
+  console.log(`  4) Use workspace: ${path.join(os.homedir(), AGENT_WORKSPACE_NAME)}`);
+}
+
+export async function main(argv = process.argv.slice(2)) {
+  const [command, ...rest] = argv;
+
+  if (!command || command === '-h' || command === '--help') {
+    printHelp();
+    return;
+  }
+
+  if (command !== 'install') {
+    throw new Error(`Unknown command: ${command}`);
+  }
+
+  const opts = parseArgs(rest);
+  if (opts.help) {
+    printHelp();
+    return;
+  }
+
+  await installCommand(opts);
+}

package/bin/ae-agent-setup.mjs

@@ -1,367 +1,6 @@
 #!/usr/bin/env node
 
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { spawnSync } from 'node:child_process';
-import readline from 'node:readline';
-import { fileURLToPath } from 'node:url';
-
-const DEFAULT_REPO = 'yumehiko/ae-agent-skills';
-const AGENT_WORKSPACE_NAME = 'ae-agent-skills';
-const SKILL_SOURCES = [
-  { sourceName: 'aftereffects-cli.SKILL.md', destinationName: 'aftereffects-cli' },
-  { sourceName: 'aftereffects-declarative.SKILL.md', destinationName: 'aftereffects-declarative' },
-];
-const WORKSPACE_RESOURCE_SOURCES = [
-  { source: ['schemas', 'scene.schema.json'], destination: ['scene.schema.json'] },
-  { source: ['examples', 'scene.example.json'], destination: ['references', 'scene.example.json'] },
-  { source: ['docs', 'cli.ja.md'], destination: ['references', 'cli.ja.md'] },
-  { source: ['docs', 'cli.md'], destination: ['references', 'cli.md'] },
-];
-
-function printHelp() {
-  console.log(`ae-agent-setup
-
-Usage:
-  ae-agent-setup install [options]
-
-Options:
-  --agent <codex|gemini|both>  Agent target. If omitted, interactive selection is shown.
-  --repo <owner/repo>          GitHub repository for release and CLI install (default: ${DEFAULT_REPO}).
-  --zxp <path-or-url>          Local ZXP path or direct download URL.
-  --skip-extension             Skip ZXP extension installation.
-  --skip-cli                   Skip ae-cli installation.
-  --skip-skills                Skip skill installation.
-  -h, --help                   Show this help.
-`);
-}
-
-function run(cmd, args, options = {}) {
-  const pretty = `${cmd} ${args.join(' ')}`.trim();
-  console.log(`$ ${pretty}`);
-  const res = spawnSync(cmd, args, { stdio: 'inherit', ...options });
-  if (res.error) {
-    throw new Error(`Command failed: ${pretty}\n${res.error.message}`);
-  }
-  if (res.status !== 0) {
-    throw new Error(`Command failed with exit code ${res.status}: ${pretty}`);
-  }
-}
-
-function commandExists(cmd) {
-  const res = spawnSync('which', [cmd], { stdio: 'pipe', encoding: 'utf8' });
-  return res.status === 0;
-}
-
-function detectInstaller() {
-  if (commandExists('upia')) return { cmd: 'upia', args: ['--install'] };
-  if (commandExists('UPIA')) return { cmd: 'UPIA', args: ['--install'] };
-
-  const knownUpiaPaths = [
-    '/Library/Application Support/Adobe/Adobe Desktop Common/RemoteComponents/UPI/UnifiedPluginInstallerAgent/UnifiedPluginInstallerAgent.app/Contents/MacOS/UnifiedPluginInstallerAgent',
-    '/Library/Application Support/Adobe/Adobe Desktop Common/HDBox/UPIA/UnifiedPluginInstallerAgent',
-  ];
-  for (const knownUpiaPath of knownUpiaPaths) {
-    if (fs.existsSync(knownUpiaPath)) return { cmd: knownUpiaPath, args: ['--install'] };
-  }
-
-  if (commandExists('ExManCmd')) return { cmd: 'ExManCmd', args: ['--install'] };
-  return null;
-}
-
-function parseArgs(argv) {
-  const opts = {
-    agent: '',
-    repo: DEFAULT_REPO,
-    zxp: '',
-    skipExtension: false,
-    skipCli: false,
-    skipSkills: false,
-  };
-
-  for (let i = 0; i < argv.length; i += 1) {
-    const arg = argv[i];
-    if (arg === '--agent') {
-      opts.agent = argv[i + 1] || '';
-      i += 1;
-      continue;
-    }
-    if (arg === '--repo') {
-      opts.repo = argv[i + 1] || '';
-      i += 1;
-      continue;
-    }
-    if (arg === '--zxp') {
-      opts.zxp = argv[i + 1] || '';
-      i += 1;
-      continue;
-    }
-    if (arg === '--skip-extension') {
-      opts.skipExtension = true;
-      continue;
-    }
-    if (arg === '--skip-cli') {
-      opts.skipCli = true;
-      continue;
-    }
-    if (arg === '--skip-skills') {
-      opts.skipSkills = true;
-      continue;
-    }
-    if (arg === '-h' || arg === '--help') {
-      opts.help = true;
-      continue;
-    }
-    throw new Error(`Unknown argument: ${arg}`);
-  }
-
-  return opts;
-}
-
-function getDetectedAgents() {
-  const detected = [];
-  const home = os.homedir();
-  if (process.env.CODEX_HOME || fs.existsSync(path.join(home, '.codex'))) detected.push('codex');
-  if (fs.existsSync(path.join(home, '.gemini'))) detected.push('gemini');
-  return detected;
-}
-
-function ask(question) {
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve) => {
-    rl.question(question, (answer) => {
-      rl.close();
-      resolve(answer.trim());
-    });
-  });
-}
-
-async function resolveAgent(agentArg) {
-  if (agentArg) {
-    const value = agentArg.toLowerCase();
-    if (!['codex', 'gemini', 'both'].includes(value)) {
-      throw new Error(`Invalid --agent value: ${agentArg}`);
-    }
-    return value;
-  }
-
-  const detected = getDetectedAgents();
-  const recommended = detected[0] || 'codex';
-  console.log('Select which coding agent should receive skills:');
-  console.log(`  1) codex${recommended === 'codex' ? ' (recommended)' : ''}`);
-  console.log(`  2) gemini${recommended === 'gemini' ? ' (recommended)' : ''}`);
-  console.log('  3) both');
-
-  if (!process.stdin.isTTY) {
-    console.log(`No interactive terminal detected. Defaulting to: ${recommended}`);
-    return recommended;
-  }
-
-  const answer = await ask('Enter 1, 2, or 3 [1]: ');
-  if (!answer || answer === '1') return 'codex';
-  if (answer === '2') return 'gemini';
-  if (answer === '3') return 'both';
-  throw new Error(`Invalid selection: ${answer}`);
-}
-
-function fetchJson(url) {
-  return new Promise((resolve, reject) => {
-    const req = fetch(url, {
-      headers: {
-        Accept: 'application/vnd.github+json',
-        'User-Agent': 'ae-agent-setup',
-      },
-    });
-    req.then(async (res) => {
-      if (!res.ok) {
-        reject(new Error(`Request failed: ${res.status} ${res.statusText}`));
-        return;
-      }
-      try {
-        const body = await res.json();
-        resolve(body);
-      } catch (err) {
-        reject(err);
-      }
-    }).catch(reject);
-  });
-}
-
-function downloadToFile(url, destination) {
-  return fetch(url, {
-    headers: {
-      Accept: 'application/octet-stream',
-      'User-Agent': 'ae-agent-setup',
-    },
-  }).then(async (res) => {
-    if (!res.ok) {
-      throw new Error(`Download failed: ${res.status} ${res.statusText}`);
-    }
-    const data = Buffer.from(await res.arrayBuffer());
-    fs.writeFileSync(destination, data);
-    return destination;
-  });
-}
-
-async function resolveZxpPath(opts) {
-  if (opts.zxp) {
-    if (opts.zxp.startsWith('http://') || opts.zxp.startsWith('https://')) {
-      const output = path.join(fs.mkdtempSync(path.join(os.tmpdir(), 'ae-agent-zxp-')), 'extension.zxp');
-      console.log(`Downloading ZXP from URL: ${opts.zxp}`);
-      await downloadToFile(opts.zxp, output);
-      return output;
-    }
-
-    const local = path.resolve(process.cwd(), opts.zxp);
-    if (!fs.existsSync(local)) {
-      throw new Error(`ZXP not found: ${local}`);
-    }
-    return local;
-  }
-
-  console.log(`Fetching latest release from GitHub: ${opts.repo}`);
-  const release = await fetchJson(`https://api.github.com/repos/${opts.repo}/releases/latest`);
-  const asset = (release.assets || []).find((a) => typeof a.name === 'string' && a.name.endsWith('.zxp'));
-  if (!asset) {
-    throw new Error(`No .zxp asset found in latest release of ${opts.repo}`);
-  }
-
-  const output = path.join(fs.mkdtempSync(path.join(os.tmpdir(), 'ae-agent-zxp-')), asset.name);
-  console.log(`Downloading asset: ${asset.name}`);
-  await downloadToFile(asset.browser_download_url, output);
-  return output;
-}
-
-function installSkills(agent) {
-  const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
-  const sourceRoot = path.join(root, 'templates', 'skills');
-
-  const targets = [];
-  if (agent === 'codex' || agent === 'both') {
-    const codexHome = process.env.CODEX_HOME || path.join(os.homedir(), '.codex');
-    targets.push({ kind: 'codex', destRoot: path.join(codexHome, 'skills') });
-  }
-  if (agent === 'gemini' || agent === 'both') {
-    targets.push({ kind: 'gemini', destRoot: path.join(os.homedir(), '.gemini', 'skills') });
-  }
-
-  for (const target of targets) {
-    fs.mkdirSync(target.destRoot, { recursive: true });
-    for (const skill of SKILL_SOURCES) {
-      const source = path.join(sourceRoot, skill.sourceName);
-      const destination = path.join(target.destRoot, skill.destinationName);
-      if (!fs.existsSync(source)) {
-        throw new Error(`Skill source not found: ${source}`);
-      }
-      fs.rmSync(destination, { recursive: true, force: true });
-      fs.mkdirSync(destination, { recursive: true });
-      fs.copyFileSync(source, path.join(destination, 'SKILL.md'));
-      console.log(`Installed ${target.kind} skill: ${destination}`);
-    }
-  }
-}
-
-function setupAgentWorkspace() {
-  const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
-  const workspaceRoot = path.join(os.homedir(), AGENT_WORKSPACE_NAME);
-  const workDir = path.join(workspaceRoot, 'work');
-  const doneDir = path.join(workspaceRoot, 'done');
-  const refsDir = path.join(workspaceRoot, 'references');
-
-  fs.mkdirSync(workDir, { recursive: true });
-  fs.mkdirSync(doneDir, { recursive: true });
-  fs.mkdirSync(refsDir, { recursive: true });
-
-  for (const resource of WORKSPACE_RESOURCE_SOURCES) {
-    const source = path.join(root, ...resource.source);
-    const destination = path.join(workspaceRoot, ...resource.destination);
-    if (!fs.existsSync(source)) {
-      throw new Error(`Workspace resource not found: ${source}`);
-    }
-    fs.copyFileSync(source, destination);
-  }
-
-  console.log(`Prepared workspace: ${workspaceRoot}`);
-}
-
-function installCli(repo) {
-  if (!commandExists('python3')) {
-    throw new Error('python3 is required to install ae-cli.');
-  }
-  const spec = `git+https://github.com/${repo}.git`;
-  run('python3', ['-m', 'pip', 'install', '--user', '--upgrade', spec]);
-
-  const helpRes = spawnSync('ae-cli', ['--help'], { stdio: 'inherit' });
-  if (helpRes.status !== 0) {
-    console.log('ae-cli was installed, but not found on PATH.');
-    console.log('Run this once in your shell profile if needed:');
-    console.log('  export PATH="$HOME/Library/Python/3.*/bin:$PATH"');
-  }
-}
-
-async function installCommand(opts) {
-  console.log('Starting ae-agent setup...');
-  setupAgentWorkspace();
-
-  const agent = await resolveAgent(opts.agent);
-  console.log(`Selected agent target: ${agent}`);
-
-  if (!opts.skipExtension) {
-    const installer = detectInstaller();
-    if (!installer) {
-      throw new Error('Neither UPIA nor ExManCmd was found. Install one of them and run again.');
-    }
-
-    const zxpPath = await resolveZxpPath(opts);
-    console.log(`Installing extension via ${installer.cmd}...`);
-    run(installer.cmd, [...installer.args, zxpPath]);
-  } else {
-    console.log('Skipping extension installation (--skip-extension).');
-  }
-
-  if (!opts.skipCli) {
-    console.log('Installing ae-cli...');
-    installCli(opts.repo);
-  } else {
-    console.log('Skipping ae-cli installation (--skip-cli).');
-  }
-
-  if (!opts.skipSkills) {
-    console.log('Installing agent skills...');
-    installSkills(agent);
-  } else {
-    console.log('Skipping skill installation (--skip-skills).');
-  }
-
-  console.log('Setup finished.');
-  console.log('Next actions:');
-  console.log('  1) Fully restart After Effects.');
-  console.log('  2) Open the panel: Window > Extensions (Beta) > ae-agent-skill.');
-  console.log('  3) Run: ae-cli health');
-  console.log(`  4) Use workspace: ${path.join(os.homedir(), AGENT_WORKSPACE_NAME)}`);
-}
-
-async function main() {
-  const [command, ...rest] = process.argv.slice(2);
-
-  if (!command || command === '-h' || command === '--help') {
-    printHelp();
-    return;
-  }
-
-  if (command !== 'install') {
-    throw new Error(`Unknown command: ${command}`);
-  }
-
-  const opts = parseArgs(rest);
-  if (opts.help) {
-    printHelp();
-    return;
-  }
-
-  await installCommand(opts);
-}
+import { main } from './ae-agent-setup-lib.mjs';
 
 main().catch((err) => {
   console.error(`ERROR: ${err.message}`);

package/docs/development.ja.md

@@ -22,17 +22,19 @@ defaults write com.adobe.CSXS.11 PlayerDebugMode 1
 
 ```bash
 python3 -m pip install -e ".[dev]"
-PYTHONPATH=src pytest
+PYTHONPATH=src python3 -m pytest
+npm run test:node
 ```
 
 ## ZXPビルドと公開手順
 
 `0.2.6` 以降は `package.json` の `version` を正として、`npm version` 実行時に `CSXS/manifest.xml` へ自動同期します。
+Python パッケージ版は `pyproject.toml` も同じ値に揃えます。
 
 ### 1) バージョン更新
 
 ```bash
-npm version 0.2.7 --no-git-tag-version
+npm version 0.3.0 --no-git-tag-version
 ```
 
 ### 2) 署名付き ZXP ビルド
@@ -41,6 +43,26 @@ npm version 0.2.7 --no-git-tag-version
 - `ZXPSignCmd` が `PATH` 上にある、または `ZXPSIGNCMD_BIN` で実体パスを指定できる
 - 署名証明書 (`.p12`) とパスワードを用意済み
 
+1コマンド（パスワードはプロンプト入力）:
+
+```bash
+npm run build:zxp
+```
+
+または:
+
+```bash
+./scripts/signing/build-zxp-interactive.sh
+```
+
+証明書パスを変える場合:
+
+```bash
+SIGN_CERT_P12=/absolute/path/to/dev-cert.p12 npm run build:zxp
+```
+
+以下は従来どおり、環境変数で直接指定する方法:
+
 ```bash
 SIGN_CERT_P12=certs/dev-cert.p12 \
 SIGN_CERT_PASSWORD='your-password' \
@@ -62,11 +84,11 @@ SIGN_CERT_PASSWORD='your-password' \
 ### 3) コミット・タグ・push
 
 ```bash
-git add package.json CSXS/manifest.xml
-git commit -m "release: v0.2.7"
-git tag v0.2.7
+git add package.json pyproject.toml CSXS/manifest.xml
+git commit -m "release: v0.3.0"
+git tag v0.3.0
 git push origin HEAD
-git push origin v0.2.7
+git push origin v0.3.0
 ```
 
 ### 4) npm 公開
@@ -80,14 +102,15 @@ npm publish
 `npx ae-agent-skills install` は latest release の `.zxp` を参照するため、Release に ZXP を添付します。
 
 ```bash
-gh release create v0.2.7 dist/ae-agent-skill-0.2.7.zxp \
-  --title v0.2.7 \
+gh release create v0.3.0 dist/ae-agent-skill-0.3.0.zxp \
+  --title v0.3.0 \
   --notes "Release notes"
 ```
 
 ### 6) 公開後確認
 
 ```bash
+npm --cache /private/tmp/ae-agent-npm-cache pack --dry-run
 npm view ae-agent-skills version dist-tags.latest --json
 gh release view --repo yumehiko/ae-agent-skills --json tagName,assets
 ```

package/docs/development.md

@@ -22,7 +22,15 @@ Then fully quit and relaunch After Effects.
 
 ```bash
 python3 -m pip install -e ".[dev]"
-PYTHONPATH=src pytest
+PYTHONPATH=src python3 -m pytest
+npm run test:node
+```
+
+`package.json`, `pyproject.toml`, and `CSXS/manifest.xml` versions should stay aligned for releases.
+Before publishing, run:
+
+```bash
+npm --cache /private/tmp/ae-agent-npm-cache pack --dry-run
 ```
 
 ## Project structure

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ae-agent-skills",
-  "version": "0.2.7",
+  "version": "0.3.0",
   "description": "One-command installer for the ae-agent-skill After Effects extension and CLI.",
   "type": "module",
   "bin": {
@@ -8,7 +8,9 @@
     "ae-agent-setup": "bin/ae-agent-setup.mjs"
   },
   "scripts": {
+    "build:zxp": "./scripts/signing/build-zxp-interactive.sh",
     "sync:version": "node scripts/release/sync-version.mjs",
+    "test:node": "node --test tests/*.test.mjs",
     "version": "npm run sync:version"
   },
   "files": [

package/scripts/signing/build-zxp-interactive.sh

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Build signed ZXP by prompting for certificate password interactively.
+# Optional env:
+#   SIGN_CERT_P12=certs/dev-cert.p12
+#   ZXPSIGNCMD_BIN=/absolute/path/to/ZXPSignCmd
+#   TIMESTAMP_URL=http://timestamp.digicert.com
+
+ROOT_DIR="$(cd "$(dirname "$0")/../.." && pwd)"
+CERT_P12="${SIGN_CERT_P12:-${ROOT_DIR}/certs/dev-cert.p12}"
+
+if [[ ! -f "${CERT_P12}" ]]; then
+  echo "Certificate file not found: ${CERT_P12}" >&2
+  echo "Set SIGN_CERT_P12 to a valid .p12 file path." >&2
+  exit 1
+fi
+
+read -r -s -p "SIGN_CERT_PASSWORD: " SIGN_CERT_PASSWORD
+echo
+
+if [[ -z "${SIGN_CERT_PASSWORD}" ]]; then
+  echo "Password is empty." >&2
+  exit 1
+fi
+
+SIGN_CERT_P12="${CERT_P12}" SIGN_CERT_PASSWORD="${SIGN_CERT_PASSWORD}" \
+  "${ROOT_DIR}/scripts/signing/build-zxp.sh"
+
+unset SIGN_CERT_PASSWORD

package/templates/claude/commands/aftereffects-cli.md

@@ -0,0 +1,7 @@
+Use the `aftereffects-cli` skill for this request.
+
+Prefer direct `ae-cli` commands for surgical edits, inspection, property updates, expression debugging, and small changes to existing human-made After Effects scenes.
+
+User request:
+
+$ARGUMENTS

package/templates/claude/commands/aftereffects-declarative.md

@@ -0,0 +1,7 @@
+Use the `aftereffects-declarative` skill for this request.
+
+Follow the skill workflow: check `ae-cli health`, create or update scene JSON under `~/ae-agent-skills/work/`, validate with `ae-cli apply-scene --validate-only`, apply it, inspect the result, and keep the completed scene JSON under `~/ae-agent-skills/done/`.
+
+User request:
+
+$ARGUMENTS

package/templates/skills/aftereffects-cli.SKILL.md

@@ -1,9 +1,9 @@
 ---
-name: aftereffects-cli-legacy
+name: aftereffects-cli
 description: Command-by-command After Effects editing via ae-cli. Best for surgical edits on existing human-made scenes (especially partial expression/property changes) and for debugging.
 ---
 
-# aftereffects-cli-legacy
+# aftereffects-cli
 
 低レベル CLI 操作（命令型）のスキル。  
 新規構築の主軸は宣言型 `aftereffects-declarative` だが、**既存シーンへの外科的編集ではこのスキルを第一選択**にする。
@@ -81,7 +81,7 @@ description: Command-by-command After Effects editing via ae-cli. Best for surgi
 ae-cli health
 ae-cli create-comp --name "Skill_CLI_Minimal_Test" --width 1280 --height 720 --duration 3 --frame-rate 30
 ae-cli set-active-comp --comp-name "Skill_CLI_Minimal_Test"
-ae-cli add-layer --type text --name "Hello" --text "CLI skill test"
+ae-cli add-layer --layer-type text --name "Hello" --text "CLI skill test"
 ae-cli layers
 ```
 

package/templates/skills/aftereffects-declarative.SKILL.md

@@ -20,7 +20,7 @@ After Effects を宣言型 JSON で構築する標準スキル。
   - 新規 comp / 新規レイヤー群を組み上げる
   - 同種変更を複数箇所へ展開する
   - scene JSON を成果物として残し、再実行可能にしたい
-- 命令型（`aftereffects-cli-legacy`）を使う:
+- 命令型（`aftereffects-cli`）を使う:
   - 人間が作った既存シーン（scene JSON 未管理）へ部分修正を入れる
   - 複雑な既存レイヤーに expression をピンポイント適用する
   - comp 全体の再宣言を避け、局所的に安全修正したい
@@ -152,4 +152,4 @@ ae-cli apply-scene --scene-file ~/ae-agent-skills/work/min.scene.json
 - 旧レイヤーが残る:
   - `apply-scene --mode replace-managed` または `--mode clear-all` を使う
 - 既存シーンへ局所修正したい / 宣言型で表現しづらい:
-  - `aftereffects-cli-legacy` へ切り替え
+  - `aftereffects-cli` へ切り替え