octkp/skill-porter
dotfiles/claude/skills/skill-porter/SKILL.md
claude-skills リポジトリ内で、Claude Code 用スキル（<skill>/SKILL.md）と Codex CLI 用スキル（<skill>/.codex/SKILL.md）を相互変換（移植）するスキル。Claude→Codex はMCP/WebFetch/AskUserQuestion等のClaude固有ツールをCodexで動く形に読み替え、Codex→Claude はその逆を行う。「claude用スキルをcodex用に変換」「codex版を作って」「このスキルを移植」「逆変換してclaude版を作る」「skill-porter」などのリクエストでトリガー。
tools
Updated May 29, 2026
$ install --global
skillsauthnpx skillsauth add octkp/base skill-porterInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 29, 2026, 6:42 AM169.8s1 file scanned
SKILL.md
- name:
- skill-porter
- description:
- claude-skills リポジトリ内で、Claude Code 用スキル（<skill>/SKILL.md）と Codex CLI 用スキル（<skill>/.codex/SKILL.md）を相互変換（移植）するスキル。Claude→Codex はMCP/WebFetch/AskUserQuestion等のClaude固有ツールをCodexで動く形に読み替え、Codex→Claude はその逆を行う。「claude用スキルをcodex用に変換」「codex版を作って」「このスキルを移植」「逆変換してclaude版を作る」「skill-porter」などのリクエストでトリガー。
Skill Porter
Claude Code 用スキルと Codex CLI 用スキルを**相互変換（移植）**するスキル。
claude-skills リポジトリでは、1つのスキルにつき Claude版（SKILL.md）と Codex版（.codex/SKILL.md、任意）を同じディレクトリに同居させる構造を取っている：
| 区分 | 配布元の場所 | 特徴 |
|---|---|---|
| Claude Code 版 | <claude-skills>/teams/<team>/skills/<名前>/SKILL.md | MCP ツール・WebFetch・AskUserQuestion 等の Claude 固有機能が使える |
| Codex CLI 版 | <claude-skills>/teams/<team>/skills/<名前>/.codex/SKILL.md | それらが無いため、bash/curl/自然文での代替に読み替える必要がある |
両者はドメインのロジック（bash・テンプレート・ワークフローの骨子）は共通だが、ツールの呼び出し方とフロントマターが異なる。このスキルはその差分だけを規則的に変換し、人手判断が要る箇所はフラグして提示する。
これは機械的な文字列置換ではなく、意味を保ったまま読み替える変換。下の対応表を判断基準として使い、骨子はそのまま温存すること。
変換の対象と方向
- Claude → Codex:
<skill>/SKILL.mdを読み、<skill>/.codex/SKILL.mdを生成／更新する。 - Codex → Claude:
<skill>/.codex/SKILL.mdを読み、<skill>/SKILL.mdを生成／更新する。
リクエストから「どのスキルを」「どちら向きに」変換するかを読み取る。曖昧なら確認する。
ワークフロー
1. リポジトリのルートとチームパスを解決する
REPO_ROOT="$HOME/ghq/github.com/kokopelli-inc/claude-skills"
TEAM_PATH="teams/dev/ba2" # ← 対象スキルが属するチームパス
SKILL_DIR="$REPO_ROOT/$TEAM_PATH/skills/<name>" # ← 対象スキル名に置換
cd "$REPO_ROOT"
git pull --ff-only origin main 2>/dev/null || echo "（git pull はスキップ）"
2. ソースを読む
変換元の SKILL.md（Claude版）または .codex/SKILL.md（Codex版）を Read で読み込む。同ディレクトリに補助ファイル（参照ドキュメント等）があれば併せて把握する。
3. フロントマターを変換する
Claude → Codex
name: そのまま。description: 内容は保つ。Codex特有の制約で機能を省略する場合（例: JIRA投稿を落とす）はその旨を一文追記する。metadata.short-descriptionを追加する（1行で要約 + 末尾に「（Codex版）」）。
---
name: <name>
description: <...> Codex版は<省略点があれば明記>。
metadata:
short-description: <1行要約>（Codex版）
---
Codex → Claude
metadata.short-descriptionを削除する（Claude版はname+descriptionのみが基本）。descriptionから「Codex版は〜」等の Codex 固有注記を取り除き、Claude で復活する機能（JIRA投稿等）に合わせて文言を戻す。
4. タイトルと冒頭の注記を変換する
- Claude → Codex: 見出しを
# <スキル名> (Codex版)にし、冒頭に「Claude Code のスキル<name>を Codex 向けに移植したもの。」の一文を入れる。Codexで機能を省略する場合はそれも明記。 - Codex → Claude:
(Codex版)の接尾辞と移植注記を削除し、Claude版本来の説明に戻す。
5. ツールの呼び出しを読み替える（中核）
骨子（bashコマンド・Markdownテンプレート・手順の流れ）はそのまま温存し、ツール依存の箇所だけ下表に従って読み替える。
| 機能 | Claude Code 版 | Codex CLI 版 |
|---|---|---|
| Webページ取得 | WebFetch でURLを取得・抽出 | curl -s <url> で取得し、必要なら python3/jq でパース。取得不可ならユーザーに尋ねる |
| JIRA チケット名取得 | WebFetch（JIRAページ）または Atlassian MCP | curl -u "$ATLASSIAN_EMAIL:$ATLASSIAN_API_TOKEN" .../rest/api/3/issue/KEY?fields=summary。認証なしならユーザーに尋ねる |
| JIRA コメント投稿 | mcp__...atlassian...addCommentToJiraIssue | 省略（ファイル生成のみ）。必要なら curl REST を任意手順として記載。「Codex版はJIRA投稿しない」旨を注意書きに明記 |
| その他の MCP ツール（Slack/Notion/Sentry 等） | mcp__... を直接呼ぶ | 対応する公式 CLI / REST を bash で叩く、または「Codexでは未対応」として省略・ユーザー依頼に切替 |
| ユーザーへの選択質問 | AskUserQuestion（選択肢UI） | 自然文で質問する（「調査/実装/その他 のどれですか？」のように本文で尋ねる） |
| プランニング | EnterPlanMode / ExitPlanMode | プラン手順を自然文・箇条書きで提示してから実行（専用モードは無い） |
| サブエージェント | Agent / Task ツールで委譲 | サブエージェント機構が無いため、手順を本文に展開して直接実行する形に書き換える |
| コミット署名 | コミットメッセージ末尾に Co-Authored-By: Claude ... を付与 | その行は付けない（Codex版） |
Codex → Claude は上表を右→左に適用する。省略されていた機能（JIRA投稿等）を復活させる場合は、対応する MCP ツール名・パラメータを補う（不明なら元の Claude 版があればそれを参照し、無ければ TODO としてフラグ）。
6. ターゲットを書き出す
# 例: Claude → Codex
mkdir -p "$SKILL_DIR/.codex"
# 変換後の内容を $SKILL_DIR/.codex/SKILL.md に Write で書き出す
# 例: Codex → Claude
# 変換後の内容を $SKILL_DIR/SKILL.md に Write で書き出す
- 既存のターゲットがある場合は上書き更新になる旨を事前に伝える。気になる場合は変換前に
diffを見せる。 - SKILL.md 以外の補助ファイルは、ツール依存が無ければそのままコピーしてよい（
cp）。依存があれば同様に読み替える。
7. 結果を報告し、人手確認が要る箇所をフラグする
- 何を変換したか（フロントマター/タイトル/各ツール読み替え）を要約して報告する。
- 機械的に変換しきれなかった箇所を明示する。例:
- JIRA投稿など「省略した機能」→ Codex版で本当に落としてよいか
- Claude固有MCPの代替が存在しない機能
- 復活させた機能のMCPツール名・パラメータが推測の場合
- 変換後のファイルを配布元に置いたら、
skill-installerで個人ディレクトリへ取り込める旨、コミットが必要な旨を案内する（このスキル自身はコミットしない）。
注意事項
- 骨子は温存、ツールだけ読み替える。bashコマンド・テンプレート・日時フォーマット規則・出力先解決ロジック等のドメイン部分は変えない。
- Claude固有機能の「省略」は情報欠落になりうる。勝手に落とさず、省略する旨を変換先に明記し、報告でもフラグする。
- このスキルは変換（ファイル生成）専用。コミット・プッシュ・個人ディレクトリへの取り込みは行わない（それぞれ手動 /
skill-installerの責務）。 - 既存ターゲットの上書きは事前に明示する。
使用例
Claude → Codex
ユーザー: 「ticket-knowledge-reader の codex版を作って」
実行:
teams/dev/ba2/skills/ticket-knowledge-reader/SKILL.mdを読む- フロントマターに
metadata.short-description（Codex版）を追加、タイトルを(Codex版)化 - WebFetch→curl、AskUserQuestion→自然文 等を読み替え
teams/dev/ba2/skills/ticket-knowledge-reader/.codex/SKILL.mdに書き出し- 省略/要確認点を報告
Codex → Claude（逆変換）
ユーザー: 「この codex スキルを claude 用に逆変換して」
実行:
teams/dev/ba2/skills/<名前>/.codex/SKILL.mdを読むmetadata.short-descriptionと(Codex版)注記を削除- curl REST→WebFetch/MCP、自然文質問→AskUserQuestion 等を逆方向に読み替え
- 省略されていた機能（JIRA投稿等）の復活可否をユーザーに確認しつつ補う
teams/dev/ba2/skills/<名前>/SKILL.mdに書き出し、要確認点を報告
Related Skills
octkp/base-readme
documentation
VerifiedTrustedCommunity
base リポジトリ（~/base）の主要ディレクトリ（dotfiles / home / local / scripts / docs）の README.md と、リポジトリ直下の README.md を、実際のファイル構成に合わせて更新・新規作成するスキル。各ディレクトリの中身を実際に走査して内容を導出するので、設定追加・ディレクトリ移動のあとに走らせると README が現状と一致する。「READMEを更新して」「READMEを作り直して」「base のドキュメントを整える」「/base-readme」などのリクエストで使用。
SKILL.mdUpdated May 31, 2026
octkp/badev-knowledge-sync
development
VerifiedTrustedCommunity
旧 badev-knowledge-base リポの docs/{苗字}/ 配下を、許可リストの現役メンバー 4 人 (takano / tokita / yukioka / ushiroyama) に絞って ba2-workspace/docs/ に同期するスキル。旧リポを source of truth として、衝突時は新リポ側を旧リポで上書きする。コミット・プッシュは行わず、git add までで停止する。「badev-knowledge-base から同期して」「旧リポのナレッジを取り込んで」「badev-knowledge-sync を走らせて」「旧 docs を同期」などのリクエストでトリガー。
SKILL.mdUpdated May 31, 2026
octkp/ba2-ticket-knowledge-reader
documentation
VerifiedTrustedCommunity
チケット番号（BAX-XXXX）を伝えるだけで、ba2-ticket-knowledge-logger が記録したナレッジドキュメント（README.md / LOG.md / PLAN.md）を全ユーザー・全カテゴリ横断で自動検索して読み込み、要約して提示するスキル。別セッションで過去の調査・実装内容を読み直したいときに使う。「BAX-10987」「BAX-10325のナレッジ読んで」「前に調べたBAX-XXXXの記録」「BAX-XXXXの続きをやりたい」「BAX-XXXX読み直して」などのリクエストでトリガー。
SKILL.mdUpdated May 31, 2026
octkp/ba2-ticket-knowledge-logger
tools
VerifiedTrustedCommunity
チケット番号（BAX-XXXX）とカテゴリ（調査/実装/その他）を指定して、会話ログとまとめファイルを記録し、JIRAチケットにもコメントとしてナレッジを投稿するスキル。「BAX-10325の調査を記録」「実装にチケット作成」「会話ログを保存」などのリクエストで使用。
SKILL.mdUpdated May 31, 2026