# Agent Config Import

> |

- **Type:** Skill
- **Install:** `agentstack add skill-hikaruegashira-agent-skills-agent-config-import`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [HikaruEgashira](https://agentstack.voostack.com/s/hikaruegashira)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [HikaruEgashira](https://github.com/HikaruEgashira)
- **Source:** https://github.com/HikaruEgashira/agent-skills/tree/main/agentops/skills/agent-config-import

## Install

```sh
agentstack add skill-hikaruegashira-agent-skills-agent-config-import
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

## 目的

設定を意味を壊さず移送する。単純コピーせず、移送可能 / 手動判断 / 移送不能を分ける。

## 原則

- 最初は dry-run。編集前に差分・リスク・未対応項目を出す。
- 分析は双方向 1 パス。両方向の Direct / Manual / Not portable / Proposed diff を最初から出し、逆方向を問い返させない。
- permission / sandbox / approval / hooks は記憶で判断しない。編集前に公式 URL を開き、確認した URL と日付を残す。
- secret / token の値は出さない。環境変数名と参照方式だけ扱う。
- 既存設定が source of truth。上書きでなく merge 案を出す。
- apply は対象ごとに `.bak.` を取ってから。home 配下は明示 apply なしに触らない。
- 共有 symlink ストア（例 `~/.agents/skills/` を両ツールから相対 symlink）経由なら、import は symlink 作成に過ぎず有無は curation。gap と誤報しない。判断前に symlink / inode を実測する。
- nix 等で管理された symlink は store が read-only。canonical source を編集対象にし、deployed copy の再 sync は別ステップにする。
- MCP は最優先。設定価値が集中する。

## 仕様確認 URL

permission / sandbox / auto mode は特に記憶で判断しない。`` を差し替えて必要分だけ開く。

- Codex `https://developers.openai.com/codex/`: config-reference, permissions, mcp, skills, plugins, changelog
- Claude `https://code.claude.com/docs/en/`: settings, permissions, hooks, plugins-reference, whats-new
- Cross: https://agents.md/ , https://agentskills.io/

## 入力探索

存在しないものは skip。読んだパスと欠落した重要パスを記録する。

- Claude: `~/.claude/settings.json`, `settings.local.json`, `~/.claude.json`(mcpServers), project `.claude/settings*.json`, `.mcp.json`, `CLAUDE.md`, `.claude/{skills,commands,agents,hooks}/**`
- Codex: `~/.codex/config.toml`, project `.codex/config.toml`, `AGENTS.md`, `~/.codex/skills/**`, project `.agents/skills/**`, `~/.codex/prompts/*.md`

## 変換マッピング（双方向対称）

| 領域 | Claude Code | Codex | 注意 |
|---|---|---|---|
| MCP | `mcpServers`{} (`.mcp.json` 優先 / settings) | `[mcp_servers.x]` (config.toml) | command/args/env/url を維持。TOML は parser で編集。embedded credential URL は伏せて手動。 |
| model | `model` | `model` | 直訳せず provider 互換を確認。 |
| env | `env`{} | `[shell_environment_policy.set]` | secret は名前と参照のみ。 |
| approval / sandbox | `permissions.defaultMode` | `approval_policy` + `sandbox_mode` | 1:1 でない。必ず推測明記。下記方針参照。 |
| allow / deny | `permissions.allow/deny` | granular approval / AGENTS.md guidance | 直接等価なし。destructive は手動。 |
| hooks | `.claude/hooks` + settings `hooks` | `hooks.json` / config | 等価移送しない。formatter/guardrail/telemetry/context/rewrite に分類し skill・prompt・plugin 化を提案。暗黙に実行可能化しない。 |
| skills | `.claude/skills/**` | `~/.codex/skills/**`, `.agents/skills/**` | copy/symlink。相対 symlink 優先。共有ストアなら symlink 1 本で済む。 |
| commands / prompts | `.claude/commands/*.md` | `~/.codex/prompts/*.md` | 相互変換候補。 |
| agents | `.claude/agents/*.md` | skill または AGENTS.md セクション | |
| memory | `CLAUDE.md` | `AGENTS.md` | 両方 regular file なら上書きせず diff。tool 固有記述(system prompt 参照等)は翻案か除外。片方のみなら canonical 配置を提案。 |

destructive allow / `danger-full-access` / `bypassPermissions` は apply せず、dry-run で警告と手動確認に回す。

## Permission / sandbox 方針

- Codex は approval と sandbox が独立。UI 名 "Auto"/"Full Auto" で判断しない。`approval_policy`(untrusted / on-request / never / granular) と `sandbox_mode`(read-only / workspace-write / danger-full-access) を分けて評価する。
- Claude `defaultMode`(default / acceptEdits / plan / auto / dontAsk / bypassPermissions) は現行仕様を docs で確認（`auto` は user scope のみ有効など制約あり）。
- 対応は推測として出す。`acceptEdits` ≈「編集許可・コマンド確認」、`bypassPermissions` ≠ `never`+`danger-full-access`。sandbox 有無と network / writable roots を分離して評価する。

## 出力フォーマット

双方向 1 パス。共有前置き(Specs / Read Files / Structural Findings)を 1 回、Direction A/B を各 1 ブロック、最後に統合 Apply を出す。各方向は 0 件でも「該当なし」と明記し省略しない。

````markdown
## Import Plan (Bidirectional) — Mode: dry-run

## Specs Checked
| Product | URL | Checked at | Notes |

## Read Files
| Path | Status | Notes |

## Structural Findings
共有ストア / symlink / nix 管理 / 既存 AGENTS.md・CLAUDE.md の drift / MCP 有無。symlink と inode は実測。

## Direction A — Codex → Claude Code
### Direct Imports
| Item | From | To | Action |
### Needs Manual Review
| Item | Reason | Suggested handling |
### Not Portable
| Item | Reason |
### Proposed Diff
```diff
# 
```

## Direction B — Claude Code → Codex
（同じ 4 小節: Direct Imports / Needs Manual Review / Not Portable / Proposed Diff）

## Apply Command
両方向の候補を 1 リストに列挙し、方向・項目単位で選べるよう提示。Apply only after the user asks.
````

## Apply 手順

apply を明示されたときのみ。

1. `git status --short` を確認。dirty なら worktree で隔離。
2. 対象ごとに `.bak.`。
3. JSON / TOML は structured parser で更新（JSON は JSONC 可能性を確認、TOML は table order 維持）。
4. `git diff --check`。
5. canonical を編集した場合、deployed copy / 共有ストアを sync。
6. 変更後の import summary を出す。

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [HikaruEgashira](https://github.com/HikaruEgashira)
- **Source:** [HikaruEgashira/agent-skills](https://github.com/HikaruEgashira/agent-skills)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-hikaruegashira-agent-skills-agent-config-import
- Seller: https://agentstack.voostack.com/s/hikaruegashira
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.