Skip to content

Harness engineering beginner tutorial, from 0 to 1

Fix harness creator skill installation docs

sanbuphy14024c6f2e5e
diff --git a/README.md b/README.md
index 2c57a83..e53371f 100644
--- a/README.md
+++ b/README.md
@@ -34,7 +34,7 @@ Learn Harness Engineering is a course dedicated to the engineering of AI coding
- [Anthropic: Harness design for long-running application development](https://www.anthropic.com/engineering/harness-design-long-running-apps)
- [Awesome Harness Engineering](https://github.com/walkinglabs/awesome-harness-engineering)
-> **Quick start?** The [`skills/harness-creator/`](./skills/) skill can help you scaffold a production-grade harness (AGENTS.md, feature lists, init.sh, verification workflows) for your own project in minutes.
+> **Quick start?** The [`skills/harness-creator/`](./skills/harness-creator/) skill can help you scaffold a production-grade harness (AGENTS.md, feature lists, init.sh, verification workflows) for your own project in minutes.
---
diff --git a/docs-readme/ar-SA/README.md b/docs-readme/ar-SA/README.md
index 87c7df6..5383934 100644
--- a/docs-readme/ar-SA/README.md
+++ b/docs-readme/ar-SA/README.md
@@ -25,7 +25,7 @@
- [Anthropic: Harness design for long-running application development](https://www.anthropic.com/engineering/harness-design-long-running-apps)
- [Awesome Harness Engineering](https://github.com/walkinglabs/awesome-harness-engineering)
-> **تبدأ سريعاً؟** مهارة [`skills/harness-creator/`](../../skills/) يمكن أن تساعدك في إنشاء حزام بمستوى الإنتاج (AGENTS.md، قوائم الميزات، init.sh، سير عمل التحقق) لمشروعك الخاص في دقائق.
+> **تبدأ سريعاً؟** مهارة [`skills/harness-creator/`](../../skills/harness-creator/) يمكن أن تساعدك في إنشاء حزام بمستوى الإنتاج (AGENTS.md، قوائم الميزات، init.sh، سير عمل التحقق) لمشروعك الخاص في دقائق.
---
diff --git a/docs-readme/de-DE/README.md b/docs-readme/de-DE/README.md
index b84916a..8d932e8 100644
--- a/docs-readme/de-DE/README.md
+++ b/docs-readme/de-DE/README.md
@@ -25,7 +25,7 @@ Learn Harness Engineering ist ein Kurs, der sich der Entwicklung von KI-Coding-A
- [Anthropic: Harness design for long-running application development](https://www.anthropic.com/engineering/harness-design-long-running-apps)
- [Awesome Harness Engineering](https://github.com/walkinglabs/awesome-harness-engineering)
-> **Schneller Einstieg?** Der Skill [`skills/harness-creator/`](../../skills/) kann Ihnen helfen, in Minuten ein produktionsreifes Harness (AGENTS.md, Feature-Listen, init.sh, Verifizierungs-Workflows) für Ihr eigenes Projekt zu erstellen.
+> **Schneller Einstieg?** Der Skill [`skills/harness-creator/`](../../skills/harness-creator/) kann Ihnen helfen, in Minuten ein produktionsreifes Harness (AGENTS.md, Feature-Listen, init.sh, Verifizierungs-Workflows) für Ihr eigenes Projekt zu erstellen.
---
diff --git a/docs-readme/es-ES/README.md b/docs-readme/es-ES/README.md
index 50b41c2..4dea43d 100644
--- a/docs-readme/es-ES/README.md
+++ b/docs-readme/es-ES/README.md
@@ -25,7 +25,7 @@ Learn Harness Engineering es un curso dedicado a la ingeniería de agentes de co
- [Anthropic: Harness design for long-running application development](https://www.anthropic.com/engineering/harness-design-long-running-apps)
- [Awesome Harness Engineering](https://github.com/walkinglabs/awesome-harness-engineering)
-> **Inicio rápido?** La skill [`skills/harness-creator/`](../../skills/) puede ayudarte a generar un harness de nivel productivo (AGENTS.md, listas de funcionalidades, init.sh, flujos de verificación) para tu propio proyecto en cuestión de minutos.
+> **Inicio rápido?** La skill [`skills/harness-creator/`](../../skills/harness-creator/) puede ayudarte a generar un harness de nivel productivo (AGENTS.md, listas de funcionalidades, init.sh, flujos de verificación) para tu propio proyecto en cuestión de minutos.
---
diff --git a/docs-readme/fr-FR/README.md b/docs-readme/fr-FR/README.md
index 4042859..bf57553 100644
--- a/docs-readme/fr-FR/README.md
+++ b/docs-readme/fr-FR/README.md
@@ -25,7 +25,7 @@ Learn Harness Engineering est un cours dédié à l'ingénierie des agents de co
- [Anthropic : Harness design for long-running application development](https://www.anthropic.com/engineering/harness-design-long-running-apps)
- [Awesome Harness Engineering](https://github.com/walkinglabs/awesome-harness-engineering)
-> **Démarrage rapide ?** Le skill [`skills/harness-creator/`](../../skills/) peut vous aider à générer un harness de niveau production (AGENTS.md, listes de fonctionnalités, init.sh, flux de vérification) pour votre propre projet en quelques minutes.
+> **Démarrage rapide ?** Le skill [`skills/harness-creator/`](../../skills/harness-creator/) peut vous aider à générer un harness de niveau production (AGENTS.md, listes de fonctionnalités, init.sh, flux de vérification) pour votre propre projet en quelques minutes.
---
diff --git a/docs-readme/ja-JP/README.md b/docs-readme/ja-JP/README.md
index be8dff0..633e66e 100644
--- a/docs-readme/ja-JP/README.md
+++ b/docs-readme/ja-JP/README.md
@@ -25,7 +25,7 @@ Learn Harness Engineering は、AIコーディングエージェントのエン
- [Anthropic: Harness design for long-running application development](https://www.anthropic.com/engineering/harness-design-long-running-apps)
- [Awesome Harness Engineering](https://github.com/walkinglabs/awesome-harness-engineering)
-> **すぐに始めたい方へ:** [`skills/harness-creator/`](../../skills/) スキルを使えば、自分のプロジェクト向けに本格的なハーネス(AGENTS.md、機能リスト、init.sh、検証ワークフロー)を数分でスキャフォールドできます。
+> **すぐに始めたい方へ:** [`skills/harness-creator/`](../../skills/harness-creator/) スキルを使えば、自分のプロジェクト向けに本格的なハーネス(AGENTS.md、機能リスト、init.sh、検証ワークフロー)を数分でスキャフォールドできます。
---
diff --git a/docs-readme/ko-KR/README.md b/docs-readme/ko-KR/README.md
index 3a22772..0b8ad4b 100644
--- a/docs-readme/ko-KR/README.md
+++ b/docs-readme/ko-KR/README.md
@@ -25,7 +25,7 @@ Learn Harness Engineering은 AI 코딩 에이전트의 엔지니어링에 집중
- [Anthropic: Harness design for long-running application development](https://www.anthropic.com/engineering/harness-design-long-running-apps)
- [Awesome Harness Engineering](https://github.com/walkinglabs/awesome-harness-engineering)
-> **빠른 시작?** [`skills/harness-creator/`](../../skills/) 스킬을 사용하면 몇 분 만에 여러분의 프로젝트에 프로덕션급 하니스(AGENTS.md, 기능 목록, init.sh, 검증 워크플로우)를 스캐폴딩할 수 있습니다.
+> **빠른 시작?** [`skills/harness-creator/`](../../skills/harness-creator/) 스킬을 사용하면 몇 분 만에 여러분의 프로젝트에 프로덕션급 하니스(AGENTS.md, 기능 목록, init.sh, 검증 워크플로우)를 스캐폴딩할 수 있습니다.
---
diff --git a/docs-readme/ru-RU/README.md b/docs-readme/ru-RU/README.md
index 582817d..8ab4664 100644
--- a/docs-readme/ru-RU/README.md
+++ b/docs-readme/ru-RU/README.md
@@ -25,7 +25,7 @@ Learn Harness Engineering — курс, посвящённый инженери
- [Anthropic: Harness design for long-running application development](https://www.anthropic.com/engineering/harness-design-long-running-apps)
- [Awesome Harness Engineering](https://github.com/walkinglabs/awesome-harness-engineering)
-> **Быстрый старт?** Skill [`skills/harness-creator/`](../../skills/) поможет вам за считанные минуты создать готовое к продакшену harness (AGENTS.md, feature-списки, init.sh, верификационные workflow) для вашего собственного проекта.
+> **Быстрый старт?** Skill [`skills/harness-creator/`](../../skills/harness-creator/) поможет вам за считанные минуты создать готовое к продакшену harness (AGENTS.md, feature-списки, init.sh, верификационные workflow) для вашего собственного проекта.
---
diff --git a/docs-readme/tr-TR/README.md b/docs-readme/tr-TR/README.md
index 6e6592e..1aab471 100644
--- a/docs-readme/tr-TR/README.md
+++ b/docs-readme/tr-TR/README.md
@@ -25,7 +25,7 @@ Learn Harness Engineering, yapay zeka kod yazma ajanlarının mühendisliğine a
- [Anthropic: Harness design for long-running application development](https://www.anthropic.com/engineering/harness-design-long-running-apps)
- [Awesome Harness Engineering](https://github.com/walkinglabs/awesome-harness-engineering)
-> **Hızlı başlangıç mı?** [`skills/harness-creator/`](../../skills/) skill'i, kendi projeniz için üretim kalitesinde bir harness (AGENTS.md, özellik listeleri, init.sh, doğrulama iş akışları) iskeletini dakikalar içinde oluşturmanıza yardımcı olabilir.
+> **Hızlı başlangıç mı?** [`skills/harness-creator/`](../../skills/harness-creator/) skill'i, kendi projeniz için üretim kalitesinde bir harness (AGENTS.md, özellik listeleri, init.sh, doğrulama iş akışları) iskeletini dakikalar içinde oluşturmanıza yardımcı olabilir.
---
diff --git a/docs-readme/uz-UZ/README.md b/docs-readme/uz-UZ/README.md
index 8fda4c1..cac0275 100644
--- a/docs-readme/uz-UZ/README.md
+++ b/docs-readme/uz-UZ/README.md
@@ -25,7 +25,7 @@ Learn Harness Engineering — KI kod yozuvchi agentlarini ishlab chiqishga bagʻ
- [Anthropic: Harness design for long-running application development](https://www.anthropic.com/engineering/harness-design-long-running-apps)
- [Awesome Harness Engineering](https://github.com/walkinglabs/awesome-harness-engineering)
-> **Tezkor boshlash?** [`skills/harness-creator/`](../../skills/) skillʼi sizga oʻz loyihangiz uchun daqiqalar ichida ishlab chiqarish darajasidagi harness (AGENTS.md, funksiya roʻyxatlari, init.sh, tekshiruv oqimlari) yaratishga yordam beradi.
+> **Tezkor boshlash?** [`skills/harness-creator/`](../../skills/harness-creator/) skillʼi sizga oʻz loyihangiz uchun daqiqalar ichida ishlab chiqarish darajasidagi harness (AGENTS.md, funksiya roʻyxatlari, init.sh, tekshiruv oqimlari) yaratishga yordam beradi.
---
diff --git a/docs-readme/vi-VN/README.md b/docs-readme/vi-VN/README.md
index fc60774..e61687b 100644
--- a/docs-readme/vi-VN/README.md
+++ b/docs-readme/vi-VN/README.md
@@ -25,7 +25,7 @@ Learn Harness Engineering là một khóa học dành riêng cho kỹ thuật li
- [Anthropic: Harness design for long-running application development](https://www.anthropic.com/engineering/harness-design-long-running-apps)
- [Awesome Harness Engineering](https://github.com/walkinglabs/awesome-harness-engineering)
-> **Bắt đầu nhanh?** Skill [`skills/harness-creator/`](../../skills/) có thể giúp bạn tạo nhanh một harness cấp sản xuất (AGENTS.md, feature lists, init.sh, quy trình kiểm chứng) cho dự án của riêng bạn chỉ trong vài phút.
+> **Bắt đầu nhanh?** Skill [`skills/harness-creator/`](../../skills/harness-creator/) có thể giúp bạn tạo nhanh một harness cấp sản xuất (AGENTS.md, feature lists, init.sh, quy trình kiểm chứng) cho dự án của riêng bạn chỉ trong vài phút.
---
diff --git a/docs-readme/zh-CN/README.md b/docs-readme/zh-CN/README.md
index 0385f9e..4759259 100644
--- a/docs-readme/zh-CN/README.md
+++ b/docs-readme/zh-CN/README.md
@@ -25,7 +25,7 @@ Learn Harness Engineering 是一门专注于 AI 编程代理工程化的课程
- [Anthropic: Harness design for long-running application development](https://www.anthropic.com/engineering/harness-design-long-running-apps)
- [Awesome Harness Engineering](https://github.com/walkinglabs/awesome-harness-engineering)
-> **快速开始?** [`skills/harness-creator/`](../../skills/) 技能可以帮助你在几分钟内为自己的项目搭建生产级别的 Harness(AGENTS.md、功能列表、init.sh、验证工作流)。
+> **快速开始?** [`skills/harness-creator/`](../../skills/harness-creator/) 技能可以帮助你在几分钟内为自己的项目搭建生产级别的 Harness(AGENTS.md、功能列表、init.sh、验证工作流)。
---
diff --git a/docs-readme/zh-TW/README.md b/docs-readme/zh-TW/README.md
index c1b1b5c..f54b309 100644
--- a/docs-readme/zh-TW/README.md
+++ b/docs-readme/zh-TW/README.md
@@ -25,7 +25,7 @@ Learn Harness Engineering 是一門專注於 AI 程式設計代理工程化的
- [Anthropic: Harness design for long-running application development](https://www.anthropic.com/engineering/harness-design-long-running-apps)
- [Awesome Harness Engineering](https://github.com/walkinglabs/awesome-harness-engineering)
-> **想快速上手?** [`skills/harness-creator/`](../../skills/) 技能可以在幾分鐘內為你自己的專案搭建一套生產級的 harness(AGENTS.md、功能列表、init.sh、驗證流程)。
+> **想快速上手?** [`skills/harness-creator/`](../../skills/harness-creator/) 技能可以在幾分鐘內為你自己的專案搭建一套生產級的 harness(AGENTS.md、功能列表、init.sh、驗證流程)。
---
diff --git a/docs/ar/skills/index.md b/docs/ar/skills/index.md
index 2a7c576..1671992 100644
--- a/docs/ar/skills/index.md
+++ b/docs/ar/skills/index.md
@@ -17,6 +17,10 @@
توجد ملفات المهارة في المستودع ضمن [`skills/harness-creator/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/skills/harness-creator).
+```bash
+npx skills add walkinglabs/learn-harness-engineering --skill harness-creator
+```
+
لاستخدامها مع Claude Code، انسخ مجلد `harness-creator/` إلى مسار المهارات في مشروعك، أو وجه الوكيل إلى ملف SKILL.md.
### أنماط مرجعية
@@ -40,6 +44,7 @@
- `feature-list.json` — JSON Schema ومثال قائمة ميزات
- `init.sh` — سكربت تهيئة قياسي
- `progress.md` — قالب سجل تقدم الجلسة
+- `session-handoff.md` — Session handoff template
### كيف بُنيت هذه المهارة
diff --git a/docs/de/skills/index.md b/docs/de/skills/index.md
index 6022b3b..4a4cf1f 100644
--- a/docs/de/skills/index.md
+++ b/docs/de/skills/index.md
@@ -17,6 +17,10 @@ Ein produktionsreifer harness-engineering-Skill für KI-Coding-Agenten. Er hilft
Die Skill-Dateien liegen im Repository unter [`skills/harness-creator/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/skills/harness-creator).
+```bash
+npx skills add walkinglabs/learn-harness-engineering --skill harness-creator
+```
+
Um ihn mit Claude Code zu verwenden, kopiere das Verzeichnis `harness-creator/` in den Skill-Pfad deines Projekts oder zeige deinen Agenten direkt auf die Datei SKILL.md.
### Referenzmuster
@@ -40,6 +44,7 @@ Der Skill enthält sofort nutzbare Vorlagen:
- `feature-list.json` — JSON Schema und Beispiel-Feature-Liste
- `init.sh` — Standard-Initialisierungsskript
- `progress.md` — Vorlage für Session-Fortschrittslogs
+- `session-handoff.md` — Session handoff template
### Wie dieser Skill gebaut wurde
diff --git a/docs/en/skills/index.md b/docs/en/skills/index.md
index 6fb1cfc..0c29457 100644
--- a/docs/en/skills/index.md
+++ b/docs/en/skills/index.md
@@ -17,6 +17,10 @@ A production-grade harness engineering skill for AI coding agents. It helps you
The skill files live in the repository at [`skills/harness-creator/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/skills/harness-creator).
+```bash
+npx skills add walkinglabs/learn-harness-engineering --skill harness-creator
+```
+
To use it with Claude Code, copy the `harness-creator/` directory into your project's skill path, or point your agent at the SKILL.md file.
### Reference Patterns
@@ -40,6 +44,7 @@ The skill bundles ready-to-use templates:
- `feature-list.json` — JSON Schema + example feature list
- `init.sh` — Standard initialization script
- `progress.md` — Session progress log template
+- `session-handoff.md` — Session handoff template
### How This Skill Was Built
diff --git a/docs/es/skills/index.md b/docs/es/skills/index.md
index 6987ddb..c1f896f 100644
--- a/docs/es/skills/index.md
+++ b/docs/es/skills/index.md
@@ -17,6 +17,10 @@ Un skill de harness engineering de nivel producción para agentes de programaci
Los archivos del skill están en el repositorio en [`skills/harness-creator/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/skills/harness-creator).
+```bash
+npx skills add walkinglabs/learn-harness-engineering --skill harness-creator
+```
+
Para usarlo con Claude Code, copia el directorio `harness-creator/` a la ruta de skills de tu proyecto, o apunta tu agente al archivo SKILL.md.
### Patrones de referencia
@@ -40,6 +44,7 @@ El skill incluye plantillas listas para usar:
- `feature-list.json` — JSON Schema y ejemplo de lista de funciones
- `init.sh` — script estándar de inicialización
- `progress.md` — plantilla de registro de progreso de sesión
+- `session-handoff.md` — Session handoff template
### Cómo se construyó este skill
diff --git a/docs/fr/skills/index.md b/docs/fr/skills/index.md
index 3ae647e..9dd6fc5 100644
--- a/docs/fr/skills/index.md
+++ b/docs/fr/skills/index.md
@@ -17,6 +17,10 @@ Un skill de harness engineering de niveau production pour agents de codage IA. I
Les fichiers du skill se trouvent dans le dépôt sous [`skills/harness-creator/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/skills/harness-creator).
+```bash
+npx skills add walkinglabs/learn-harness-engineering --skill harness-creator
+```
+
Pour l'utiliser avec Claude Code, copiez le dossier `harness-creator/` dans le chemin de skills de votre projet, ou pointez votre agent vers le fichier SKILL.md.
### Patterns de référence
@@ -40,6 +44,7 @@ Le skill fournit des modèles prêts à l'emploi :
- `feature-list.json` — JSON Schema et exemple de liste de fonctionnalités
- `init.sh` — script d'initialisation standard
- `progress.md` — modèle de journal de progression de session
+- `session-handoff.md` — Session handoff template
### Comment ce skill a été construit
diff --git a/docs/ja/skills/index.md b/docs/ja/skills/index.md
index 51283ee..cd2cc60 100644
--- a/docs/ja/skills/index.md
+++ b/docs/ja/skills/index.md
@@ -17,6 +17,10 @@ AI コーディングエージェント向けの本番級 harness engineering
スキルファイルはリポジトリの [`skills/harness-creator/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/skills/harness-creator) にあります。
+```bash
+npx skills add walkinglabs/learn-harness-engineering --skill harness-creator
+```
+
Claude Code で使う場合は、`harness-creator/` ディレクトリをプロジェクトのスキルパスにコピーするか、エージェントに SKILL.md を直接読ませます。
### 参考パターン
@@ -40,6 +44,7 @@ Claude Code で使う場合は、`harness-creator/` ディレクトリをプロ
- `feature-list.json` — JSON Schema と機能リスト例
- `init.sh` — 標準初期化スクリプト
- `progress.md` — セッション進捗ログテンプレート
+- `session-handoff.md` — Session handoff template
### このスキルの作り方
diff --git a/docs/ko/skills/index.md b/docs/ko/skills/index.md
index de69edd..ea5510f 100644
--- a/docs/ko/skills/index.md
+++ b/docs/ko/skills/index.md
@@ -17,6 +17,10 @@ AI 코딩 에이전트를 위한 프로덕션(production) 등급의 하네스
스킬 파일은 저장소의 [`skills/harness-creator/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/skills/harness-creator)에 위치합니다.
+```bash
+npx skills add walkinglabs/learn-harness-engineering --skill harness-creator
+```
+
Claude Code와 함께 사용하려면 `harness-creator/` 디렉터리를 프로젝트의 스킬 경로에 복사하거나, 에이전트가 SKILL.md 파일을 가리키도록 설정하십시오.
### 참고 패턴 (Reference Patterns)
@@ -40,6 +44,7 @@ Claude Code와 함께 사용하려면 `harness-creator/` 디렉터리를 프로
- `feature-list.json` — JSON Schema와 기능 목록 예시
- `init.sh` — 표준 초기화(initialization) 스크립트
- `progress.md` — 세션 진행 로그 템플릿
+- `session-handoff.md` — Session handoff template
### 이 스킬이 만들어진 방법 (How This Skill Was Built)
diff --git a/docs/ru/skills/index.md b/docs/ru/skills/index.md
index a374c44..41a422c 100644
--- a/docs/ru/skills/index.md
+++ b/docs/ru/skills/index.md
@@ -17,6 +17,10 @@ Production-grade скил по harness-инжинирингу для AI-аген
Файлы скила лежат в репозитории по пути [`skills/harness-creator/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/skills/harness-creator).
+```bash
+npx skills add walkinglabs/learn-harness-engineering --skill harness-creator
+```
+
Чтобы использовать его с Claude Code, скопируйте директорию `harness-creator/` в путь скилов вашего проекта или направьте агент на файл SKILL.md.
### Референсные паттерны
@@ -40,6 +44,7 @@ Production-grade скил по harness-инжинирингу для AI-аген
- `feature-list.json` — JSON Schema + пример списка фич
- `init.sh` — стандартный инициализационный скрипт
- `progress.md` — шаблон лога прогресса сессии
+- `session-handoff.md` — Session handoff template
### Как был построен этот скил
diff --git a/docs/tr/skills/index.md b/docs/tr/skills/index.md
index c8b8cf6..6168782 100644
--- a/docs/tr/skills/index.md
+++ b/docs/tr/skills/index.md
@@ -17,6 +17,10 @@ Yapay zeka kod yazma ajanları için üretim seviyesinde bir harness mühendisli
Yetenek dosyaları depoda şu adreste yer alır: [`skills/harness-creator/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/skills/harness-creator).
+```bash
+npx skills add walkinglabs/learn-harness-engineering --skill harness-creator
+```
+
Claude Code ile kullanmak için `harness-creator/` dizinini projenizin yetenek yoluna kopyalayın ya da ajanınızı SKILL.md dosyasına yönlendirin.
### Referans desenleri
@@ -40,6 +44,7 @@ Yetenek, doğrudan kullanılabilen şablonlar içerir:
- `feature-list.json` — JSON Schema + örnek özellik listesi
- `init.sh` — Standart başlatma betiği
- `progress.md` — Oturum ilerleme günlüğü şablonu
+- `session-handoff.md` — Session handoff template
### Bu yetenek nasıl geliştirildi
diff --git a/docs/uz/skills/index.md b/docs/uz/skills/index.md
index b4e1138..0f4ed20 100644
--- a/docs/uz/skills/index.md
+++ b/docs/uz/skills/index.md
@@ -17,6 +17,10 @@ AI kod yozuvchi agentlari uchun ishlab chiqarish darajasidagi (production-grade)
Koʻnikma fayllari repozitoriyning [`skills/harness-creator/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/skills/harness-creator) qismida joylashgan.
+```bash
+npx skills add walkinglabs/learn-harness-engineering --skill harness-creator
+```
+
Undan Claude Code bilan foydalanish uchun, `harness-creator/` jildini loyihangizning koʻnikmalar (skills) yoʻliga koʻchiring yoki agentingizni SKILL.md fayliga yoʻnaltiring.
### Maʼlumotnoma andozalari (Reference Patterns)
@@ -40,6 +44,7 @@ Koʻnikma oʻz ichiga foydalanishga tayyor andozalarni oladi:
- `feature-list.json` — JSON Schema + namunaviy funksiyalar roʻyxati (example feature list)
- `init.sh` — Standart inisializatsiya skripti
- `progress.md` — Sessiya jarayoni jurnali (progress log) andozasi
+- `session-handoff.md` — Session handoff template
### Ushbu koʻnikma qanday yaratilgan (How This Skill Was Built)
diff --git a/docs/vi/skills/index.md b/docs/vi/skills/index.md
index 4d9ad40..25d08a7 100644
--- a/docs/vi/skills/index.md
+++ b/docs/vi/skills/index.md
@@ -17,6 +17,10 @@ Một kỹ năng xây dựng harness cấp độ thực tế (production-grade)
Các tệp kỹ năng nằm trong kho lưu trữ tại [`skills/harness-creator/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/skills/harness-creator).
+```bash
+npx skills add walkinglabs/learn-harness-engineering --skill harness-creator
+```
+
Để sử dụng nó với Claude Code, hãy sao chép thư mục `harness-creator/` vào đường dẫn kỹ năng trong dự án của bạn, hoặc chỉ định tệp SKILL.md cho agent của bạn.
### Các Mẫu Tham Khảo (Reference Patterns)
@@ -40,6 +44,7 @@ Kỹ năng này đi kèm với các mẫu sẵn sàng sử dụng:
- `feature-list.json` — JSON Schema + danh sách tính năng mẫu
- `init.sh` — Kịch bản khởi tạo tiêu chuẩn
- `progress.md` — Mẫu nhật ký tiến độ phiên làm việc
+- `session-handoff.md` — Session handoff template
### Kỹ năng này được Xây dựng như thế nào
diff --git a/docs/zh-TW/skills/index.md b/docs/zh-TW/skills/index.md
index b1d7560..f97d7fa 100644
--- a/docs/zh-TW/skills/index.md
+++ b/docs/zh-TW/skills/index.md
@@ -17,6 +17,10 @@
技能檔案位於倉庫的 [`skills/harness-creator/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/skills/harness-creator) 目錄。
+```bash
+npx skills add walkinglabs/learn-harness-engineering --skill harness-creator
+```
+
在 Claude Code 中使用時,將 `harness-creator/` 目錄複製到你專案的技能路徑下,或讓 agent 直接讀取 SKILL.md 檔案即可。
### 參考模式
@@ -40,6 +44,7 @@
- `feature-list.json` — JSON Schema + 功能列表示例
- `init.sh` — 標準初始化腳本
- `progress.md` — 會話進度日誌範本
+- `session-handoff.md` — Session handoff template
### 開發過程
diff --git a/docs/zh/skills/index.md b/docs/zh/skills/index.md
index 8f03927..166a522 100644
--- a/docs/zh/skills/index.md
+++ b/docs/zh/skills/index.md
@@ -17,6 +17,10 @@
技能文件位于仓库的 [`skills/harness-creator/`](https://github.com/walkinglabs/learn-harness-engineering/tree/main/skills/harness-creator) 目录。
+```bash
+npx skills add walkinglabs/learn-harness-engineering --skill harness-creator
+```
+
在 Claude Code 中使用时,将 `harness-creator/` 目录复制到你项目的技能路径下,或让 agent 直接读取 SKILL.md 文件即可。
### 参考模式
@@ -40,6 +44,7 @@
- `feature-list.json` — JSON Schema + 功能列表示例
- `init.sh` — 标准初始化脚本
- `progress.md` — 会话进度日志模板
+- `session-handoff.md` — Session handoff template
### 开发过程
diff --git a/skills/harness-creator/README.md b/skills/harness-creator/README.md
index ac8db34..bced2f2 100644
--- a/skills/harness-creator/README.md
+++ b/skills/harness-creator/README.md
@@ -18,7 +18,7 @@ Production harness engineering skill for AI coding agents, distilled from Learn
## Installation
```bash
-npx skills add walkinglabs/learn-harness-engineering
+npx skills add walkinglabs/learn-harness-engineering --skill harness-creator
```
Or manually copy the `skills/harness-creator/` directory to your skill path.
@@ -78,7 +78,7 @@ User: "My agent still breaks things even with AGENTS.md"
Skill will:
1. Request current AGENTS.md content
2. Score each of 5 subsystems (1-5 scale)
-3. Identify lowest-scoring subsystem as bottleneck
+3. Identify the lowest-scoring subsystem as the highest-priority improvement area
4. Provide prioritized improvement plan with concrete steps
```
@@ -122,7 +122,7 @@ This skill does NOT cover:
- `templates/progress.md` — Session progress log template
- `templates/session-handoff.md` — Handoff structure
-## EvaluationFramework
+## Evaluation Framework
5 test cases in `evals/evals.json`:
1. **Minimal Harness Creation** — Full setup from scratch
diff --git a/skills/harness-creator/SKILL.md b/skills/harness-creator/SKILL.md
index 3149199..91d7d61 100644
--- a/skills/harness-creator/SKILL.md
+++ b/skills/harness-creator/SKILL.md
@@ -106,7 +106,7 @@ For each subsystem, score 1-5:
- **2**: Weak, incomplete, inconsistently applied
- **1**: Missing or actively harmful
-Identify the lowest-scoring subsystem — that's the bottleneck. Focus improvement efforts there first.
+Identify the lowest-scoring subsystem as the highest-priority improvement area. Treat it as a candidate bottleneck, then confirm with failure logs, verification evidence, and task outcomes before calling it the bottleneck.
### Phase 3: Design
diff --git a/skills/harness-creator/SKILL.md.en b/skills/harness-creator/SKILL.md.en
index 8767b02..131be49 100644
--- a/skills/harness-creator/SKILL.md.en
+++ b/skills/harness-creator/SKILL.md.en
@@ -78,7 +78,7 @@ For each subsystem, score 1-5:
- **2**: Weak, incomplete, inconsistently applied
- **1**: Missing or actively harmful
-Identify the lowest-scoring subsystem — that's the bottleneck. Focus improvement efforts there first.
+Identify the lowest-scoring subsystem as the highest-priority improvement area. Treat it as a candidate bottleneck, then confirm with failure logs, verification evidence, and task outcomes before calling it the bottleneck.
### Phase 3: Design
diff --git a/skills/harness-creator/references/skill-runtime-pattern.md b/skills/harness-creator/references/skill-runtime-pattern.md
new file mode 100644
index 0000000..963d98e
--- /dev/null
+++ b/skills/harness-creator/references/skill-runtime-pattern.md
@@ -0,0 +1,43 @@
+# Skill Runtime Pattern
+
+Use this pattern when you want to package reusable agent behavior as a skill instead of repeating long instructions in every repository.
+
+## What Belongs in a Skill
+
+- Reusable workflows that apply across projects.
+- Domain-specific decision procedures.
+- Templates, checklists, and reference material the agent should load on demand.
+- Small helper scripts when they are stable and safe to run.
+
+## What Does Not Belong in a Skill
+
+- Project-specific architecture facts that should live in the target repository.
+- Secrets, tokens, private URLs, or user-specific credentials.
+- Large manuals that the agent must always read before acting.
+- Commands with destructive side effects unless they are clearly documented and require explicit user approval.
+
+## Runtime Shape
+
+A production skill should use progressive disclosure:
+
+1. `SKILL.md` frontmatter explains when the skill should trigger.
+2. The body gives the shortest reliable workflow.
+3. `references/` contains deeper material loaded only when relevant.
+4. `templates/` contains copyable artifacts.
+5. `evals/` captures representative quality checks.
+
+## Design Rules
+
+- Keep the entry file concise enough to scan quickly.
+- Prefer concrete checklists over abstract advice.
+- Link every referenced bundled file and verify it exists.
+- Make installation instructions explicit about the repository, skill name, and target agent.
+- Treat scripts as optional helpers, not hidden behavior.
+
+## Validation Checklist
+
+- [ ] `SKILL.md` exists and has valid frontmatter.
+- [ ] Every referenced file exists inside the skill directory.
+- [ ] Templates are safe to copy into a target repository.
+- [ ] Installation command has been tested with `skills add --list` or equivalent.
+- [ ] The skill does not depend on private local paths.
diff --git a/skills/harness-creator/templates/session-handoff.md b/skills/harness-creator/templates/session-handoff.md
new file mode 100644
index 0000000..d9168cb
--- /dev/null
+++ b/skills/harness-creator/templates/session-handoff.md
@@ -0,0 +1,40 @@
+# Session Handoff
+
+## Current Objective
+
+- Goal:
+- Current status:
+- Branch / commit:
+
+## Completed This Session
+
+- [ ]
+
+## Verification Evidence
+
+| Check | Command | Result | Notes |
+|---|---|---|---|
+| | | | |
+
+## Files Changed
+
+-
+
+## Decisions Made
+
+-
+
+## Blockers / Risks
+
+-
+
+## Next Session Startup
+
+1. Read `AGENTS.md`.
+2. Read `feature_list.json` and `progress.md`.
+3. Review this handoff.
+4. Run `./init.sh` or the documented verification command before editing.
+
+## Recommended Next Step
+
+-