File contents 02-substitution-allowlist
§1.2 で予測される置換結果(skill body):
記法
期待
${CLAUDE_PLUGIN_ROOT}
絶対 path
${CLAUDE_PLUGIN_DATA}
絶対 path
${CLAUDE_SKILL_DIR}
SKILL.md の dirname の絶対 path
${CLAUDE_SESSION_ID}
UUID
${CLAUDE_PROJECT_DIR}
literal のまま残る
step 1: 5 種類の ${VAR} を skill body で echo
proj="${CLAUDE_PROJECT_DIR:-$PWD}"
ver="${VERIFIER_VERSION_DIR:-v-unknown}"
sid="${CLAUDE_SESSION_ID:-no-sid}"
out_dir="$proj/findings/$ver/$sid"
mkdir -p "$out_dir"
{
printf '[02-BODY %s] tag=alive-check\n' "$(date -Iseconds)"
printf '[02-BODY] SUBST_ROOT=[${CLAUDE_PLUGIN_ROOT}]\n'
printf '[02-BODY] SUBST_DATA=[${CLAUDE_PLUGIN_DATA}]\n'
printf '[02-BODY] SUBST_SKILL_DIR=[${CLAUDE_SKILL_DIR}]\n'
printf '[02-BODY] SUBST_SESSION_ID=[${CLAUDE_SESSION_ID}]\n'
printf '[02-BODY] SUBST_PROJECT_DIR=[${CLAUDE_PROJECT_DIR}]\n'
} | tee -a "$out_dir/probe.log"
step 2: verifier-violator の validator block 確認
proj="${CLAUDE_PROJECT_DIR:-$PWD}"
ver="${VERIFIER_VERSION_DIR:-v-unknown}"
echo "=== install.log (search for validator block) ==="
grep -E "plugin-only|CLAUDE_PLUGIN_DATA|skill hooks|Bad substitution" "$proj/findings/$ver/install.log" 2>&1 || echo "no install.log yet (run install-marketplace.sh first)"
echo
echo "=== probe.log tail ==="
sid="${CLAUDE_SESSION_ID:-no-sid}"
tail -n 30 "$proj/findings/$ver/$sid/probe.log"
完了したら exit。./scripts/assert.sh 02。
1 --- 2 name: "02-substitution-allowlist" 3 description: Probe ${VAR} substitution allowlist in skill body (§1.2). Tests CLAUDE_PLUGIN_ROOT/DATA/SKILL_DIR/SESSION_ID/PROJECT_DIR substitution at invoke time. 4 --- 5 6 # 02-substitution-allowlist 7 8 §1.2 で予測される置換結果(skill body): 9 10 | 記法 | 期待 | 11 |---|---| 12 | `${CLAUDE_PLUGIN_ROOT}` | 絶対 path | 13 | `${CLAUDE_PLUGIN_DATA}` | 絶対 path | 14 | `${CLAUDE_SKILL_DIR}` | SKILL.md の dirname の絶対 path | 15 | `${CLAUDE_SESSION_ID}` | UUID | 16 | `${CLAUDE_PROJECT_DIR}` | literal のまま残る | 17 18 ## step 1: 5 種類の `${VAR}` を skill body で echo 19 20 ```bash 21 proj="${CLAUDE_PROJECT_DIR:-$PWD}" 22 ver="${VERIFIER_VERSION_DIR:-v-unknown}" 23 sid="${CLAUDE_SESSION_ID:-no-sid}" 24 out_dir="$proj/findings/$ver/$sid" 25 mkdir -p "$out_dir" 26 { 27 printf '[02-BODY %s] tag=alive-check\n' "$(date -Iseconds)" 28 printf '[02-BODY] SUBST_ROOT=[${CLAUDE_PLUGIN_ROOT}]\n' 29 printf '[02-BODY] SUBST_DATA=[${CLAUDE_PLUGIN_DATA}]\n' 30 printf '[02-BODY] SUBST_SKILL_DIR=[${CLAUDE_SKILL_DIR}]\n' 31 printf '[02-BODY] SUBST_SESSION_ID=[${CLAUDE_SESSION_ID}]\n' 32 printf '[02-BODY] SUBST_PROJECT_DIR=[${CLAUDE_PROJECT_DIR}]\n' 33 } | tee -a "$out_dir/probe.log" 34 ``` 35 36 ## step 2: verifier-violator の validator block 確認 37 38 ```bash 39 proj="${CLAUDE_PROJECT_DIR:-$PWD}" 40 ver="${VERIFIER_VERSION_DIR:-v-unknown}" 41 echo "=== install.log (search for validator block) ===" 42 grep -E "plugin-only|CLAUDE_PLUGIN_DATA|skill hooks|Bad substitution" "$proj/findings/$ver/install.log" 2>&1 || echo "no install.log yet (run install-marketplace.sh first)" 43 echo 44 echo "=== probe.log tail ===" 45 sid="${CLAUDE_SESSION_ID:-no-sid}" 46 tail -n 30 "$proj/findings/$ver/$sid/probe.log" 47 ``` 48 49 完了したら exit。`./scripts/assert.sh 02`。
kazukinagata/analyzing-claude-plugin commit c634ede419
Frequently asked questions How do I install the 02 Substitution Allowlist skill? Run npx get-skill add kazukinagata/02-substitution-allowlist in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the 02 Substitution Allowlist skill do? Probe ${VAR} substitution allowlist in skill body (§1.2). Tests CLAUDE_PLUGIN_ROOT/DATA/SKILL_DIR/SESSION_ID/PROJECT_DIR substitution at invoke time. It is listed under Coding & Dev Tools on SkillMD.
Is 02 Substitution Allowlist safe to use? This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with 02 Substitution Allowlist? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is 02 Substitution Allowlist free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published 02 Substitution Allowlist? kazukinagata (@kazukinagata) published this skill. Their other Agent Skills are listed on their SkillMD profile.