oh-my-customcode 1.1.31 → 1.1.33
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -5
- package/dist/cli/index.js +1 -1
- package/dist/index.js +1 -1
- package/package.json +1 -1
- package/templates/.claude/agents/tracker-checkpoint.md +4 -0
- package/templates/.claude/hooks/hooks.json +1 -1
- package/templates/.claude/ontology/graphs/agent-skill.json +1 -2
- package/templates/.claude/ontology/graphs/full-graph.json +0 -7
- package/templates/.claude/ontology/graphs/skill-rule.json +1 -2
- package/templates/.claude/ontology/skills.yaml +1 -10
- package/templates/.claude/rules/MAY-optimization.md +2 -0
- package/templates/.claude/rules/MUST-sync-verification.md +17 -0
- package/templates/.claude/skills/dag-orchestration/SKILL.md +4 -0
- package/templates/.claude/skills/hada-scout/SKILL.md +1 -1
- package/templates/.claude/skills/pipeline/workflows/auto-dev.yaml +6 -3
- package/templates/.claude/skills/status/SKILL.md +1 -1
- package/templates/.claude/skills/task-decomposition/SKILL.md +4 -0
- package/templates/CLAUDE.md +1 -1
- package/templates/CLAUDE.md.en +1 -1
- package/templates/CLAUDE.md.ko +1 -1
- package/templates/README.md +2 -2
- package/templates/manifest.json +2 -2
- package/templates/.claude/skills/jinja2-prompts/SKILL.md +0 -86
- package/templates/.claude/skills/peer-messaging/SKILL.md +0 -57
- package/templates/.claude/skills/sdd-development/SKILL.md +0 -24
- package/templates/.claude/skills/writing-clearly-and-concisely/SKILL.md +0 -66
package/README.md
CHANGED
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
|
|
14
14
|
**[한국어 문서 (Korean)](./README_ko.md)**
|
|
15
15
|
|
|
16
|
-
49 agents.
|
|
16
|
+
49 agents. 114 skills. 23 rules. One command.
|
|
17
17
|
|
|
18
18
|
```bash
|
|
19
19
|
npm install -g oh-my-customcode && cd your-project && omcustom init
|
|
@@ -132,7 +132,7 @@ Each agent declares its tools, model, memory scope, and limitations in YAML fron
|
|
|
132
132
|
|
|
133
133
|
---
|
|
134
134
|
|
|
135
|
-
### Skills (
|
|
135
|
+
### Skills (114)
|
|
136
136
|
|
|
137
137
|
| Category | Count | Includes |
|
|
138
138
|
|----------|-------|----------|
|
|
@@ -144,8 +144,8 @@ Each agent declares its tools, model, memory scope, and limitations in YAML fron
|
|
|
144
144
|
| Memory | 3 | memory-save, memory-recall, memory-management |
|
|
145
145
|
| Package | 3 | npm-publish, npm-version, npm-audit |
|
|
146
146
|
| Optimization | 3 | optimize-analyze, optimize-bundle, optimize-report |
|
|
147
|
-
| Security |
|
|
148
|
-
| Other |
|
|
147
|
+
| Security | 2 | adversarial-review, cve-triage |
|
|
148
|
+
| Other | 44 | claude-native, vercel-deploy, skills-sh-search, result-aggregation, and ~40 more |
|
|
149
149
|
|
|
150
150
|
Skills use a 3-tier scope system: `core` (universal), `harness` (agent/skill maintenance), `package` (project-specific).
|
|
151
151
|
|
|
@@ -270,7 +270,7 @@ your-project/
|
|
|
270
270
|
├── CLAUDE.md # Entry point
|
|
271
271
|
├── .claude/
|
|
272
272
|
│ ├── agents/ # 49 agent definitions
|
|
273
|
-
│ ├── skills/ #
|
|
273
|
+
│ ├── skills/ # 114 skill modules
|
|
274
274
|
│ ├── rules/ # 23 governance rules (R000-R023)
|
|
275
275
|
│ ├── hooks/ # 15 lifecycle hook scripts
|
|
276
276
|
│ ├── schemas/ # Tool input validation schemas
|
package/dist/cli/index.js
CHANGED
package/dist/index.js
CHANGED
package/package.json
CHANGED
|
@@ -12,6 +12,10 @@ permissionMode: bypassPermissions
|
|
|
12
12
|
|
|
13
13
|
# Tracker Checkpoint Agent
|
|
14
14
|
|
|
15
|
+
> **Soft-deprecated — 신규 사용 비권장.** 신규 DAG/오케스트레이션 작업은 네이티브 Workflow tool을 우선 사용하십시오. 위상정렬·병렬 팬아웃·재개를 플랫폼이 직접 제공합니다.
|
|
16
|
+
> 이 에이전트는 기존 파이프라인 호환을 위해 유지됩니다 — `pipeline auto-dev.yaml`과 `/fsd` 자율 루프가 의존합니다. 삭제 대상이 아니라 신규 사용만 비권장하는 상태입니다.
|
|
17
|
+
> Origin: #1474 (하네스 표면 정리 — 단계적 이행 결정).
|
|
18
|
+
|
|
15
19
|
## Purpose
|
|
16
20
|
|
|
17
21
|
Pipeline 실행 상태를 persistent checkpoint 파일로 관리. `/pipeline resume`, `dag-orchestration`, `pipeline-guards`와 협력하여 실패 후 재개를 가능하게 합니다.
|
|
@@ -263,7 +263,7 @@
|
|
|
263
263
|
},
|
|
264
264
|
{
|
|
265
265
|
"type": "prompt",
|
|
266
|
-
"prompt": "A background subagent just completed.
|
|
266
|
+
"prompt": "A background subagent just completed. If it FAILED, do NOT auto-continue \u2014 report the failure and wait for user input."
|
|
267
267
|
}
|
|
268
268
|
],
|
|
269
269
|
"description": "Record agent outcomes + auto-continue workflow on subagent completion"
|
|
@@ -354,10 +354,6 @@
|
|
|
354
354
|
"type": "Skill",
|
|
355
355
|
"class": "DeploymentSkill"
|
|
356
356
|
},
|
|
357
|
-
"writing-clearly-and-concisely": {
|
|
358
|
-
"type": "Skill",
|
|
359
|
-
"class": "WritingSkill"
|
|
360
|
-
},
|
|
361
357
|
"web-design-guidelines": {
|
|
362
358
|
"type": "Skill",
|
|
363
359
|
"class": "WritingSkill"
|
|
@@ -1469,9 +1465,6 @@
|
|
|
1469
1465
|
"status": {
|
|
1470
1466
|
"depends_on": []
|
|
1471
1467
|
},
|
|
1472
|
-
"writing-clearly-and-concisely": {
|
|
1473
|
-
"depends_on": []
|
|
1474
|
-
},
|
|
1475
1468
|
"R000": {
|
|
1476
1469
|
"referenced_by": []
|
|
1477
1470
|
},
|
|
@@ -54,7 +54,7 @@ classes:
|
|
|
54
54
|
description: "Deployment automation"
|
|
55
55
|
|
|
56
56
|
WritingSkill:
|
|
57
|
-
skills: [
|
|
57
|
+
skills: [web-design-guidelines]
|
|
58
58
|
description: "Writing quality and UI/UX guidelines"
|
|
59
59
|
|
|
60
60
|
MonitoringSkill:
|
|
@@ -533,12 +533,3 @@ skills:
|
|
|
533
533
|
summary: "UI code review guidelines for accessibility, performance, and UX best practices"
|
|
534
534
|
keywords: [ui, accessibility, ux, performance, design]
|
|
535
535
|
rule_references: []
|
|
536
|
-
|
|
537
|
-
writing-clearly-and-concisely:
|
|
538
|
-
class: WritingSkill
|
|
539
|
-
description: "Apply Strunk's timeless writing rules to ANY prose humans will read—documentation, commit messages, error messages, explanations, reports, or UI text. Makes your writing clearer, stronger, and more professional."
|
|
540
|
-
user_invocable: true
|
|
541
|
-
model_invocable: true
|
|
542
|
-
summary: "Apply Strunk's Elements of Style rules to improve clarity and conciseness in writing"
|
|
543
|
-
keywords: [writing, clarity, conciseness, elements-of-style, strunk]
|
|
544
|
-
rule_references: []
|
|
@@ -26,6 +26,8 @@
|
|
|
26
26
|
|
|
27
27
|
> **파이프 뒤 `$?`는 마지막 명령의 exit code (#1492)**: `script.sh | tail -N; echo $?`처럼 검증 스크립트를 파이프에 연결한 뒤 `$?`로 읽으면 파이프라인 **마지막 명령**(`tail`)의 종료코드를 얻는다 — 스크립트 자체가 실패(exit 1)해도 `tail`이 성공(exit 0)하면 `$?=0`으로 "통과"를 오판한다. 검증 스크립트는 파이프 없이 단독 실행하거나 `${PIPESTATUS[0]}`으로 원본 exit code를 읽는다. **주의**: `${PIPESTATUS[0]}` 자체는 R023 Workflow JS 템플릿 리터럴 이스케이프 이슈(#1438, `${...}`를 JS가 평가해 ReferenceError)와 별개 문제 — 본 항목은 셸에서 파이프 뒤 exit code를 읽는 각도다. Origin: #1492 (Session 132 회고 찐빠 #3). Cross-ref: R020 ("command executed" ≠ "succeeded").
|
|
28
28
|
|
|
29
|
+
> **계수/매칭 방법 확인 (#1521)**: 카운트를 대조하기 전에 **비교 대상이 무엇을 어떻게 세는지** 먼저 확인한다 — 같은 지표라도 계수 방법이 다르면 값이 달라진다. 대표 함정 3종: (a) glob(`ls *.md`, 최상위만) vs 재귀 `find`(하위 디렉토리 포함), (b) 부분 문자열 grep(`grep "sdd"`가 `sdd-dev`까지 매칭), (c) 확장자 필터(`--include='*.md'`가 `CLAUDE.md.en`을 미매칭). 검증 스크립트와 대조할 때는 **스크립트의 실제 계수 로직을 읽고** 같은 방법으로 센다. 위 `ls | tail` 시계열 오판(#1417)과 동류로, 도구의 기본 동작을 확인하지 않은 채 결과를 해석해 오탐에 이르는 패턴이다. Origin: #1521 (2026-07-20 세션에서 3회 반복; 두 서브에이전트가 독립적으로 동일 오탐에 도달).
|
|
30
|
+
|
|
29
31
|
<!--
|
|
30
32
|
> **v2.1.206+**: `/doctor`에 checked-in CLAUDE.md에서 코드베이스로부터 파생 가능한 내용을 잘라내도록 제안하는 체크가 추가되었습니다 — R005 "Context Optimization via HTML Comments"의 컨텍스트 절감 원칙과 정합(모델 불필요 메타데이터 축소).
|
|
31
33
|
-->
|
|
@@ -88,6 +88,23 @@ Wiki verification is also enforced by CI (`.github/workflows/wiki-sync.yml`).
|
|
|
88
88
|
|
|
89
89
|
Origin: #1512 (v1.1.28 커밋 staging에 dist/ 2파일 포함, 커밋 전 실측으로 정정; v1.1.12 dist/ untrack 회귀 방지). Cross-ref: R020 (완료 검증 — "실행됨 ≠ 성공").
|
|
90
90
|
|
|
91
|
+
### Count Sync — Exhaustive Grep, Not File Enumeration
|
|
92
|
+
|
|
93
|
+
카운트(스킬/에이전트/룰/가이드 수) 동기화는 **파일 목록 열거가 아니라 저장소 전수 grep + 의미 판별**로 수행한다. 같은 카운트가 15곳 이상에 흩어져 있어 열거식 위임은 목록에서 빠진 곳을 구조적으로 놓친다.
|
|
94
|
+
|
|
95
|
+
절차: (a) 실제 개수 실측(`ls -1d .claude/skills/*/ | wc -l` 등) → (b) 이전 값을 저장소 전역 grep → (c) 각 히트가 **카운트를 의미하는지 판별** → (d) 카운트 의미인 것만 정정.
|
|
96
|
+
|
|
97
|
+
무관한 숫자는 건드리지 않는다 — 버전번호(`v0.118.x`, CC `v2.1.118`), 이슈 번호, 과거 이력 서술("skill-count correction 114→118"), 스크립트 예시 주석은 정정 대상이 아니며 판단 근거와 함께 보고한다. grep 필터 주의: `--include='*.md'`는 `CLAUDE.md.en`/`CLAUDE.md.ko` 같은 **이중 확장자 파일을 매칭하지 못하므로**, 확장자 필터 없이 훑거나 별도 패턴을 병행한다.
|
|
98
|
+
|
|
99
|
+
| Anti-pattern | Required |
|
|
100
|
+
|--------------|----------|
|
|
101
|
+
| 카운트 동기화를 "갱신할 파일 목록" 열거로 위임 | 전수 grep으로 이전 값 히트를 모두 수집한 뒤 카운트 의미만 정정 |
|
|
102
|
+
| `--include='*.md'` 필터로 전수 grep 수행 | 확장자 필터 없이 훑거나 이중 확장자 패턴 병행 |
|
|
103
|
+
|
|
104
|
+
위임 프롬프트에는 항상 **"실측값 기준으로 동기화하라, 추측으로 숫자를 바꾸지 말라"**를 명시해, 오케스트레이터의 잘못된 전제를 서브에이전트가 정정할 여지를 남긴다(#1443).
|
|
105
|
+
|
|
106
|
+
Origin: #1521 (찐빠 #2 — v1.1.32 skills 118→114 동기화에서 파일 열거식 위임이 6곳만 갱신, CI 3곳 지적 + 전수 grep 9곳 추가 발견, 최종 15곳). Cross-ref: #1443 (실측값 기준 명시), #1287 (multi-copy 일관성).
|
|
107
|
+
|
|
91
108
|
## When Required
|
|
92
109
|
|
|
93
110
|
Any change to: agents, agent frontmatter, skills, guides, routing patterns, rules, wiki pages.
|
|
@@ -8,6 +8,10 @@ user-invocable: false
|
|
|
8
8
|
|
|
9
9
|
# DAG Orchestration Skill
|
|
10
10
|
|
|
11
|
+
> **Soft-deprecated — 신규 사용 비권장.** 신규 DAG/오케스트레이션 작업은 네이티브 Workflow tool을 우선 사용하십시오. 위상정렬·병렬 팬아웃·재개를 플랫폼이 직접 제공합니다.
|
|
12
|
+
> 이 스킬은 기존 파이프라인 호환을 위해 유지됩니다 — `pipeline auto-dev.yaml`과 `/fsd` 자율 루프가 의존합니다. 삭제 대상이 아니라 신규 사용만 비권장하는 상태입니다.
|
|
13
|
+
> Origin: #1474 (하네스 표면 정리 — 단계적 이행 결정).
|
|
14
|
+
|
|
11
15
|
Defines and executes directed acyclic graph (DAG) workflows. The orchestrator uses this skill to plan multi-step tasks with dependencies, execute them in topologically-sorted order, and handle failures.
|
|
12
16
|
|
|
13
17
|
**Orchestrator-only** — only the main conversation uses this skill (R010). Subagents execute individual nodes.
|
|
@@ -50,7 +50,7 @@ The haiku agent receives the following system prompt:
|
|
|
50
50
|
|
|
51
51
|
```
|
|
52
52
|
You are a relevance filter for the oh-my-customcode project — an AI agent harness/orchestration
|
|
53
|
-
system built on Claude Code CLI with 49 agents,
|
|
53
|
+
system built on Claude Code CLI with 49 agents, 114 skills.
|
|
54
54
|
|
|
55
55
|
Project domains (HIGH relevance):
|
|
56
56
|
- AI agent orchestration, multi-agent systems, agent design patterns
|
|
@@ -230,16 +230,19 @@ steps:
|
|
|
230
230
|
|
|
231
231
|
## Local CI-mimic verification (MUST run before marking implement done)
|
|
232
232
|
|
|
233
|
-
After all implementation tasks complete, run these scripts in sequence and halt on failure
|
|
233
|
+
After all implementation tasks complete, run these scripts in sequence and halt on failure.
|
|
234
|
+
Run each standalone (NO pipe) and read its exit code directly — `$?` after a pipe is the last command's code (R005, #1492):
|
|
234
235
|
|
|
235
236
|
1. bash .github/scripts/verify-template-sync.sh
|
|
236
237
|
2. bash .github/scripts/verify-wiki-sync.sh
|
|
238
|
+
3. bun .github/scripts/validate-docs.ts --programmatic-only
|
|
237
239
|
|
|
238
|
-
If
|
|
240
|
+
If any fails:
|
|
239
241
|
- For wiki-sync failures: delegate to wiki-curator to generate missing pages (`/omcustom:wiki ingest <path>`)
|
|
240
242
|
(Regenerating the wiki source-hash manifest targets `wiki/.source-hashes.json` ALWAYS — NEVER `templates/manifest.json`. Command: `bash .github/scripts/lib/source-hash.sh generate wiki/.source-hashes.json`. Ref #1423.)
|
|
241
243
|
- For template-sync failures: delegate to mgr-updater to sync `.claude/` -> `templates/.claude/`
|
|
242
|
-
-
|
|
244
|
+
- For validate-docs failures (count mismatch): delegate to mgr-updater to fix counts via EXHAUSTIVE grep across all docs — file-enumeration misses `.en`/`.ko` variants and secondary docs (#1521 — v1.1.32에서 validate-docs 누락으로 push 왕복 1회 발생)
|
|
245
|
+
- After fixes, re-run the scripts until all pass
|
|
243
246
|
|
|
244
247
|
This mirrors CI and prevents the known 1-2 wasted push cycles per release (ref: issue #927, v0.98.0 PR #925).
|
|
245
248
|
description: "Per-issue implementation with lifecycle, specialist routing, and CI-mimic verification"
|
|
@@ -8,6 +8,10 @@ user-invocable: false
|
|
|
8
8
|
|
|
9
9
|
# Task Decomposition Skill
|
|
10
10
|
|
|
11
|
+
> **Soft-deprecated — 신규 사용 비권장.** 신규 DAG/오케스트레이션 작업은 네이티브 Workflow tool을 우선 사용하십시오. 위상정렬·병렬 팬아웃·재개를 플랫폼이 직접 제공합니다.
|
|
12
|
+
> 이 스킬은 기존 파이프라인 호환을 위해 유지됩니다 — `pipeline auto-dev.yaml`과 `/fsd` 자율 루프가 의존합니다. 삭제 대상이 아니라 신규 사용만 비권장하는 상태입니다.
|
|
13
|
+
> Origin: #1474 (하네스 표면 정리 — 단계적 이행 결정).
|
|
14
|
+
|
|
11
15
|
Analyzes task complexity and decomposes large tasks into smaller, parallelizable subtasks compatible with the DAG orchestration skill. The orchestrator uses this as a planning frontend before execution.
|
|
12
16
|
|
|
13
17
|
## Trigger Conditions
|
package/templates/CLAUDE.md
CHANGED
|
@@ -118,7 +118,7 @@ project/
|
|
|
118
118
|
+-- CLAUDE.md # 진입점
|
|
119
119
|
+-- .claude/
|
|
120
120
|
| +-- agents/ # 서브에이전트 정의 (49 파일)
|
|
121
|
-
| +-- skills/ # 스킬 (
|
|
121
|
+
| +-- skills/ # 스킬 (114 디렉토리)
|
|
122
122
|
| +-- rules/ # 전역 규칙 (R000-R023)
|
|
123
123
|
| +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
|
|
124
124
|
| +-- contexts/ # 컨텍스트 파일 (ecomode)
|
package/templates/CLAUDE.md.en
CHANGED
|
@@ -130,7 +130,7 @@ project/
|
|
|
130
130
|
+-- CLAUDE.md # Entry point
|
|
131
131
|
+-- .claude/
|
|
132
132
|
| +-- agents/ # Subagent definitions (49 files)
|
|
133
|
-
| +-- skills/ # Skills (
|
|
133
|
+
| +-- skills/ # Skills (114 directories)
|
|
134
134
|
| +-- rules/ # Global rules (R000-R023)
|
|
135
135
|
| +-- hooks/ # Hook scripts (security, validation, HUD)
|
|
136
136
|
| +-- contexts/ # Context files (ecomode)
|
package/templates/CLAUDE.md.ko
CHANGED
|
@@ -130,7 +130,7 @@ project/
|
|
|
130
130
|
+-- CLAUDE.md # 진입점
|
|
131
131
|
+-- .claude/
|
|
132
132
|
| +-- agents/ # 서브에이전트 정의 (49 파일)
|
|
133
|
-
| +-- skills/ # 스킬 (
|
|
133
|
+
| +-- skills/ # 스킬 (114 디렉토리)
|
|
134
134
|
| +-- rules/ # 전역 규칙 (R000-R023)
|
|
135
135
|
| +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
|
|
136
136
|
| +-- contexts/ # 컨텍스트 파일 (ecomode)
|
package/templates/README.md
CHANGED
|
@@ -48,7 +48,7 @@ templates/
|
|
|
48
48
|
├── manifest.json # 배포 컴포넌트 카운트 및 메타데이터
|
|
49
49
|
├── .claude/
|
|
50
50
|
│ ├── agents/ # 에이전트 정의 파일 (*.md, 49개)
|
|
51
|
-
│ ├── skills/ # 스킬 모듈 (각 디렉토리에 SKILL.md,
|
|
51
|
+
│ ├── skills/ # 스킬 모듈 (각 디렉토리에 SKILL.md, 114개)
|
|
52
52
|
│ ├── rules/ # 전역 규칙 (R000–R023, 23개)
|
|
53
53
|
│ ├── hooks/
|
|
54
54
|
│ │ ├── hooks.json # 훅 이벤트 설정 (PreToolUse/PostToolUse 등)
|
|
@@ -86,7 +86,7 @@ CI의 `verify-template-sync.sh`가 소스와 templates/ 간 일치를 검증합
|
|
|
86
86
|
| Manager | 6 |
|
|
87
87
|
| System | 4 |
|
|
88
88
|
|
|
89
|
-
### Skills (
|
|
89
|
+
### Skills (114)
|
|
90
90
|
|
|
91
91
|
`.claude/skills/*/SKILL.md` — 재사용 가능한 스킬 모듈.
|
|
92
92
|
|
package/templates/manifest.json
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "1.1.
|
|
2
|
+
"version": "1.1.33",
|
|
3
3
|
"lastUpdated": "2026-07-14T00:00:00.000Z",
|
|
4
4
|
"omcustomMinClaudeCode": "2.1.121",
|
|
5
5
|
"omcustomMinClaudeCodeReason": "Sensitive-path direct Write/Edit on .claude/** under bypassPermissions (R010 deprecation, #1101)",
|
|
@@ -20,7 +20,7 @@
|
|
|
20
20
|
"name": "skills",
|
|
21
21
|
"path": ".claude/skills",
|
|
22
22
|
"description": "Reusable skill modules (includes slash commands)",
|
|
23
|
-
"files":
|
|
23
|
+
"files": 114
|
|
24
24
|
},
|
|
25
25
|
{
|
|
26
26
|
"name": "guides",
|
|
@@ -1,86 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: jinja2-prompts
|
|
3
|
-
description: Parameterized prompt templates using Jinja2 patterns for reusable, dynamic agent prompts
|
|
4
|
-
scope: core
|
|
5
|
-
user-invocable: false
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
# Jinja2 Prompt Templates
|
|
9
|
-
|
|
10
|
-
## Purpose
|
|
11
|
-
|
|
12
|
-
Define reusable, parameterized prompt templates for agent tasks. Templates enable consistent prompt formatting across workflows while allowing dynamic content injection.
|
|
13
|
-
|
|
14
|
-
## Template Syntax
|
|
15
|
-
|
|
16
|
-
Use Jinja2-style variable interpolation in prompt strings:
|
|
17
|
-
|
|
18
|
-
```
|
|
19
|
-
{{ variable }} — Variable substitution
|
|
20
|
-
{% if condition %}...{% endif %} — Conditional sections
|
|
21
|
-
{% for item in list %}...{% endfor %} — Iteration
|
|
22
|
-
{{ variable | default("fallback") }} — Default values
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
## Security Rules
|
|
26
|
-
|
|
27
|
-
- Templates MUST be author-written (stored in skill files), never user-supplied
|
|
28
|
-
- Use `SandboxedEnvironment` (NOT `Environment` or `from_string()` directly)
|
|
29
|
-
- No access to `env()`, `os`, `subprocess`, or any system functions
|
|
30
|
-
- Variable allowlist: only explicitly provided context variables are accessible
|
|
31
|
-
- NEVER render user-controlled strings as templates — treat them as plain data
|
|
32
|
-
|
|
33
|
-
## Template Locations
|
|
34
|
-
|
|
35
|
-
```
|
|
36
|
-
.claude/skills/<skill-name>/templates/
|
|
37
|
-
├── analysis.md.j2
|
|
38
|
-
├── report.md.j2
|
|
39
|
-
└── triage.md.j2
|
|
40
|
-
```
|
|
41
|
-
|
|
42
|
-
## Usage Pattern
|
|
43
|
-
|
|
44
|
-
```yaml
|
|
45
|
-
# In skill or workflow definition
|
|
46
|
-
template: analysis.md.j2
|
|
47
|
-
variables:
|
|
48
|
-
target: "{{ repository_url }}"
|
|
49
|
-
scope: "security"
|
|
50
|
-
depth: "comprehensive"
|
|
51
|
-
```
|
|
52
|
-
|
|
53
|
-
Rendered by orchestrator before passing to agent as prompt.
|
|
54
|
-
|
|
55
|
-
## Common Templates
|
|
56
|
-
|
|
57
|
-
### Research Team Prompt
|
|
58
|
-
|
|
59
|
-
```
|
|
60
|
-
Role: {{ domain }} {{ role }} analyst
|
|
61
|
-
Scope: {{ topic }}
|
|
62
|
-
|
|
63
|
-
Tasks:
|
|
64
|
-
{% for task in tasks %}
|
|
65
|
-
{{ loop.index }}. {{ task }}
|
|
66
|
-
{% endfor %}
|
|
67
|
-
|
|
68
|
-
Output format:
|
|
69
|
-
{{ output_format }}
|
|
70
|
-
```
|
|
71
|
-
|
|
72
|
-
### CVE Triage Prompt
|
|
73
|
-
|
|
74
|
-
```
|
|
75
|
-
Analyze {{ cve_id }} ({{ cwe_classification }})
|
|
76
|
-
Affected component: {{ component }} {{ version_range }}
|
|
77
|
-
{% if existing_mitigations %}
|
|
78
|
-
Known mitigations: {{ existing_mitigations }}
|
|
79
|
-
{% endif %}
|
|
80
|
-
```
|
|
81
|
-
|
|
82
|
-
## Integration
|
|
83
|
-
|
|
84
|
-
- Used by `/research` skill for team prompt generation
|
|
85
|
-
- Used by `cve-triage` skill for standardized analysis prompts
|
|
86
|
-
- Compatible with DAG orchestration node prompts
|
|
@@ -1,57 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: peer-messaging
|
|
3
|
-
description: Cross-session Claude Code instance messaging via claude-peers-mcp broker
|
|
4
|
-
scope: core
|
|
5
|
-
user-invocable: false
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
# Peer Messaging Skill
|
|
9
|
-
|
|
10
|
-
## Purpose
|
|
11
|
-
|
|
12
|
-
Enables cross-session coordination between multiple Claude Code instances through the claude-peers-mcp broker. Complements Agent Teams (R018, intra-session) with inter-session messaging.
|
|
13
|
-
|
|
14
|
-
## Scope Clarification
|
|
15
|
-
|
|
16
|
-
| Scope | Mechanism | Tools | Use Case |
|
|
17
|
-
|-------|-----------|-------|----------|
|
|
18
|
-
| Intra-session agents | Agent Teams (R018) | TeamCreate, SendMessage | Single session multi-agent collaboration |
|
|
19
|
-
| Cross-session instances | claude-peers-mcp | list_peers, send_message | Multi-terminal/project real-time coordination |
|
|
20
|
-
|
|
21
|
-
> **Important**: R018's `SendMessage` and claude-peers-mcp's `send_message` are different tools with different scopes. Do not confuse them.
|
|
22
|
-
|
|
23
|
-
## MCP Tool Mapping
|
|
24
|
-
|
|
25
|
-
| Tool | Purpose | oh-my-customcode Scenario |
|
|
26
|
-
|------|---------|---------------------------|
|
|
27
|
-
| `list_peers` | Discover active Claude instances | `omcustom:status` system overview |
|
|
28
|
-
| `send_message` | Send message to peer | Cross-project workflow coordination |
|
|
29
|
-
| `set_summary` | Broadcast current task summary | DAG cross-project step sync |
|
|
30
|
-
| `check_messages` | Read incoming messages | Receive coordination signals |
|
|
31
|
-
|
|
32
|
-
## Use Cases
|
|
33
|
-
|
|
34
|
-
### Multi-Project Workflow
|
|
35
|
-
Terminal A runs `auto-dev` on project-1; Terminal B works on dependent project-2. Peers coordinate via messages when blocking dependencies are resolved.
|
|
36
|
-
|
|
37
|
-
### Cross-Project QA
|
|
38
|
-
Share test infrastructure state between projects running concurrent test suites.
|
|
39
|
-
|
|
40
|
-
### DAG Bridge
|
|
41
|
-
`dag-orchestration` cross-project steps can use peer messaging for synchronization (currently impossible without this tool).
|
|
42
|
-
|
|
43
|
-
## Setup
|
|
44
|
-
|
|
45
|
-
```bash
|
|
46
|
-
# Install broker (optional MCP server)
|
|
47
|
-
npm install -g claude-peers-mcp
|
|
48
|
-
|
|
49
|
-
# Add to MCP config
|
|
50
|
-
claude mcp add claude-peers-mcp -- npx claude-peers-mcp
|
|
51
|
-
```
|
|
52
|
-
|
|
53
|
-
## Integration
|
|
54
|
-
|
|
55
|
-
- Works with R018 Agent Teams (different scope, complementary)
|
|
56
|
-
- Works with `omcustom:status` (peer discovery)
|
|
57
|
-
- Broker runs on localhost:7899 (SQLite-backed)
|
|
@@ -1,24 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: sdd-development
|
|
3
|
-
description: Alias for sdd-dev — Spec-Driven Development workflow
|
|
4
|
-
scope: core
|
|
5
|
-
version: 1.0.0
|
|
6
|
-
user-invocable: true
|
|
7
|
-
argument-hint: "[task description or leave empty for guided workflow]"
|
|
8
|
-
---
|
|
9
|
-
|
|
10
|
-
# SDD Development Skill (Alias)
|
|
11
|
-
|
|
12
|
-
This is an alias for the `sdd-dev` skill.
|
|
13
|
-
|
|
14
|
-
**Redirects to**: `.claude/skills/sdd-dev/SKILL.md`
|
|
15
|
-
|
|
16
|
-
See [sdd-dev](../sdd-dev/SKILL.md) for full documentation.
|
|
17
|
-
|
|
18
|
-
## Usage
|
|
19
|
-
|
|
20
|
-
```
|
|
21
|
-
/sdd-development [task description]
|
|
22
|
-
```
|
|
23
|
-
|
|
24
|
-
Equivalent to `/sdd-dev [task description]`.
|
|
@@ -1,66 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: writing-clearly-and-concisely
|
|
3
|
-
description: Apply Strunk's timeless writing rules to ANY prose humans will read—documentation, commit messages, error messages, explanations, reports, or UI text. Makes your writing clearer, stronger, and more professional.
|
|
4
|
-
scope: core
|
|
5
|
-
user-invocable: false
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
# Writing Clearly and Concisely
|
|
9
|
-
|
|
10
|
-
## Overview
|
|
11
|
-
|
|
12
|
-
William Strunk Jr.'s *The Elements of Style* (1918) teaches you to write clearly and cut ruthlessly.
|
|
13
|
-
|
|
14
|
-
**Source**: Internalized from `elements-of-style` plugin (superpowers-marketplace v1.0.0)
|
|
15
|
-
|
|
16
|
-
**WARNING:** The full reference (`templates/guides/elements-of-style/elements-of-style.html`) consumes ~12,000 tokens. Read it only when writing or editing prose.
|
|
17
|
-
|
|
18
|
-
## When to Use This Skill
|
|
19
|
-
|
|
20
|
-
Use this skill whenever you write prose for humans:
|
|
21
|
-
|
|
22
|
-
- Documentation, README files, technical explanations
|
|
23
|
-
- Commit messages, pull request descriptions
|
|
24
|
-
- Error messages, UI copy, help text, comments
|
|
25
|
-
- Reports, summaries, or any explanation
|
|
26
|
-
- Editing to improve clarity
|
|
27
|
-
|
|
28
|
-
**If you're writing sentences for a human to read, use this skill.**
|
|
29
|
-
|
|
30
|
-
## Limited Context Strategy
|
|
31
|
-
|
|
32
|
-
When context is tight:
|
|
33
|
-
1. Write your draft using judgment
|
|
34
|
-
2. Dispatch a subagent with your draft and the reference guide
|
|
35
|
-
3. Have the subagent copyedit and return the revision
|
|
36
|
-
|
|
37
|
-
## All Rules
|
|
38
|
-
|
|
39
|
-
### Elementary Rules of Usage (Grammar/Punctuation)
|
|
40
|
-
1. Form possessive singular by adding 's
|
|
41
|
-
2. Use comma after each term in series except last
|
|
42
|
-
3. Enclose parenthetic expressions between commas
|
|
43
|
-
4. Comma before conjunction introducing co-ordinate clause
|
|
44
|
-
5. Don't join independent clauses by comma
|
|
45
|
-
6. Don't break sentences in two
|
|
46
|
-
7. Participial phrase at beginning refers to grammatical subject
|
|
47
|
-
|
|
48
|
-
### Elementary Principles of Composition
|
|
49
|
-
8. One paragraph per topic
|
|
50
|
-
9. Begin paragraph with topic sentence
|
|
51
|
-
10. **Use active voice**
|
|
52
|
-
11. **Put statements in positive form**
|
|
53
|
-
12. **Use definite, specific, concrete language**
|
|
54
|
-
13. **Omit needless words**
|
|
55
|
-
14. Avoid succession of loose sentences
|
|
56
|
-
15. Express co-ordinate ideas in similar form
|
|
57
|
-
16. **Keep related words together**
|
|
58
|
-
17. Keep to one tense in summaries
|
|
59
|
-
18. **Place emphatic words at end of sentence**
|
|
60
|
-
|
|
61
|
-
### Section V: Words and Expressions Commonly Misused
|
|
62
|
-
Alphabetical reference for usage questions — see `templates/guides/elements-of-style/elements-of-style.html`
|
|
63
|
-
|
|
64
|
-
## Bottom Line
|
|
65
|
-
|
|
66
|
-
Writing for humans? Read the reference guide and apply the rules. Low on tokens? Dispatch a subagent to copyedit with the guide.
|