url-digest スキルのセットアップ手順

AIエージェント(Codex CLI、Claude Code等)向けの自動セットアップ手順。人間向けの説明は url-digest 使い方ガイド を参照してください。

前提

• 対象ツールはOpenAI Codex CLI(codexコマンド)
• skillの発見場所は $CODEX_HOME/skills/。CODEX_HOME が未設定なら ~/.codex/skills/

手順

1. url-digest-codex-skill.zip を展開する。

   unzip url-digest-codex-skill.zip -d /tmp/url-digest-extract

2. 展開してできた url-digest/ ディレクトリを丸ごとskillsディレクトリへ配置する。既に同名ディレクトリが存在する場合は、上書きしてよいかユーザーに確認してから進める。

   mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
   cp -r /tmp/url-digest-extract/url-digest "${CODEX_HOME:-$HOME/.codex}/skills/url-digest"

3. 配置後のディレクトリ構成が次と一致することを確認する。

   skills/url-digest/
   ├── SKILL.md
   ├── agents/openai.yaml
   └── references/output.schema.json

4. SKILL.md のYAML frontmatter(name/description)は変更しない。ワークフロー本文はユーザーが要望すれば調整してよいが、references/output.schema.json と矛盾する変更はしない。

5. 動作確認は新規に codex を起動し、次のようなプロンプトを試す。

   Use $url-digest to turn these URLs into a Japanese digest:
   https://example.com/article-1
   https://example.com/article-2

   skillが認識されていれば、Codexが SKILL.md のワークフローに従ってURLの取得・選抜・深掘り・Markdown/HTML生成を進める。

やらないこと

• ~/.codex/skills/ 以外のファイル(AGENTS.md、config.toml等)は変更しない
• zip内に検証スクリプトは同梱していない。バリデーションが必要な場合はCodex公式の skill-creator 系skill(存在する環境のみ)を使う