tink-harness 1.6.1 → 1.6.3

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "tink",
   "description": "A small harness layer for Claude Code and Codex.",
-  "version": "1.6.1",
+  "version": "1.6.3",
   "author": {
     "name": "dotori"
   }

package/CHANGELOG.md

@@ -7,6 +7,35 @@ All notable changes to Tink are tracked here.
 No unreleased changes yet.
 
 
+## [1.6.3] - 2026-06-09
+
+### Changed
+
+- Interactive install/update now includes an `Advanced options` step so `--dry-run`, `--force`, and `--clean-codex-picker` are available as visible choices instead of CLI-only flags.
+- Install/update output now prints selected option state for preview, force overwrite, and Codex picker cleanup.
+- Non-interactive CLI flags still work and seed the same option state used by the interactive wizard.
+
+### Added
+
+- Regression coverage for visible advanced option labels and selected option output.
+- Korean PR history draft for the v1.6.3 patch in `docs/pr/2026-06-09-v1.6.3.ko.md`.
+
+
+## [1.6.2] - 2026-06-09
+
+### Changed
+
+- Codex action skill templates now install with names like `Tink: Cast`, `Tink: Verify`, and `Tink: Update` so the Codex picker shows the Tink namespace clearly.
+- The installer now separates `Claude Code Tink skill` and `Codex Tink skills` when both Claude Code and Codex surfaces are selected.
+- Install/update output now includes repo, shared `.tink`, Claude Code, Codex, and Codex picker cleanup target paths.
+
+### Added
+
+- `--clean-codex-picker` and `TINK_CLEAN_CODEX_PICKER=1` for removing repo-local Claude Tink command/skill surfaces that make Codex show noisy `Source Command Tink ...` entries.
+- Regression coverage for mixed-surface component choices, Codex skill display names, and Codex picker cleanup.
+- Korean PR history draft for the v1.6.2 patch in `docs/pr/2026-06-09-v1.6.2.ko.md`.
+
+
 ## [1.6.1] - 2026-06-09
 
 ### Fixed

package/README.ko.md

@@ -8,7 +8,7 @@ Claude Code와 Codex를 위한 작은 하네스 레이어입니다.
 
 Tink는 지금 작업에 맞는 하네스를 고르고, 실행 상태를 보이게 만들고, 실제 사용 중 생긴 실패와 피드백으로 하네스 세트를 개선합니다.
 
-**최신 패키지:** v1.6.1 — 기존 설치에서 `tink-harness update`를 실행할 때 generated legacy rule graph도 새 seed rules로 갱신합니다. 최신 마이너 릴리스 노트: [v1.6.0](https://github.com/dotoricode/tink-harness/releases/tag/v1.6.0).
+**최신 패키지:** v1.6.3 — interactive install/update에서 preview, force overwrite, Codex picker cleanup 같은 고급 옵션을 실제 선택지로 제공합니다. 최신 마이너 릴리스 노트: [v1.6.0](https://github.com/dotoricode/tink-harness/releases/tag/v1.6.0).
 
 [English](README.md) · **한국어**
 
@@ -59,12 +59,29 @@ npx tink-harness@latest update
 
 업데이트 후 Codex skill, schema, Windows 경고가 이상해 보이면 `docs/update-troubleshooting.ko.md` 또는 `docs/update-troubleshooting.md`를 확인하세요.
 
+## 1.6.3에서 달라진 점
+
+이번 패치는 CLI 옵션을 interactive installer 안에서 직접 고를 수 있게 만듭니다.
+
+- wizard에 `Advanced options` 단계가 추가되어 `Preview only (--dry-run)`, `Overwrite user-modified files (--force)`, `Clean Codex picker (--clean-codex-picker)`를 선택할 수 있습니다.
+- install/update 출력에 선택된 옵션 상태를 표시해서 preview, force overwrite, Codex picker cleanup이 켜졌는지 바로 볼 수 있습니다.
+- 기존 CLI flag는 그대로 동작하며, interactive wizard에서는 같은 옵션의 초기 선택값으로 반영됩니다.
+## 1.6.2에서 달라진 점
+
+이번 패치는 Claude Code와 Codex를 함께 쓰는 설치 흐름을 더 명확하게 만듭니다.
+
+- Codex action skill이 이제 `Cast`/`Verify` 같은 일반 이름 대신 `Tink: Cast`, `Tink: Verify`, `Tink: Update`처럼 설치됩니다.
+- Claude Code와 Codex를 함께 선택했을 때 컴포넌트 선택지에서 `Claude Code Tink skill`과 `Codex Tink skills`가 분리되어 보입니다.
+- install/update 출력에 repo, shared `.tink`, Claude Code, Codex target 경로를 표시해서 선택한 항목이 어디에 설치되는지 바로 볼 수 있습니다.
+- `--clean-codex-picker` 또는 `TINK_CLEAN_CODEX_PICKER=1`로 Codex에 `Source Command Tink ...` 항목을 만들던 repo-local Claude Tink command/skill surface를 정리할 수 있습니다.
+
 ## 1.6.1에서 달라진 점
 
 이번 패치는 기존 설치의 update 경로를 고칩니다.
 
 - `tink-harness update`가 v1.5.x에서 생성된 기본 `.tink/rules/index.json`을 새 v1.6.x rule graph seed로 갱신합니다.
 - custom rule이나 rule evidence가 들어간 사용자 수정 rule graph는 계속 보존합니다.
+
 ## 1.6.0에서 달라진 점
 
 이번 릴리스는 Tink의 작은 rule graph를 실제 작업에서 더 쓸모 있게 만듭니다.

package/README.md

@@ -24,7 +24,7 @@
   <a href="https://github.com/dotoricode/tink-harness/stargazers"><img src="https://img.shields.io/github/stars/dotoricode/tink-harness?style=social" alt="GitHub stars"></a>
 </p>
 
-<p><strong>Latest package:</strong> v1.6.1 - Existing installs now refresh generated legacy rule graphs during <code>tink-harness update</code>. Latest minor release notes: <a href="https://github.com/dotoricode/tink-harness/releases/tag/v1.6.0">v1.6.0</a>.</p>
+<p><strong>Latest package:</strong> v1.6.3 - Interactive install/update now offers advanced options such as preview, force overwrite, and Codex picker cleanup as real choices. Latest minor release notes: <a href="https://github.com/dotoricode/tink-harness/releases/tag/v1.6.0">v1.6.0</a>.</p>
 
 **English** · [한국어](README.ko.md)
 
@@ -124,6 +124,23 @@ To quickly verify the updated install, see `docs/update-verification-recipe.md`
 
 If an update looks stale or incomplete, see `docs/update-troubleshooting.md` or `docs/update-troubleshooting.ko.md`.
 
+## What's new in 1.6.3
+
+This patch makes CLI options visible in the interactive installer.
+
+- The wizard now has an `Advanced options` step with `Preview only (--dry-run)`, `Overwrite user-modified files (--force)`, and `Clean Codex picker (--clean-codex-picker)` when Codex is selected.
+- Install/update output now prints the selected option state, so you can see whether preview, force overwrite, or Codex picker cleanup is active.
+- CLI flags still work for non-interactive runs and seed the same visible choices when the wizard is used.
+
+## What's new in 1.6.2
+
+This patch makes the installer clearer for mixed Claude Code + Codex setups.
+
+- Codex action skills now install with names like `Tink: Cast`, `Tink: Verify`, and `Tink: Update` instead of generic `Cast`/`Verify` labels.
+- The component picker now separates `Claude Code Tink skill` from `Codex Tink skills` when both surfaces are selected.
+- Install/update output now prints the repo, shared `.tink`, Claude Code, and Codex target paths so you can see where the selected choices will land.
+- `--clean-codex-picker` and `TINK_CLEAN_CODEX_PICKER=1` can remove repo-local Claude Tink command/skill surfaces that make Codex show noisy `Source Command Tink ...` entries.
+
 ## What's new in 1.6.1
 
 This patch fixes the update path for existing installs.

package/VERSIONING.md

@@ -1,6 +1,6 @@
 # Versioning
 
-Current version: `1.6.1`
+Current version: `1.6.3`
 
 Tink follows semver from `1.0.0` onward.
 

package/bin/install.js

@@ -12,8 +12,9 @@ const root = path.resolve(__dirname, '..');
 const args = process.argv.slice(2);
 const command = args[0] || 'install';
 const isUpdate = command === 'update';
-const dryRun = args.includes('--dry-run');
-const force = args.includes('--force');
+let dryRun = args.includes('--dry-run');
+let force = args.includes('--force');
+let cleanCodexPicker = args.includes('--clean-codex-picker') || process.env.TINK_CLEAN_CODEX_PICKER === '1';
 const yes = args.includes('--yes') || args.includes('-y');
 const interactive = process.stdin.isTTY && process.stdout.isTTY && !yes && !dryRun;
 const source = 'https://github.com/dotoricode/tink-harness.git';
@@ -120,7 +121,7 @@ function argValue(name) {
 }
 
 function usage() {
-  console.log(`Tink installer for Claude Code and Codex\n\nUsage:\n  npx tink-harness@latest [install] [--scope=repo|global] [--global] [--lang=en|ko|zh] [--yes] [--with-hook] [--dry-run] [--force]\n  npx tink-harness@latest update [--scope=repo|global] [--global] [--lang=en|ko|zh] [--yes] [--dry-run] [--force]\n\nCommands:\n  install  Install Tink.\n  update   Update Tink to the latest templates. Keeps user-modified files.\n\nDefault interactive flow:\n  1. Select language\n  2. Show TINK wizard\n  3. Select Claude Code, Codex, or both\n  4. Select components\n  5. Select repo/global installation scope\n  6. Select git tracking policy for project state\n\nScopes:\n  repo    Install shared .tink files into the current project.\n  global  Install shared .tink files into your home directory.\n`);
+  console.log(`Tink installer for Claude Code and Codex\n\nUsage:\n  npx tink-harness@latest [install] [--scope=repo|global] [--global] [--lang=en|ko|zh] [--yes] [--with-hook] [--clean-codex-picker] [--dry-run] [--force]\n  npx tink-harness@latest update [--scope=repo|global] [--global] [--lang=en|ko|zh] [--yes] [--clean-codex-picker] [--dry-run] [--force]\n\nCommands:\n  install  Install Tink.\n  update   Update Tink to the latest templates. Keeps user-modified files.\n\nDefault interactive flow:\n  1. Select language\n  2. Show TINK wizard\n  3. Select Claude Code, Codex, or both\n  4. Select components\n  5. Select repo/global installation scope\n  6. Select git tracking policy for project state\n\nOptions:\n  --clean-codex-picker  Remove repo-local Claude Tink command/skill surfaces from the current repo so Codex shows focused Tink skills instead of Source Command Tink entries.\n\nEnvironment:\n  TINK_INSTALL_SURFACES=claude|codex|all\n  TINK_CLEAN_CODEX_PICKER=1\n\nScopes:\n  repo    Install shared .tink files into the current project.\n  global  Install shared .tink files into your home directory.\n`);
 }
 
 function normalizeSurfaces(surfaces) {
@@ -159,7 +160,7 @@ function codexHome() {
   return process.env.CODEX_HOME || path.join(os.homedir(), '.codex');
 }
 
-function componentOptionsFor(agent, language) {
+function legacyComponentOptionsFor(agent, language) {
   const options = COMPONENTS[language].filter((item) => {
     if (item.value === 'commands') return includesClaude(agent);
     if (item.value === 'hook') return includesClaude(agent);
@@ -193,6 +194,116 @@ function componentOptionsFor(agent, language) {
   });
 }
 
+function componentOptionsFor(agent, language) {
+  const options = COMPONENTS[language].flatMap((item) => {
+    if (item.value === 'commands') return includesClaude(agent) ? [item] : [];
+    if (item.value === 'hook') return includesClaude(agent) ? [item] : [];
+    if (item.value !== 'skill') return [item];
+
+    const claudeSkill = {
+      value: 'claude-skill',
+      label: 'Claude Code Tink skill',
+      hint: language === 'ko'
+        ? 'Claude Code가 읽는 Tink 작업 원칙'
+        : 'Tink operating rules for Claude Code'
+    };
+    const codexSkills = {
+      value: 'codex-skills',
+      label: 'Codex Tink skills',
+      hint: language === 'ko'
+        ? 'Codex가 $tink:*로 읽는 Tink action skills'
+        : 'Tink action skills for Codex through $tink:*'
+    };
+
+    if (agent === 'claude') return [claudeSkill];
+    if (agent === 'codex') return [codexSkills];
+    return [claudeSkill, codexSkills];
+  });
+
+  return options;
+}
+
+function wantsClaudeSkill(components) {
+  return components.includes('skill') || components.includes('claude-skill');
+}
+
+function wantsCodexSkills(components) {
+  return components.includes('skill') || components.includes('codex-skills');
+}
+
+function wantsCodexPickerCleanup(components, agent) {
+  return cleanCodexPicker || components.includes('codex-picker-cleanup') || agent === 'codex';
+}
+
+function advancedOptionChoices(agent, language) {
+  const choices = [
+    {
+      value: 'dry-run',
+      label: 'Preview only (--dry-run)',
+      hint: language === 'ko'
+        ? '파일을 쓰거나 지우지 않고 어떤 작업을 할지만 보여줍니다.'
+        : 'Show planned writes/removals without changing files.'
+    },
+    {
+      value: 'force',
+      label: 'Overwrite user-modified files (--force)',
+      hint: language === 'ko'
+        ? '사용자가 수정한 파일도 덮어쓸 수 있는 위험 옵션입니다.'
+        : 'Risky. Allows overwriting user-modified files.'
+    }
+  ];
+  if (includesCodex(agent)) {
+    choices.push({
+      value: 'clean-codex-picker',
+      label: 'Clean Codex picker (--clean-codex-picker)',
+      hint: language === 'ko'
+        ? '현재 repo의 repo-local Claude Tink surface를 정리해 Source Command Tink 항목을 줄입니다.'
+        : 'Remove repo-local Claude Tink surfaces that show as Source Command Tink entries.'
+    });
+  }
+  return choices;
+}
+
+function defaultAdvancedValues(agent) {
+  return [
+    dryRun ? 'dry-run' : null,
+    force ? 'force' : null,
+    includesCodex(agent) && cleanCodexPicker ? 'clean-codex-picker' : null
+  ].filter(Boolean);
+}
+
+function applyAdvancedOptions(values) {
+  dryRun = values.includes('dry-run');
+  force = values.includes('force');
+  cleanCodexPicker = values.includes('clean-codex-picker');
+}
+
+function optionsSummary(agent) {
+  return [
+    `Preview only (--dry-run): ${dryRun ? 'yes' : 'no'}`,
+    `Overwrite user-modified files (--force): ${force ? 'yes' : 'no'}`,
+    includesCodex(agent) ? `Clean Codex picker (--clean-codex-picker): ${cleanCodexPicker ? 'yes' : 'no'}` : null
+  ].filter(Boolean).join('\n');
+}
+
+function locationSummary(agent, scope) {
+  const repoTarget = process.cwd();
+  const installTarget = scope === 'global' ? os.homedir() : repoTarget;
+  return [
+    `Repo target: ${repoTarget}`,
+    `Shared .tink target: ${path.join(installTarget, '.tink')}`,
+    includesClaude(agent) ? `Claude Code command target: ${path.join(installTarget, '.claude/commands/tink')}` : null,
+    includesClaude(agent) ? `Claude Code skill target: ${path.join(installTarget, '.claude/skills/tink')}` : null,
+    includesCodex(agent) ? `Codex skills target: ${path.join(codexHome(), 'skills')}` : null,
+    includesCodex(agent) ? `Codex picker cleanup target: ${path.join(process.cwd(), '.claude')}` : null
+  ].filter(Boolean).join('\n');
+}
+
+function defaultComponentValues(agent, language) {
+  return componentOptionsFor(agent, language)
+    .map((item) => item.value)
+    .filter((value) => value !== 'hook');
+}
 function colorLine(line, color) {
   if (!process.stdout.isTTY && !interactive) return line;
   const [r, g, b] = color;
@@ -510,17 +621,20 @@ function copySelected(scope, components, agent) {
   const codexTarget = codexHome();
   const target = scope === 'global' ? globalTarget : repoTarget;
   const templateRoot = path.join(root, 'templates');
+  const cleanupCodexPicker = wantsCodexPickerCleanup(components, agent);
 
-  if (includesClaude(agent) && components.includes('commands')) {
+  if (includesClaude(agent) && components.includes('commands') && !cleanupCodexPicker) {
     copyTinkCommands(templateRoot, target);
   }
-  if (agent === 'codex') {
-    removeRepoLocalClaudeTinkSurface(target);
+  if (cleanupCodexPicker) {
+    removeRepoLocalClaudeTinkSurface(repoTarget);
   }
-  if (components.includes('skill')) {
-    if (includesClaude(agent)) {
+  if (wantsClaudeSkill(components)) {
+    if (includesClaude(agent) && !cleanupCodexPicker) {
       copyDir(path.join(templateRoot, 'claude/skills'), path.join(target, '.claude/skills'), target);
     }
+  }
+  if (wantsCodexSkills(components)) {
     if (includesCodex(agent)) {
       removeLegacyCodexSkill(codexTarget);
       copyDir(path.join(templateRoot, 'codex/skills'), path.join(codexTarget, 'skills'), codexTarget);
@@ -644,8 +758,9 @@ async function resolveChoices() {
   }
   if (!['en', 'ko', 'zh'].includes(language)) language = 'en';
 
-  let components = componentOptionsFor(agent, language).map((item) => item.value).filter((value) => value !== 'hook');
+  let components = defaultComponentValues(agent, language);
   if (includesClaude(agent) && args.includes('--with-hook')) components.push('hook');
+  let advancedOptions = defaultAdvancedValues(agent);
   let gitPolicy = 'harnesses';
   let hookScope = 'off';
 
@@ -692,8 +807,9 @@ async function resolveChoices() {
     initialValues: agent === 'all' ? ['claude', 'codex'] : [agent],
     required: true
   })));
-  components = componentOptionsFor(agent, language).map((item) => item.value).filter((value) => value !== 'hook');
+  components = defaultComponentValues(agent, language);
   if (includesClaude(agent) && args.includes('--with-hook')) components.push('hook');
+  advancedOptions = defaultAdvancedValues(agent);
 
   components = handleCancel(await multiselect({
     message: copy.components,
@@ -727,6 +843,17 @@ async function resolveChoices() {
     initialValue: scope || 'repo'
   }));
 
+  advancedOptions = handleCancel(await multiselect({
+    message: language === 'ko' ? '실행 옵션을 선택하세요 (space로 토글)' : 'Select run options (space to toggle)',
+    options: advancedOptionChoices(agent, language),
+    initialValues: advancedOptions,
+    required: false
+  }));
+  applyAdvancedOptions(advancedOptions);
+  note(optionsSummary(agent), language === 'ko' ? '선택된 옵션' : 'Selected options');
+
+  note(locationSummary(agent, scope), language === 'ko' ? '설치 위치' : 'Install locations');
+
   if (scope === 'repo' && components.some((item) => ['harnesses', 'memory', 'hook'].includes(item))) {
     note(copy.gitNote, copy.gitNoteTitle);
     gitPolicy = handleCancel(await select({
@@ -788,6 +915,8 @@ async function main() {
     console.log(`language ${language}`);
     console.log(`scope ${scope}`);
     console.log(`components ${components.join(', ')}`);
+    console.log(optionsSummary(agent));
+    console.log(locationSummary(agent, scope));
   }
 
   const targets = copySelected(scope, components, agent);

package/docs/pr/2026-06-09-v1.6.2.ko.md

@@ -0,0 +1,29 @@
+# v1.6.2 패치 이력 초안
+
+## 문제
+
+- 다른 레포에서 update 후 Codex picker에 repo-local Claude Code command가 `Source Command Tink ...`로 많이 보였음.
+- Codex action skill은 `Cast`처럼 일반 이름으로 보여서 사용자가 기대한 `Tink: Cast` 항목을 찾기 어려웠음.
+- Claude Code와 Codex를 함께 설치할 때 컴포넌트 선택지에서 Codex 전용 skill 선택지가 분리되어 보이지 않았음.
+- 설치 또는 업데이트 중 선택한 surface가 실제 어느 경로에 설치되는지 중간에 확인하기 어려웠음.
+
+## 해결
+
+- Codex action skill 템플릿 이름을 `Tink: Cast`, `Tink: Verify`, `Tink: Update`처럼 Tink prefix가 보이도록 바꿨음.
+- installer의 컴포넌트 선택지를 `Claude Code Tink skill`과 `Codex Tink skills`로 분리했음.
+- install/update 출력에 repo target, shared `.tink` target, Claude Code target, Codex skills target, Codex picker cleanup target을 표시함.
+- `--clean-codex-picker`와 `TINK_CLEAN_CODEX_PICKER=1`을 추가해서 repo-local Claude Tink command/skill surface를 명시적으로 정리할 수 있게 했음.
+- Codex-only update는 기존처럼 repo-local Claude Tink surface를 자동 정리함.
+
+## 검증
+
+- `python tests/test_templates.py` 통과했음.
+- `node --check bin/install.js` 통과했음.
+- mixed Claude Code + Codex dry-run에서 `claude-skill`, `codex-skills`, 설치 위치 출력 확인했음.
+- cleanup smoke에서 `.claude/commands/tink/cast.md`와 `.claude/skills/tink/SKILL.md`가 제거되고 `Tink: Cast` Codex skill이 설치되는 것 확인했음.
+
+## 참고
+
+- patch 릴리스이므로 GitHub Release는 새로 만들지 않음.
+- 최신 마이너 릴리스 노트는 v1.6.0에 유지함.
+- Claude Code와 Codex를 같은 repo에서 동시에 쓰되 Codex picker를 깔끔하게 유지하려면 `--clean-codex-picker`를 사용하면 됨.

package/docs/pr/2026-06-09-v1.6.3.ko.md

@@ -0,0 +1,27 @@
+# v1.6.3 패치 이력 초안
+
+## 문제
+
+- `--clean-codex-picker`처럼 사용자가 알아야 하는 옵션이 CLI flag로는 있었지만, interactive install/update 흐름에서는 별도 선택지로 충분히 드러나지 않았음.
+- 사용자는 설치 중 “지금 어떤 옵션이 켜져 있는지”를 출력으로 확인하기 어려웠음.
+- `--dry-run`, `--force`, `--clean-codex-picker`가 모두 실행 방식에 영향을 주는데, 일부는 선택 화면이 아니라 명령어를 알아야만 쓸 수 있었음.
+
+## 해결
+
+- interactive wizard에 `Advanced options` 단계를 추가했음.
+- `Preview only (--dry-run)`, `Overwrite user-modified files (--force)`, `Clean Codex picker (--clean-codex-picker)`를 실제 선택지로 제공함.
+- 선택된 옵션 상태를 install/update 출력에 표시함.
+- 기존 CLI flag는 그대로 유지하고, interactive wizard에서는 같은 옵션의 초기 선택값으로 반영되도록 했음.
+
+## 검증
+
+- `npm test`로 installer 문구, 선택 상태 출력, package metadata 회귀 테스트를 확인할 예정임.
+- `git diff --check`로 공백 문제를 확인할 예정임.
+- `npm pack --dry-run --json`으로 패키지 포함 파일을 확인할 예정임.
+- publish 후 `@latest` smoke에서 option state 출력과 `--clean-codex-picker` 동작을 확인할 예정임.
+
+## 참고
+
+- patch 릴리스이므로 GitHub Release는 새로 만들지 않음.
+- 최신 마이너 릴리스 노트는 v1.6.0에 유지함.
+- 이 변경은 새 명령을 추가하지 않고 기존 installer/update wizard의 선택 흐름만 명확하게 만듦.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tink-harness",
-  "version": "1.6.1",
+  "version": "1.6.3",
   "description": "Self-growing harnesses for Claude Code and Codex.",
   "license": "MIT",
   "type": "module",

package/templates/codex/skills/tink-cast/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: cast
+name: "Tink: Cast"
 description: Start a Tink run for a non-trivial task.
 ---
 

package/templates/codex/skills/tink-frog/SKILL.md

@@ -1,13 +1,13 @@
----
-name: frog
-description: Propose safe cleanup for unused or redundant Tink harnesses.
----
-
-# Tink Frog
-
-This is the Codex alias for `$tink:frog`.
-
-1. Read `../tink-core/RULES.md` first.
-2. Treat this invocation as `$tink:frog`.
-3. Follow the canonical Tink frog behavior and never delete without approval.
-4. Accept legacy `$tink frog` wording as the same action, but present `$tink:frog` in guidance.
+---
+name: "Tink: Frog"
+description: Propose safe cleanup for unused or redundant Tink harnesses.
+---
+
+# Tink Frog
+
+This is the Codex alias for `$tink:frog`.
+
+1. Read `../tink-core/RULES.md` first.
+2. Treat this invocation as `$tink:frog`.
+3. Follow the canonical Tink frog behavior and never delete without approval.
+4. Accept legacy `$tink frog` wording as the same action, but present `$tink:frog` in guidance.

package/templates/codex/skills/tink-list/SKILL.md

@@ -1,13 +1,13 @@
----
-name: list
-description: Inspect available Tink harnesses and usage signals.
----
-
-# Tink List
-
-This is the Codex alias for `$tink:list`.
-
-1. Read `../tink-core/RULES.md` first.
-2. Treat this invocation as `$tink:list`.
-3. Follow the canonical Tink list behavior.
-4. Accept legacy `$tink list` wording as the same action, but present `$tink:list` in guidance.
+---
+name: "Tink: List"
+description: Inspect available Tink harnesses and usage signals.
+---
+
+# Tink List
+
+This is the Codex alias for `$tink:list`.
+
+1. Read `../tink-core/RULES.md` first.
+2. Treat this invocation as `$tink:list`.
+3. Follow the canonical Tink list behavior.
+4. Accept legacy `$tink list` wording as the same action, but present `$tink:list` in guidance.

package/templates/codex/skills/tink-setup/SKILL.md

@@ -1,13 +1,13 @@
----
-name: setup
-description: Configure Tink language, scope, git tracking, and policy.
----
-
-# Tink Setup
-
-This is the Codex alias for `$tink:setup`.
-
-1. Read `../tink-core/RULES.md` first.
-2. Treat this invocation as `$tink:setup`.
-3. Follow the canonical Tink setup behavior.
-4. Accept legacy `$tink setup` wording as the same action, but present `$tink:setup` in guidance.
+---
+name: "Tink: Setup"
+description: Configure Tink language, scope, git tracking, and policy.
+---
+
+# Tink Setup
+
+This is the Codex alias for `$tink:setup`.
+
+1. Read `../tink-core/RULES.md` first.
+2. Treat this invocation as `$tink:setup`.
+3. Follow the canonical Tink setup behavior.
+4. Accept legacy `$tink setup` wording as the same action, but present `$tink:setup` in guidance.

package/templates/codex/skills/tink-update/SKILL.md

@@ -1,13 +1,13 @@
----
-name: update
-description: Detect the Tink install source and show the safe update path.
----
-
-# Tink Update
-
-This is the Codex alias for `$tink:update`.
-
-1. Read `../tink-core/RULES.md` first.
-2. Treat this invocation as `$tink:update`.
-3. Follow the canonical Tink update behavior.
-4. Accept legacy `$tink update` wording as the same action, but present `$tink:update` in guidance.
+---
+name: "Tink: Update"
+description: Detect the Tink install source and show the safe update path.
+---
+
+# Tink Update
+
+This is the Codex alias for `$tink:update`.
+
+1. Read `../tink-core/RULES.md` first.
+2. Treat this invocation as `$tink:update`.
+3. Follow the canonical Tink update behavior.
+4. Accept legacy `$tink update` wording as the same action, but present `$tink:update` in guidance.

package/templates/codex/skills/tink-verify/SKILL.md

@@ -1,13 +1,13 @@
----
-name: verify
-description: Run or report the checks promised in the Tink contract.
----
-
-# Tink Verify
-
-This is the Codex alias for `$tink:verify`.
-
-1. Read `../tink-core/RULES.md` first.
-2. Treat this invocation as `$tink:verify`.
-3. Plan checks from `.tink/current/contract.json`, then record evidence in `.tink/current/verification.json`.
-4. Accept legacy `$tink verify` wording as the same action, but present `$tink:verify` in guidance.
+---
+name: "Tink: Verify"
+description: Run or report the checks promised in the Tink contract.
+---
+
+# Tink Verify
+
+This is the Codex alias for `$tink:verify`.
+
+1. Read `../tink-core/RULES.md` first.
+2. Treat this invocation as `$tink:verify`.
+3. Plan checks from `.tink/current/contract.json`, then record evidence in `.tink/current/verification.json`.
+4. Accept legacy `$tink verify` wording as the same action, but present `$tink:verify` in guidance.

package/templates/codex/skills/tink-weave/SKILL.md

@@ -1,13 +1,13 @@
----
-name: weave
-description: Improve Tink harnesses from real use, failures, and corrections.
----
-
-# Tink Weave
-
-This is the Codex alias for `$tink:weave`.
-
-1. Read `../tink-core/RULES.md` first.
-2. Treat this invocation as `$tink:weave`.
-3. Follow the canonical Tink weave behavior and save reusable changes only after separate approval.
-4. Accept legacy `$tink weave` wording as the same action, but present `$tink:weave` in guidance.
+---
+name: "Tink: Weave"
+description: Improve Tink harnesses from real use, failures, and corrections.
+---
+
+# Tink Weave
+
+This is the Codex alias for `$tink:weave`.
+
+1. Read `../tink-core/RULES.md` first.
+2. Treat this invocation as `$tink:weave`.
+3. Follow the canonical Tink weave behavior and save reusable changes only after separate approval.
+4. Accept legacy `$tink weave` wording as the same action, but present `$tink:weave` in guidance.