@uzysjung/agent-harness 26.156.0 → 26.157.0

package/README.ko.md

@@ -55,6 +55,17 @@ npx -y @uzysjung/agent-harness uninstall   # 무엇을 뺄지 고른다
 제거되지 않으며, 제거는 오직 이 명령에서만 일어난다. 자세한 내용은
 [uninstall](docs/USAGE.md#uninstall-v26640) 참고.
 
+### 스킬 하나만 받기 (하네스 없이)
+
+번들 스킬은 [skills CLI](https://github.com/vercel-labs/skills) 로 하나씩도 받는다 — 하네스도 트랙도 필요 없다:
+
+```bash
+npx skills add uzysjung/uzys-agent-harness --skill user-centered-explanation -a claude-code
+# 목록 보기:  npx skills add uzysjung/uzys-agent-harness --list
+```
+
+`.claude-plugin/plugin.json` 이 skills CLI 에 번들 위치(`templates/skills/`)를 알려 준다 — 하네스가 내보내는 모든 스킬의 원본이라, 설치기가 복사하는 것과 같은 파일(`references/` 포함)을 받는다. 갱신은 같은 명령을 다시 돌리면 된다. 2026-09-20 순정 `node:20` 컨테이너에서 확인. 스킬 디렉터리 페이지: [skills.sh/uzysjung/uzys-agent-harness](https://skills.sh/uzysjung/uzys-agent-harness) (설치 집계로 자동 등재되며, 리포 루트의 `skills.sh.json` 이 페이지의 묶음을 정한다).
+
 ## 왜
 
 코딩 에이전트는 계속 발전하지만, 한 번 설치한 skill 과 MCP 는 실제 사용과 무관하게 매 세션 context window 를 점유한다. awesome-list 에 수백 개의 선택지가 있어도 내 기술 스택에 맞는 항목을 찾아주지는 않는다. 결국 전부 설치해 매 세션 불필요한 비용을 치르거나, 프로젝트를 시작할 때마다 직접 목록을 확인하고 골라야 한다.
@@ -63,7 +74,7 @@ npx -y @uzysjung/agent-harness uninstall   # 무엇을 뺄지 고른다
 
 ## 무엇을 얻는가
 
-- **스택 기반 큐레이션.** 검증된 옵션 중에서 이 프로젝트에 실제로 필요한 자산만 골라 설치한다. `csr-supabase` 를 고르면 세 묶음이 미리 체크된다 — 모든 track 이 받는 4종(`north-star`·`objective-brief`·`gh-issue-workflow`·`audit-harness-fit`), 개발 track 이 받는 것들(`find-skills`·`agent-browser`·`frontend-design` + 방법론 스킬 5종), 그리고 이 스택이 필요로 하는 React·shadcn·Supabase·Postgres. 카탈로그의 나머지는 처음부터 끼어들지 않는다.
+- **스택 기반 큐레이션.** 검증된 옵션 중에서 이 프로젝트에 실제로 필요한 자산만 골라 설치한다. `csr-supabase` 를 고르면 세 묶음이 미리 체크된다 — 모든 track 이 받는 4종(`north-star`·`objective-brief`·`gh-issue-workflow`·`audit-harness-fit`), 개발 track 이 받는 것들(`find-skills`·`frontend-design` + 방법론 스킬 5종), 그리고 이 스택이 필요로 하는 React·shadcn·Supabase·Postgres. 카탈로그의 나머지는 처음부터 끼어들지 않는다.
 
 - **규율 레이어.** 실제 프로덕션 프로젝트를 에이전트로 운영하며 추출한 룰·훅·방법론 스킬·CI 스캐폴드로 구성된다. 문서 거버넌스와 검증 게이트, 작업 브리프 정규화, 재발 방지 체계를 아우르며, 특히 스킬 14종은 마켓플레이스에 의존하지 않고 이 저장소에서 직접 쓰고 관리한다. 그중 13종은 id 로 지정할 수 있다(`--with`/`--without`). 이 레이어 덕분에 단순한 skill 모음을 넘어선 하네스로 작동한다.
 

package/README.md

@@ -51,6 +51,17 @@ npx -y @uzysjung/agent-harness uninstall   # pick what to remove
 
 Run in a terminal, `uninstall` asks what to take out — item by item, or everything. It reverses what it safely can and *prints* the rest — global-scope assets, and files outside `.claude/` such as `.mcp.json` — instead of editing files that hold your own content. Unchecking something in the installer never removes it; removal only happens here. See [uninstall](docs/USAGE.md#uninstall-v26640).
 
+### One skill, without the harness
+
+Every bundled skill is also installable on its own with the [skills CLI](https://github.com/vercel-labs/skills) — no harness, no track:
+
+```bash
+npx skills add uzysjung/uzys-agent-harness --skill user-centered-explanation -a claude-code
+# see what is there:  npx skills add uzysjung/uzys-agent-harness --list
+```
+
+`.claude-plugin/plugin.json` points the skills CLI at the bundle (`templates/skills/`), the single source for every skill the harness ships — you get the same file the installer would copy, `references/` and all. Re-run the same command to refresh. Verified in a clean `node:20` container on 2026-09-20. The repo page on the skills directory: [skills.sh/uzysjung/uzys-agent-harness](https://skills.sh/uzysjung/uzys-agent-harness) (listed automatically from installs; `skills.sh.json` at the repo root groups the page).
+
 ## Why
 
 Coding agents keep getting stronger on their own. But every skill and MCP you install sits in the context window each session whether you use it or not, and the awesome-lists carry hundreds of options with no way to tell which ones your stack actually calls for. So you either install everything and pay for it every session, or read through the lists yourself each time you start a project.
@@ -59,7 +70,7 @@ This tool starts from the stack instead. You pick a track, and it pre-checks the
 
 ## What you get
 
-- **Curation by tech stack.** Of the vetted options, you install only what this project calls for. Pick `csr-supabase` and step 3 pre-checks three groups: the four that every track gets (`north-star`, `objective-brief`, `gh-issue-workflow`, `audit-harness-fit`), the dev-track set (`find-skills`, `agent-browser`, `frontend-design`, and the five method skills), and the ones this stack calls for — React, shadcn, Supabase, Postgres. Not the rest of the catalog.
+- **Curation by tech stack.** Of the vetted options, you install only what this project calls for. Pick `csr-supabase` and step 3 pre-checks three groups: the four that every track gets (`north-star`, `objective-brief`, `gh-issue-workflow`, `audit-harness-fit`), the dev-track set (`find-skills`, `frontend-design`, and the five method skills), and the ones this stack calls for — React, shadcn, Supabase, Postgres. Not the rest of the catalog.
 
 - **A discipline layer.** Rules, hooks, method skills, and CI scaffolds distilled from running real production projects with agents: doc governance, verification gates, normalized task briefs, recurrence prevention. Fourteen of those skills are written and maintained in this repo rather than pulled from a marketplace — thirteen of them selectable by id with `--with` / `--without` — so the harness ships the method, not just a pointer to one. This layer is what makes it a harness rather than a skill pack.
 

package/dist/{chunk-PPJUFG53.js → chunk-HHCNPPGS.js}

@@ -626,7 +626,10 @@ var EXTERNAL_ASSETS = [
     // v26.78.0 — Understanding 으로 재분류: 웹 지각(screenshot·DOM). 영상/코드 지각과 같은 축.
     category: "understanding",
     source: "vercel-labs",
-    condition: { kind: "any-track", tracks: DEV_TRACKS_WITH_STACK },
+    // #489 (사용자 결정 2026-09-20 a) — 기본 체크에서 opt-in 으로. computer-use 가 같은 일을 하고,
+    // 셋 중 설치 비용이 가장 크다(npm devDep → 안 쓰는 프로젝트에 node_modules 만 남는다).
+    // 3단계에는 그대로 뜨되 체크 해제, `--with agent-browser` 로 켠다. 기존 설치본은 영향 없음.
+    condition: { kind: "opt-in" },
     method: { kind: "npm", pkg: "agent-browser", version: "0.31.0" }
   },
   // v26.78.0 — Understanding 신규 3종 (plugin, opt-in). 에이전트 인지 증강: 영상·코드 지각 + 메모리.
@@ -2186,4 +2189,4 @@ export {
   CATEGORIES,
   CATEGORY_TITLES
 };
-//# sourceMappingURL=chunk-PPJUFG53.js.map
+//# sourceMappingURL=chunk-HHCNPPGS.js.map