Agent Plugins

Claude Code/Codex에서 함께 사용할 수 있는 플러그인/스킬 저장소입니다.

설치

Skills (권장, Claude Code + Codex 공용)

# 모든 스킬 설치
npx skills add october-academy/agent-plugins -a claude-code -a codex --skill '*' -y

# 특정 스킬만 설치 (예: cp)
npx skills add october-academy/agent-plugins -a claude-code -a codex --skill cp -y

Claude Plugin Marketplace (Claude Code 전용)

# 마켓플레이스 추가 및 플러그인 설치
claude plugin marketplace add october-academy/agent-plugins
claude plugin marketplace update
claude plugin install <plugin-name>@agent-plugins

기존 사용자 마이그레이션 (`@october-plugins` -> `@agent-plugins`)

# 1) 새 마켓플레이스 등록
claude plugin marketplace add october-academy/agent-plugins
claude plugin marketplace update

# 2) 플러그인 재설치 (예: cp)
claude plugin install cp@agent-plugins

호출 방식

플러그인 스킬은 /플러그인명 또는 /플러그인명:스킬명으로 호출합니다.

/clarify:vague         # 요구사항 명확화
/clarify:unknown       # 전략 맹점 4분면 분석
/clarify:metamedium    # 내용 vs 형식 의사결정
/simplify              # 코드 단순화
/wrap                  # 세션 마무리
/feature-dev           # 기능 개발 워크플로우
/git:push              # git push (다중 명령어 플러그인)

단축형 조건: 플러그인에 스킬이 1개이고, 스킬 이름 = 플러그인 이름이면 단축형 사용 가능
clarify는 3개 스킬(vague, unknown, metamedium)이 있어 /clarify:스킬명 형식 사용

플러그인 목록

플러그인	설명	호출 방식
clarify	3가지 렌즈로 요구사항/전략/형식 의사결정 명확화	`/clarify:vague`, `/clarify:unknown`, `/clarify:metamedium`
cp	커밋 & 푸시 한 번에	`/cp`
deploy	Railway, Cloudflare 통합 배포	`/deploy`
feature-dev	7단계 체계적 기능 개발 워크플로우	`/feature-dev`
frontend-design	고품질 프론트엔드 인터페이스 생성	`/frontend-design` (자동)
git	Git 커밋, 푸시, PR 자동화	`/git:push`, `/git:push-pr`
interview-spec	요구사항 수집용 인터뷰 프롬프트 생성	`/interview-spec` (자동)
linear	Linear 이슈 트래킹 통합 (MCP)	-
opsx	OpenSpec ship 워크플로우 (implement → verify → fix → archive)	`/opsx:ship`
perf	성능 측정 (Lighthouse/Core Web Vitals)	`/perf`
simplify	코드 단순화 및 정제	`/simplify`
sync	원격 저장소 동기화 (git pull)	`/sync`
typescript-lsp	TypeScript/JS 언어 서버 (MCP)	-
web-perf-ux	웹 성능 및 UX 최적화 분석	`/web-perf-ux` (자동)
wrap	세션 마무리 및 문서화	`/wrap`

상세 설명

clarify

모호함을 다루는 3가지 스킬을 제공합니다.

/clarify:vague "로그인 기능 추가"
/clarify:unknown "Q2 성장 전략 점검"
/clarify:metamedium "열심히 하는데 성과가 안 나옴"

vague: 요구사항 명확화 (가설 옵션 질문, Before/After 요약)
unknown: Known/Unknown 4분면 기반 전략 맹점 분석
metamedium: 내용(content) vs 형식(form) 레버리지 판단
참고 저장소: https://github.com/team-attention/plugins-for-claude-natives

cp

커밋과 푸시를 한 번에 수행합니다.

/cp                        # 자동 커밋 메시지 생성
/cp "fix: 버그 수정"        # 메시지 지정

Conventional Commits 형식
민감한 파일 자동 감지 (.env 등)
Co-Authored-By 자동 추가

deploy

Railway, Cloudflare Pages/Workers 통합 배포.

/deploy              # 전체 배포
/deploy railway      # Railway만
/deploy cf           # Cloudflare Workers만

사전 체크: 커밋되지 않은 변경사항 확인
배포 후 상태 리포트

feature-dev

7단계 기능 개발: Discovery → Codebase Exploration → Clarifying Questions → Architecture Design → Implementation → Quality Review → Summary

/feature-dev OAuth 인증 추가

에이전트: code-explorer, code-architect, code-reviewer

frontend-design

고품질 프론트엔드 UI 생성. 프론트엔드 작업 시 자동 적용.

독특한 타이포그래피/색상
하이 임팩트 애니메이션
프로덕션 레디 코드

git

Git 커밋/푸시/PR 자동화. Conventional Commits 형식.

/git:push                              # 자동 메시지, main에 push
/git:push "fix: bug" --branch hotfix   # 특정 브랜치에 push
/git:push-pr                           # push 후 PR 생성
/git:push-pr "feat: new" --base dev    # dev 기준 PR

interview-spec

Claude가 작업 전 요구사항을 수집하도록 인터뷰 프롬프트 생성.

트리거: "Help me write a prompt for...", "I'm not sure what I want yet"

linear

Linear 이슈 트래킹 MCP 통합. 이슈 생성/관리, 상태 업데이트, 워크스페이스 검색.

opsx

OpenSpec 확장 — 팀 기반 ship 워크플로우. Claude Code(leader) + Codex(reviewer) dual verification.

/opsx:ship [change-name]

5단계 사이클: Implement → Dual Verify → Fix Loop (max 3) → Archive → Cleanup
멀티 에이전트: implementer(구현) + reviewer(코드 리뷰) + leader(검증/오케스트레이션)
전제 조건: OpenSpec CLI, Codex CLI 설치 필요

perf

빠른 성능 측정. Lighthouse/Core Web Vitals 기반.

/perf                # 메인 페이지 측정
/perf /about         # 특정 경로
/perf --all          # 주요 페이지 일괄 측정

LCP, CLS, INP 핵심 지표
web-perf-ux의 간소화 버전

simplify

코드 단순화. 기능은 유지하고 구현만 개선.

/simplify                 # 최근 수정 코드
/simplify src/utils.ts    # 특정 파일

원칙: 명확성 > 간결성, 중첩 삼항 금지, Opus 모델

sync

원격 저장소 동기화 (git pull) 단축 명령어.

/sync              # origin main에서 pull
/sync develop      # 특정 브랜치

작업 중인 변경사항 있으면 경고
충돌 발생 시 해결 도움

typescript-lsp

TypeScript/JS 언어 서버 MCP. Go-to-definition, Find references, Error checking.

npm install -g typescript-language-server typescript

web-perf-ux

웹 성능/UX 최적화. Lighthouse + Core Web Vitals 분석.

트리거: "성능 분석", "페이지가 느려요", "CLS 문제", "Lighthouse 실행"

wrap

세션 마무리. 멀티 에이전트로 문서화, 자동화, 학습 포인트 분석.

/wrap                     # 인터랙티브 마무리
/wrap README 오타 수정     # 빠른 커밋

빠른 참조

슬래시 명령어

명령어	설명
`/clarify:vague "<요구사항>"`	요구사항 명확화
`/clarify:unknown "<전략/계획>"`	전략 맹점 분석
`/clarify:metamedium "<작업/기획>"`	내용 vs 형식 의사결정
`/cp [msg]`	커밋 & 푸시
`/deploy [target]`	통합 배포
`/feature-dev <기능>`	7단계 기능 개발
`/frontend-design`	프론트엔드 UI 생성
`/git:push [msg] [--branch]`	커밋 및 푸시
`/git:push-pr [msg] [--base]`	커밋, 푸시, PR
`/interview-spec`	인터뷰 프롬프트 생성
`/opsx:ship [change-name]`	OpenSpec ship 워크플로우
`/perf [path]`	성능 측정
`/simplify [file]`	코드 단순화
`/sync [branch]`	원격 동기화
`/web-perf-ux`	웹 성능 분석
`/wrap [msg]`	세션 마무리

설치 명령어

claude plugin install clarify@agent-plugins
claude plugin install cp@agent-plugins
claude plugin install deploy@agent-plugins
claude plugin install feature-dev@agent-plugins
claude plugin install frontend-design@agent-plugins
claude plugin install git@agent-plugins
claude plugin install interview-spec@agent-plugins
claude plugin install linear@agent-plugins
claude plugin install opsx@agent-plugins
claude plugin install perf@agent-plugins
claude plugin install simplify@agent-plugins
claude plugin install sync@agent-plugins
claude plugin install typescript-lsp@agent-plugins
claude plugin install web-perf-ux@agent-plugins
claude plugin install wrap@agent-plugins

구조

agent-plugins/
├── .claude-plugin/
│   └── marketplace.json
├── plugins/
│   ├── clarify/
│   │   ├── .claude-plugin/plugin.json
│   │   ├── hooks/hooks.json
│   │   └── skills/{vague,unknown,metamedium}/SKILL.md
│   ├── cp/
│   │   ├── .claude-plugin/plugin.json
│   │   └── skills/cp/SKILL.md
│   ├── deploy/
│   │   ├── .claude-plugin/plugin.json
│   │   └── skills/deploy/SKILL.md
│   ├── feature-dev/
│   │   ├── .claude-plugin/plugin.json
│   │   ├── agents/{code-explorer,code-architect,code-reviewer}.md
│   │   └── skills/feature-dev/SKILL.md
│   ├── frontend-design/
│   │   ├── .claude-plugin/plugin.json
│   │   └── skills/frontend-design/SKILL.md
│   ├── git/
│   │   ├── .claude-plugin/plugin.json
│   │   └── skills/{push,push-pr}/SKILL.md
│   ├── interview-spec/
│   │   ├── .claude-plugin/plugin.json
│   │   └── skills/interview-spec/SKILL.md
│   ├── linear/
│   │   ├── .claude-plugin/plugin.json
│   │   └── .mcp.json
│   ├── opsx/
│   │   ├── .claude-plugin/plugin.json
│   │   ├── commands/ship.md
│   │   ├── skills/ship/SKILL.md
│   │   ├── extras/{rules,codex-prompts}/
│   │   └── install-extras.sh
│   ├── perf/
│   │   ├── .claude-plugin/plugin.json
│   │   └── skills/perf/SKILL.md
│   ├── simplify/
│   │   ├── .claude-plugin/plugin.json
│   │   ├── agents/{complexity-analyzer,pattern-checker,readability-analyzer,naming-reviewer,issue-simplifier}.md
│   │   └── skills/simplify/SKILL.md
│   ├── sync/
│   │   ├── .claude-plugin/plugin.json
│   │   └── skills/sync/SKILL.md
│   ├── typescript-lsp/
│   │   └── .claude-plugin/plugin.json
│   ├── web-perf-ux/
│   │   ├── .claude-plugin/plugin.json
│   │   └── skills/web-perf-ux/SKILL.md
│   └── wrap/
│       ├── .claude-plugin/plugin.json
│       ├── agents/{doc-updater,automation-scout,learning-extractor,followup-suggester,duplicate-checker}.md
│       └── skills/wrap/SKILL.md
└── README.md

라이선스

MIT

sync

Agent Plugins

설치

Skills (권장, Claude Code + Codex 공용)

Claude Plugin Marketplace (Claude Code 전용)

기존 사용자 마이그레이션 (`@october-plugins` -> `@agent-plugins`)

호출 방식

플러그인 목록

상세 설명

clarify

cp

deploy

feature-dev

frontend-design

git

interview-spec

linear

opsx

perf

simplify

sync

typescript-lsp

web-perf-ux

wrap

빠른 참조

슬래시 명령어

설치 명령어

구조

라이선스

soultrace

frontend-design

drizzle

using-git-worktrees

github-workflow-automation

Agent Plugins

설치

Skills (권장, Claude Code + Codex 공용)

Claude Plugin Marketplace (Claude Code 전용)

기존 사용자 마이그레이션 (@october-plugins -> @agent-plugins)

호출 방식

플러그인 목록

상세 설명

clarify

cp

deploy

feature-dev

frontend-design

git

interview-spec

linear

opsx

perf

simplify

sync

typescript-lsp

web-perf-ux

wrap

빠른 참조

슬래시 명령어

설치 명령어

구조

라이선스

기존 사용자 마이그레이션 (`@october-plugins` -> `@agent-plugins`)