Community코딩 & 개발github.com

steipete/agent-scripts

에이전트용 스크립트로, 여러 저장소 간에 공유됩니다.

agent-scripts란 무엇인가요?

이 스킬은 Peter의 로컬 작업 공간 전반에서 Claude Code, Codex 등의 에이전트가 재사용할 수 있는 공유 명령어, 스킬 및 작은 도우미 스크립트의 중앙 저장소 역할을 합니다. `skills/` 디렉토리 아래에 YAML 머리말을 가진 SKILL.md 파일로 구성된 재사용 가능한 워크플로우 스킬을 제공하며, 각 스킬은 간단한 트리거 구문으로 라우팅됩니다. 주요 기능으로는 에이전트 행동을 제어하는 공유 하드 규칙(AGENTS.MD), 여러 저장소에 걸쳐 일관된 커밋 및 동기화 워크플로우를 적용하는 `scripts/committer` 및 `scripts/sync-skills`와 같은 포터블 헬퍼 스크립트, 그리고 모든 SKILL.md 파일의 YAML 머리말을 검증하여 구조적 무결성을 보장하는 `scripts/validate-skills` 검증 도구가 포함되어 있습니다. 이 스킬은 Codex와 Claude Code 모두를 지원하며, 스킬 검증을 로컬 Git 훅으로 활성화하고 공유 규칙과 저장소별 규칙의 명확한 분리를 유지하도록 설계되었습니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add steipete/agent-scripts

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

에이전트 스크립트

Peter의 로컬 작업 공간을 위한 공유 에이전트 명령어, 스킬 및 작은 포터블 헬퍼입니다.

이 저장소는 다음 항목의 표준 위치입니다:

  • AGENTS.MD: Codex/Claude 스타일 에이전트를 위한 공유 하드 규칙
  • skills/: 심볼릭 링크로 노출된 저장소 소유 스킬을 포함한 재사용 가능한 워크플로우 스킬
  • scripts/: 여러 프로젝트에서 사용되는 종속성 최소 헬퍼
  • hooks/: 스킬 검증과 같은 로컬 가드레일

스킬

스킬은 주요 라우팅 계층입니다. 각 skills/<name>/SKILL.md에는 YAML 머리말이 있습니다:

---
name: skill-name
description: "간단한 일반 트리거 구문."
---

규칙:

  • 설명을 짧고 일반적으로 유지하세요. 문서화보다 라우팅에 최적화하세요.
  • 스킬 본문은 간결하고 실용적으로 유지하세요.
  • 반복 가능한 명령어가 있는 워크플로우에는 skills/<name>/scripts/ 아래의 헬퍼 스크립트를 선호하세요.
  • 편집 후 검증: scripts/validate-skills
  • 머리말의 description은 따옴표로 묶으세요.

전역 검색은 scripts/sync-skills에 의해 구축됩니다(멱등적이며, 복제 또는 스킬 추가 후 모든 Mac에서 실행):

  • Codex는 중첩 디렉토리를 스캔하므로 전체 루트 링크를 얻습니다: ~/.codex/skills/agent-scripts -> ~/Projects/agent-scripts/skills, ~/.codex/skills/manager -> ~/Projects/manager/skills.
  • Claude Code는 ~/.claude/skills/<name>/SKILD.md만 로드합니다(정확히 한 단계 깊이; 항목별 심볼릭 링크는 따라가지만 카테고리 하위 폴더는 스캔되지 않음 — 2.1.197에서 확인됨). 두 저장소와 머신 로컬 ~/.codex/skills/<name> 추가 항목을 모두 포함하는 평면적인 스킬별 링크 미러를 얻습니다.
  • 이름 충돌은 agent-scripts > manager > codex-local 순서로 해결됩니다. 스크립트는 건너뛴 중복 항목을 출력하고 끊어졌거나 오래된 관리 링크를 정리합니다.

공유 개인 스킬은 skills/ 아래에 실제 폴더로 존재합니다. 공개 OpenClaw 공유 스킬은 ../agent-skills에 있으며 추적된 상대 심볼릭 링크로 여기에 노출됩니다. 저장소 소유 스킬은 자체 저장소에 정식 버전을 유지하며 동일한 방식으로 여기에 노출됩니다. 예를 들어:

skills/autoreview -> ../../agent-skills/skills/autoreview
skills/discrawl -> ../../discrawl/.agents/skills/discrawl

현재 심볼릭 링크된 저장소 소유 스킬은 birdclaw, discrawl, gog, imsg, slacrawl, wacli, wacrawl입니다.

에이전트 명령어

공유 하드 규칙은 AGENTS.MD에 있습니다.

전역 설정(scripts/sync-skills에서도 유지 관리, Claude Code는 CLAUDE.md만 읽으므로 공유 AGENTS.MD에 연결됨):

  • ~/.codex/AGENTS.md -> ~/Projects/agent-scripts/AGENTS.MD
  • ~/.claude/CLAUDE.md -> ~/Projects/agent-scripts/AGENTS.MD
  • ~/.claude/AGENTS.md -> ~/Projects/agent-scripts/AGENTS.MD

다운스트림 저장소는 포인터 스타일 AGENTS.MD를 사용해야 합니다:

READ ~/Projects/agent-scripts/AGENTS.MD BEFORE ANYTHING (skip if missing).

저장소별 규칙은 해당 포인터 아래에 위치합니다. 공유 블록을 다운스트림 저장소로 복사하지 마세요.

헬퍼

scripts/committer

  • 나열된 파일만 정확히 스테이징합니다.
  • 비어 있지 않은 커밋 메시지를 강제합니다.
  • 커밋 전에 스킬 검증을 실행합니다.

scripts/sync-skills

  • 머신별 스킬 미러를 구축합니다: Codex 전체 루트 링크, Claude 평면 스킬별 링크, 공유 AGENTS.MD 포인터.
  • 멱등적이며 변경 사항만 출력하고, 끊어졌거나 오래된 관리 링크를 정리하며, 실제 파일을 절대 덮어쓰지 않습니다.

scripts/validate-skills

  • 모든 skills/*/SKILL.md를 확인합니다.
  • YAML 머리말과 필수 name 및 description을 검증합니다.
  • git config core.hooksPath hooks로 로컬 훅으로 활성화하세요.

scripts/docs-list.ts

  • docs/를 탐색합니다.
  • summary 및 read_when 머리말을 강제합니다.
  • 이를 연결한 저장소에 온보딩 요약을 출력합니다.

scripts/browser-tools.ts

  • 독립 실행형 Chrome DevTools 헬퍼입니다.
  • 일반 명령어: start --profile, nav <url>, eval '<js>', screenshot, console, network, search --content "<query>", content <url>, inspect, kill --all --force.
  • bun build scripts/browser-tools.ts --compile --target bun --outfile bin/browser-tools로 선택적 바이너리를 빌드합니다.

동기화

이 저장소를 공유 에이전트 규칙과 포터블 헬퍼 스크립트의 표준 저장소로 취급하세요.

다운스트림 저장소를 동기화할 때:

  • 여기서 최신 버전을 먼저 가져오세요.
  • 각 대상 저장소가 포인터 스타일 AGENTS.MD로 시작하는지 확인하세요.
  • 포인터 아래에 저장소 로컬 규칙을 유지하세요.
  • 헬퍼가 바이트 단위로 동일하게 유지되어야 하는 경우에만 헬퍼 변경 사항을 양방향으로 복사하세요.
  • 스크립트를 종속성 없이 포터블하게 유지하세요. 저장소별 임포트나 경로 별칭은 사용하지 마세요.

서브모듈의 경우 각 서브 저장소 내에서 포인터 검사를 반복하고, 해당 변경 사항을 푸시한 다음, 상위 저장소에서 서브모듈 SHA를 업데이트하세요.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

관련 스킬