🎩 You're Invited:Meet the Socket team at Black Hat in Las Vegas, August 3-6.RSVP →
oh-my-customcode
Advanced tools
oh-my-customcode - npm Package Compare versions
+1
-1
@@ -6,3 +6,3 @@ { | ||
| ], | ||
| "version": "1.1.30", | ||
| "version": "1.1.33", | ||
| "description": "Batteries-included agent harness for Claude Code", | ||
@@ -9,0 +9,0 @@ "type": "module", |
+5
-5
@@ -16,3 +16,3 @@ <div align="center"> | ||
| 49 agents. 118 skills. 23 rules. One command. | ||
| 49 agents. 114 skills. 23 rules. One command. | ||
@@ -136,3 +136,3 @@ ```bash | ||
| ### Skills (118) | ||
| ### Skills (114) | ||
@@ -149,4 +149,4 @@ | Category | Count | Includes | | ||
| | Optimization | 3 | optimize-analyze, optimize-bundle, optimize-report | | ||
| | Security | 3 | adversarial-review, cve-triage, jinja2-prompts | | ||
| | Other | 47 | claude-native, vercel-deploy, skills-sh-search, result-aggregation, writing-clearly-and-concisely, and ~40 more | | ||
| | Security | 2 | adversarial-review, cve-triage | | ||
| | Other | 44 | claude-native, vercel-deploy, skills-sh-search, result-aggregation, and ~40 more | | ||
@@ -276,3 +276,3 @@ Skills use a 3-tier scope system: `core` (universal), `harness` (agent/skill maintenance), `package` (project-specific). | ||
| │ ├── agents/ # 49 agent definitions | ||
| │ ├── skills/ # 118 skill modules | ||
| │ ├── skills/ # 114 skill modules | ||
| │ ├── rules/ # 23 governance rules (R000-R023) | ||
@@ -279,0 +279,0 @@ │ ├── hooks/ # 15 lifecycle hook scripts |
@@ -15,2 +15,6 @@ --- | ||
| > **Soft-deprecated — 신규 사용 비권장.** 신규 DAG/오케스트레이션 작업은 네이티브 Workflow tool을 우선 사용하십시오. 위상정렬·병렬 팬아웃·재개를 플랫폼이 직접 제공합니다. | ||
| > 이 에이전트는 기존 파이프라인 호환을 위해 유지됩니다 — `pipeline auto-dev.yaml`과 `/fsd` 자율 루프가 의존합니다. 삭제 대상이 아니라 신규 사용만 비권장하는 상태입니다. | ||
| > Origin: #1474 (하네스 표면 정리 — 단계적 이행 결정). | ||
| ## Purpose | ||
@@ -17,0 +21,0 @@ |
@@ -266,3 +266,3 @@ { | ||
| "type": "prompt", | ||
| "prompt": "A background subagent just completed. Check if there are pending workflow steps that depend on this result. If the previous subagent FAILED, do NOT auto-continue \u2014 report the failure and wait for user input. If the previous step succeeded and there are pending steps, proceed automatically. If no pending steps, report results and wait. Safety: The file /tmp/.claude-loop-count-$PPID tracks auto-continue count. After 3 consecutive auto-continues without user interaction, pause and ask the user before proceeding." | ||
| "prompt": "A background subagent just completed. If it FAILED, do NOT auto-continue \u2014 report the failure and wait for user input." | ||
| } | ||
@@ -269,0 +269,0 @@ ], |
@@ -228,4 +228,3 @@ { | ||
| "result-aggregation": [], | ||
| "status": [], | ||
| "writing-clearly-and-concisely": [] | ||
| "status": [] | ||
| }, | ||
@@ -232,0 +231,0 @@ "nodes": [], |
@@ -357,6 +357,2 @@ { | ||
| }, | ||
| "writing-clearly-and-concisely": { | ||
| "type": "Skill", | ||
| "class": "WritingSkill" | ||
| }, | ||
| "web-design-guidelines": { | ||
@@ -1473,5 +1469,2 @@ "type": "Skill", | ||
| }, | ||
| "writing-clearly-and-concisely": { | ||
| "depends_on": [] | ||
| }, | ||
| "R000": { | ||
@@ -1478,0 +1471,0 @@ "referenced_by": [] |
@@ -61,4 +61,3 @@ { | ||
| "vercel-deploy": [], | ||
| "web-design-guidelines": [], | ||
| "writing-clearly-and-concisely": [] | ||
| "web-design-guidelines": [] | ||
| }, | ||
@@ -65,0 +64,0 @@ "reverse": { |
@@ -57,3 +57,3 @@ # Auto-generated from templates/.claude/skills/ | ||
| WritingSkill: | ||
| skills: [writing-clearly-and-concisely, web-design-guidelines] | ||
| skills: [web-design-guidelines] | ||
| description: "Writing quality and UI/UX guidelines" | ||
@@ -537,10 +537,1 @@ | ||
| rule_references: [] | ||
| writing-clearly-and-concisely: | ||
| class: WritingSkill | ||
| 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." | ||
| user_invocable: true | ||
| model_invocable: true | ||
| summary: "Apply Strunk's Elements of Style rules to improve clarity and conciseness in writing" | ||
| keywords: [writing, clarity, conciseness, elements-of-style, strunk] | ||
| rule_references: [] |
@@ -29,2 +29,4 @@ # [MAY] Optimization Guide | ||
| > **계수/매칭 방법 확인 (#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회 반복; 두 서브에이전트가 독립적으로 동일 오탐에 도달). | ||
| <!-- | ||
@@ -31,0 +33,0 @@ > **v2.1.206+**: `/doctor`에 checked-in CLAUDE.md에서 코드베이스로부터 파생 가능한 내용을 잘라내도록 제안하는 체크가 추가되었습니다 — R005 "Context Optimization via HTML Comments"의 컨텍스트 절감 원칙과 정합(모델 불필요 메타데이터 축소). |
@@ -76,3 +76,3 @@ # [MUST] Completion Verification Rules | ||
| 구조 검증(mgr-sauron R017)·판정·품질 게이트를 서브에이전트에 위임할 때, 위임 프롬프트에 **"최종 PASS/FAIL 판정 없이 turn을 종료하지 말라"**를 명시한다 — 단 이 clause는 **보조 수단**일 뿐 1차 방어선이 아니다. clause를 명시해도 mid-step 종료가 5회 재발했다(v1.1.13/14/17/18/19, 아래 Origin 참조). **1차 방어선은 오케스트레이터의 직접 ground-truth 실측**이다. | ||
| 구조 검증(mgr-sauron R017)·판정·품질 게이트를 서브에이전트에 위임할 때, 위임 프롬프트에 **"최종 PASS/FAIL 판정 없이 turn을 종료하지 말라"**를 명시한다 — 단 이 clause는 **보조 수단**일 뿐 1차 방어선이 아니다. clause를 명시해도 mid-step 종료가 **누적 11회** 재발했다(v1.1.13/14/17/18/19 … v1.1.30, 아래 Origin 참조). **1차 방어선은 오케스트레이터의 직접 ground-truth 실측**이다. | ||
@@ -87,3 +87,3 @@ mid-step 종료는 예상 가능한 정상 실패 모드로 취급한다 — 발생 시 즉시 ground-truth를 실측해 실제 진행 상태를 확인한다. **증상만으로 결과를 넘겨짚지 않는다**: 같은 "...중" 한 줄 종료라도 실측 결과는 다를 수 있다(예: "merging now" 후 종료 → 실측 시 PR 이미 MERGED, resume 불필요 / "CI 실행 중" 후 종료 → 실측 시 PR OPEN 미머지, resume 필요). 미완이면 SendMessage로 resume하되, 오케스트레이터가 실측한 값(예: "CI 전부 통과, mergeStateStatus=CLEAN")을 resume 메시지에 동봉해 에이전트가 재폴링 후 재종료하는 루프를 끊는다. | ||
| Origin: #1443 (Session 126 회고 찐빠 #1) — v1.1.3 R017 검증에서 mgr-sauron이 source-hash 대조 중 판정 없이 종료 → resume 후 PASS. v1.1.4에서 "판정 반드시 출력" 명시로 1회 완료(대조 실증). **5회 재발 확인(#1492, Session 132)**: v1.1.13/14/17(clause 명시에도 재발) → v1.1.18(완료조건 6항목+종료금지 명시에도 "merging now" 한 줄 남기고 종료, 실측 결과 이미 완료) → v1.1.19(위임 프롬프트에 "4회 무시됨"까지 명시했으나 "CI 실행 중" 한 줄 남기고 종료, 실측 결과 미완료). Session 132에서 2회 모두 오케스트레이터 직접 실측으로 복구 — clause 강화가 아니라 실측 습관화가 유일하게 실증된 방어선. | ||
| Origin: #1443 (Session 126 회고 찐빠 #1) — v1.1.3 R017 검증에서 mgr-sauron이 source-hash 대조 중 판정 없이 종료 → resume 후 PASS. v1.1.4에서 "판정 반드시 출력" 명시로 1회 완료(대조 실증). **5회 재발 확인(#1492, Session 132)**: v1.1.13/14/17(clause 명시에도 재발) → v1.1.18(완료조건 6항목+종료금지 명시에도 "merging now" 한 줄 남기고 종료, 실측 결과 이미 완료) → v1.1.19(위임 프롬프트에 "4회 무시됨"까지 명시했으나 "CI 실행 중" 한 줄 남기고 종료, 실측 결과 미완료). Session 132에서 2회 모두 오케스트레이터 직접 실측으로 복구 — clause 강화가 아니라 실측 습관화가 유일하게 실증된 방어선. **누적 11회 확인(#1518 찐빠 #2, Session 136)**: v1.1.30 릴리즈 세션에서도 "완료 조건 5항목 실측 + 판정 없이 종료 금지" 명시에도 mgr-gitnerd가 "폴링 완료 통지를 기다리겠습니다" 한 줄만 남기고 종료 → 오케스트레이터 직접 실측으로 복구(lockfile push 완료 / CI pending / PR OPEN); 이번엔 "대기 중" 증상이 실제 미완료였고 Session 132의 "머지 중" 증상은 실제 완료였다는 대비로 증상→결과 추론 금지가 재확인됨. | ||
@@ -90,0 +90,0 @@ Cross-reference: R018 (Member Completion Verification), `feedback_release_delegation_phasing`, `feedback_orchestrator_direct_verify` (release delegation phasing을 verification 위임에도 확장). |
@@ -283,2 +283,14 @@ # [MUST] Orchestrator Coordination Rules | ||
| ### Parallel Delegation — Sibling-Agent Disclosure | ||
| 2개 이상의 서브에이전트를 같은 메시지에서 병렬 스폰할 때, 각 위임 프롬프트는 **형제 에이전트의 존재와 각자의 담당 범위**를 고지해야 한다. 서브에이전트는 격리된 컨텍스트에서 실행되어 형제를 인지할 수 없으므로, 고지가 없으면 `git status` 같은 **저장소 전역 공유 뷰**의 출력을 자기 변경분으로 오독하거나 경합 원인을 "외부 세션/프로세스"로 오귀속한다. | ||
| 고지에 포함할 것: 동시 실행 에이전트 수, 각 에이전트의 담당 파일/영역, 그리고 "공유 뷰에 타 에이전트 변경분이 함께 보이므로 **자기 담당 범위만 기준으로 보고**하라"는 지시. | ||
| | Anti-pattern | Required | | ||
| |--------------|----------| | ||
| | 병렬 스폰 프롬프트에 형제 에이전트 고지 없이 위임 → 공유 뷰 출력을 오독하거나 원인을 "외부 프로세스"로 오귀속 | 각 프롬프트에 동시 실행 에이전트 수 + 각자 담당 범위 + "자기 담당 범위만 기준으로 보고" 지시 명시 | | ||
| > Origin: #1518 (찐빠 #3 — 미고지 git 에이전트가 형제를 "외부 프로세스"로 오귀속; 같은 세션에서 고지한 4개 구현 에이전트는 전원 정확히 구분 보고 — 대조 실증). Cross-ref: R009 (병렬 실행 조건). | ||
| ## Universal bypassPermissions | ||
@@ -285,0 +297,0 @@ |
@@ -18,2 +18,12 @@ # [MUST] Parallel Execution Rules | ||
| ### File-Disjoint ≠ Independent (Local Git State) | ||
| 로컬 git 상태를 변경하는 작업(`checkout` / `pull` / `branch` 생성·삭제·rename / `commit` / `stash` / `merge` / `rebase`)은 편집 대상 파일이 disjoint하더라도 **워킹트리·브랜치 포인터·인덱스·HEAD**라는 프로세스 수준 단일 공유 가변 상태를 경합하므로 **직렬화**한다. 실무 규칙: **동시 실행하는 git 상태변경 에이전트는 1개**. git 단계를 먼저 직렬로 끝낸 뒤 나머지를 병렬화한다. read-only 조회(`git status`/`log`/`diff`, `gh` 조회)는 병렬 가능 — 제한 대상은 상태 변경뿐이다. | ||
| | Anti-pattern | Required | | ||
| |--------------|----------| | ||
| | 편집 파일이 disjoint하다는 이유로 git 상태변경 에이전트 2개 이상을 병렬 스폰 | git 상태변경은 동시 1개로 직렬화; 완료 후 나머지 작업 병렬화 | | ||
| Origin: #1518 (찐빠 #1 — git 에이전트 2개 근접 실행으로 작업 브랜치 stale; 편집 파일은 disjoint였음). | ||
| ## Agent Teams Gate (R018) | ||
@@ -20,0 +30,0 @@ |
@@ -91,2 +91,19 @@ # [MUST] Sync Verification Rules | ||
| ### Count Sync — Exhaustive Grep, Not File Enumeration | ||
| 카운트(스킬/에이전트/룰/가이드 수) 동기화는 **파일 목록 열거가 아니라 저장소 전수 grep + 의미 판별**로 수행한다. 같은 카운트가 15곳 이상에 흩어져 있어 열거식 위임은 목록에서 빠진 곳을 구조적으로 놓친다. | ||
| 절차: (a) 실제 개수 실측(`ls -1d .claude/skills/*/ | wc -l` 등) → (b) 이전 값을 저장소 전역 grep → (c) 각 히트가 **카운트를 의미하는지 판별** → (d) 카운트 의미인 것만 정정. | ||
| 무관한 숫자는 건드리지 않는다 — 버전번호(`v0.118.x`, CC `v2.1.118`), 이슈 번호, 과거 이력 서술("skill-count correction 114→118"), 스크립트 예시 주석은 정정 대상이 아니며 판단 근거와 함께 보고한다. grep 필터 주의: `--include='*.md'`는 `CLAUDE.md.en`/`CLAUDE.md.ko` 같은 **이중 확장자 파일을 매칭하지 못하므로**, 확장자 필터 없이 훑거나 별도 패턴을 병행한다. | ||
| | Anti-pattern | Required | | ||
| |--------------|----------| | ||
| | 카운트 동기화를 "갱신할 파일 목록" 열거로 위임 | 전수 grep으로 이전 값 히트를 모두 수집한 뒤 카운트 의미만 정정 | | ||
| | `--include='*.md'` 필터로 전수 grep 수행 | 확장자 필터 없이 훑거나 이중 확장자 패턴 병행 | | ||
| 위임 프롬프트에는 항상 **"실측값 기준으로 동기화하라, 추측으로 숫자를 바꾸지 말라"**를 명시해, 오케스트레이터의 잘못된 전제를 서브에이전트가 정정할 여지를 남긴다(#1443). | ||
| Origin: #1521 (찐빠 #2 — v1.1.32 skills 118→114 동기화에서 파일 열거식 위임이 6곳만 갱신, CI 3곳 지적 + 전수 grep 9곳 추가 발견, 최종 15곳). Cross-ref: #1443 (실측값 기준 명시), #1287 (multi-copy 일관성). | ||
| ## When Required | ||
@@ -93,0 +110,0 @@ |
@@ -11,2 +11,6 @@ --- | ||
| > **Soft-deprecated — 신규 사용 비권장.** 신규 DAG/오케스트레이션 작업은 네이티브 Workflow tool을 우선 사용하십시오. 위상정렬·병렬 팬아웃·재개를 플랫폼이 직접 제공합니다. | ||
| > 이 스킬은 기존 파이프라인 호환을 위해 유지됩니다 — `pipeline auto-dev.yaml`과 `/fsd` 자율 루프가 의존합니다. 삭제 대상이 아니라 신규 사용만 비권장하는 상태입니다. | ||
| > Origin: #1474 (하네스 표면 정리 — 단계적 이행 결정). | ||
| 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. | ||
@@ -13,0 +17,0 @@ |
@@ -53,3 +53,3 @@ --- | ||
| You are a relevance filter for the oh-my-customcode project — an AI agent harness/orchestration | ||
| system built on Claude Code CLI with 49 agents, 118 skills. | ||
| system built on Claude Code CLI with 49 agents, 114 skills. | ||
@@ -56,0 +56,0 @@ Project domains (HIGH relevance): |
@@ -233,12 +233,15 @@ name: auto-dev | ||
| After all implementation tasks complete, run these scripts in sequence and halt on failure: | ||
| After all implementation tasks complete, run these scripts in sequence and halt on failure. | ||
| Run each standalone (NO pipe) and read its exit code directly — `$?` after a pipe is the last command's code (R005, #1492): | ||
| 1. bash .github/scripts/verify-template-sync.sh | ||
| 2. bash .github/scripts/verify-wiki-sync.sh | ||
| 3. bun .github/scripts/validate-docs.ts --programmatic-only | ||
| If either fails: | ||
| If any fails: | ||
| - For wiki-sync failures: delegate to wiki-curator to generate missing pages (`/omcustom:wiki ingest <path>`) | ||
| (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.) | ||
| - For template-sync failures: delegate to mgr-updater to sync `.claude/` -> `templates/.claude/` | ||
| - After fixes, re-run the scripts until both pass | ||
| - 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회 발생) | ||
| - After fixes, re-run the scripts until all pass | ||
@@ -245,0 +248,0 @@ This mirrors CI and prevents the known 1-2 wasted push cycles per release (ref: issue #927, v0.98.0 PR #925). |
@@ -39,3 +39,3 @@ --- | ||
| Skills: | ||
| Total: 118 skills | ||
| Total: 114 skills | ||
@@ -42,0 +42,0 @@ Guides: 56 loaded |
@@ -11,2 +11,6 @@ --- | ||
| > **Soft-deprecated — 신규 사용 비권장.** 신규 DAG/오케스트레이션 작업은 네이티브 Workflow tool을 우선 사용하십시오. 위상정렬·병렬 팬아웃·재개를 플랫폼이 직접 제공합니다. | ||
| > 이 스킬은 기존 파이프라인 호환을 위해 유지됩니다 — `pipeline auto-dev.yaml`과 `/fsd` 자율 루프가 의존합니다. 삭제 대상이 아니라 신규 사용만 비권장하는 상태입니다. | ||
| > Origin: #1474 (하네스 표면 정리 — 단계적 이행 결정). | ||
| 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. | ||
@@ -13,0 +17,0 @@ |
@@ -121,3 +121,3 @@ <!-- omcustom:start --> | ||
| | +-- agents/ # 서브에이전트 정의 (49 파일) | ||
| | +-- skills/ # 스킬 (118 디렉토리) | ||
| | +-- skills/ # 스킬 (114 디렉토리) | ||
| | +-- rules/ # 전역 규칙 (R000-R023) | ||
@@ -124,0 +124,0 @@ | +-- hooks/ # 훅 스크립트 (보안, 검증, HUD) |
| { | ||
| "version": "1.1.30", | ||
| "version": "1.1.33", | ||
| "lastUpdated": "2026-07-14T00:00:00.000Z", | ||
@@ -23,3 +23,3 @@ "omcustomMinClaudeCode": "2.1.121", | ||
| "description": "Reusable skill modules (includes slash commands)", | ||
| "files": 118 | ||
| "files": 114 | ||
| }, | ||
@@ -26,0 +26,0 @@ { |
@@ -51,3 +51,3 @@ # templates/ | ||
| │ ├── agents/ # 에이전트 정의 파일 (*.md, 49개) | ||
| │ ├── skills/ # 스킬 모듈 (각 디렉토리에 SKILL.md, 118개) | ||
| │ ├── skills/ # 스킬 모듈 (각 디렉토리에 SKILL.md, 114개) | ||
| │ ├── rules/ # 전역 규칙 (R000–R023, 23개) | ||
@@ -90,3 +90,3 @@ │ ├── hooks/ | ||
| ### Skills (118) | ||
| ### Skills (114) | ||
@@ -93,0 +93,0 @@ `.claude/skills/*/SKILL.md` — 재사용 가능한 스킬 모듈. |
| --- | ||
| name: jinja2-prompts | ||
| description: Parameterized prompt templates using Jinja2 patterns for reusable, dynamic agent prompts | ||
| scope: core | ||
| user-invocable: false | ||
| --- | ||
| # Jinja2 Prompt Templates | ||
| ## Purpose | ||
| Define reusable, parameterized prompt templates for agent tasks. Templates enable consistent prompt formatting across workflows while allowing dynamic content injection. | ||
| ## Template Syntax | ||
| Use Jinja2-style variable interpolation in prompt strings: | ||
| ``` | ||
| {{ variable }} — Variable substitution | ||
| {% if condition %}...{% endif %} — Conditional sections | ||
| {% for item in list %}...{% endfor %} — Iteration | ||
| {{ variable | default("fallback") }} — Default values | ||
| ``` | ||
| ## Security Rules | ||
| - Templates MUST be author-written (stored in skill files), never user-supplied | ||
| - Use `SandboxedEnvironment` (NOT `Environment` or `from_string()` directly) | ||
| - No access to `env()`, `os`, `subprocess`, or any system functions | ||
| - Variable allowlist: only explicitly provided context variables are accessible | ||
| - NEVER render user-controlled strings as templates — treat them as plain data | ||
| ## Template Locations | ||
| ``` | ||
| .claude/skills/<skill-name>/templates/ | ||
| ├── analysis.md.j2 | ||
| ├── report.md.j2 | ||
| └── triage.md.j2 | ||
| ``` | ||
| ## Usage Pattern | ||
| ```yaml | ||
| # In skill or workflow definition | ||
| template: analysis.md.j2 | ||
| variables: | ||
| target: "{{ repository_url }}" | ||
| scope: "security" | ||
| depth: "comprehensive" | ||
| ``` | ||
| Rendered by orchestrator before passing to agent as prompt. | ||
| ## Common Templates | ||
| ### Research Team Prompt | ||
| ``` | ||
| Role: {{ domain }} {{ role }} analyst | ||
| Scope: {{ topic }} | ||
| Tasks: | ||
| {% for task in tasks %} | ||
| {{ loop.index }}. {{ task }} | ||
| {% endfor %} | ||
| Output format: | ||
| {{ output_format }} | ||
| ``` | ||
| ### CVE Triage Prompt | ||
| ``` | ||
| Analyze {{ cve_id }} ({{ cwe_classification }}) | ||
| Affected component: {{ component }} {{ version_range }} | ||
| {% if existing_mitigations %} | ||
| Known mitigations: {{ existing_mitigations }} | ||
| {% endif %} | ||
| ``` | ||
| ## Integration | ||
| - Used by `/research` skill for team prompt generation | ||
| - Used by `cve-triage` skill for standardized analysis prompts | ||
| - Compatible with DAG orchestration node prompts |
| --- | ||
| name: peer-messaging | ||
| description: Cross-session Claude Code instance messaging via claude-peers-mcp broker | ||
| scope: core | ||
| user-invocable: false | ||
| --- | ||
| # Peer Messaging Skill | ||
| ## Purpose | ||
| 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. | ||
| ## Scope Clarification | ||
| | Scope | Mechanism | Tools | Use Case | | ||
| |-------|-----------|-------|----------| | ||
| | Intra-session agents | Agent Teams (R018) | TeamCreate, SendMessage | Single session multi-agent collaboration | | ||
| | Cross-session instances | claude-peers-mcp | list_peers, send_message | Multi-terminal/project real-time coordination | | ||
| > **Important**: R018's `SendMessage` and claude-peers-mcp's `send_message` are different tools with different scopes. Do not confuse them. | ||
| ## MCP Tool Mapping | ||
| | Tool | Purpose | oh-my-customcode Scenario | | ||
| |------|---------|---------------------------| | ||
| | `list_peers` | Discover active Claude instances | `omcustom:status` system overview | | ||
| | `send_message` | Send message to peer | Cross-project workflow coordination | | ||
| | `set_summary` | Broadcast current task summary | DAG cross-project step sync | | ||
| | `check_messages` | Read incoming messages | Receive coordination signals | | ||
| ## Use Cases | ||
| ### Multi-Project Workflow | ||
| Terminal A runs `auto-dev` on project-1; Terminal B works on dependent project-2. Peers coordinate via messages when blocking dependencies are resolved. | ||
| ### Cross-Project QA | ||
| Share test infrastructure state between projects running concurrent test suites. | ||
| ### DAG Bridge | ||
| `dag-orchestration` cross-project steps can use peer messaging for synchronization (currently impossible without this tool). | ||
| ## Setup | ||
| ```bash | ||
| # Install broker (optional MCP server) | ||
| npm install -g claude-peers-mcp | ||
| # Add to MCP config | ||
| claude mcp add claude-peers-mcp -- npx claude-peers-mcp | ||
| ``` | ||
| ## Integration | ||
| - Works with R018 Agent Teams (different scope, complementary) | ||
| - Works with `omcustom:status` (peer discovery) | ||
| - Broker runs on localhost:7899 (SQLite-backed) |
| --- | ||
| name: sdd-development | ||
| description: Alias for sdd-dev — Spec-Driven Development workflow | ||
| scope: core | ||
| version: 1.0.0 | ||
| user-invocable: true | ||
| argument-hint: "[task description or leave empty for guided workflow]" | ||
| --- | ||
| # SDD Development Skill (Alias) | ||
| This is an alias for the `sdd-dev` skill. | ||
| **Redirects to**: `.claude/skills/sdd-dev/SKILL.md` | ||
| See [sdd-dev](../sdd-dev/SKILL.md) for full documentation. | ||
| ## Usage | ||
| ``` | ||
| /sdd-development [task description] | ||
| ``` | ||
| Equivalent to `/sdd-dev [task description]`. |
| --- | ||
| name: writing-clearly-and-concisely | ||
| 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. | ||
| scope: core | ||
| user-invocable: false | ||
| --- | ||
| # Writing Clearly and Concisely | ||
| ## Overview | ||
| William Strunk Jr.'s *The Elements of Style* (1918) teaches you to write clearly and cut ruthlessly. | ||
| **Source**: Internalized from `elements-of-style` plugin (superpowers-marketplace v1.0.0) | ||
| **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. | ||
| ## When to Use This Skill | ||
| Use this skill whenever you write prose for humans: | ||
| - Documentation, README files, technical explanations | ||
| - Commit messages, pull request descriptions | ||
| - Error messages, UI copy, help text, comments | ||
| - Reports, summaries, or any explanation | ||
| - Editing to improve clarity | ||
| **If you're writing sentences for a human to read, use this skill.** | ||
| ## Limited Context Strategy | ||
| When context is tight: | ||
| 1. Write your draft using judgment | ||
| 2. Dispatch a subagent with your draft and the reference guide | ||
| 3. Have the subagent copyedit and return the revision | ||
| ## All Rules | ||
| ### Elementary Rules of Usage (Grammar/Punctuation) | ||
| 1. Form possessive singular by adding 's | ||
| 2. Use comma after each term in series except last | ||
| 3. Enclose parenthetic expressions between commas | ||
| 4. Comma before conjunction introducing co-ordinate clause | ||
| 5. Don't join independent clauses by comma | ||
| 6. Don't break sentences in two | ||
| 7. Participial phrase at beginning refers to grammatical subject | ||
| ### Elementary Principles of Composition | ||
| 8. One paragraph per topic | ||
| 9. Begin paragraph with topic sentence | ||
| 10. **Use active voice** | ||
| 11. **Put statements in positive form** | ||
| 12. **Use definite, specific, concrete language** | ||
| 13. **Omit needless words** | ||
| 14. Avoid succession of loose sentences | ||
| 15. Express co-ordinate ideas in similar form | ||
| 16. **Keep related words together** | ||
| 17. Keep to one tense in summaries | ||
| 18. **Place emphatic words at end of sentence** | ||
| ### Section V: Words and Expressions Commonly Misused | ||
| Alphabetical reference for usage questions — see `templates/guides/elements-of-style/elements-of-style.html` | ||
| ## Bottom Line | ||
| Writing for humans? Read the reference guide and apply the rules. Low on tokens? Dispatch a subagent to copyedit with the guide. |
Sorry, the diff of this file is too big to display
Sorry, the diff of this file is too big to display
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
New alerts
AI-detected potential malware
Supply chain riskAI has identified this package as malware. This is a strong signal that the package may be malicious.
Worsened metrics
- Total package byte prevSize
3671178
-0.02%- Number of package files
412
-0.96%- Lines of code
41522
-0.02%- Number of high supply chain risk alerts
1
Infinity%No dependency changes