pi coding agent · cskwork

Your pi agent, ready in one command

한 줄이면 pi 에이전트 세팅 완료

30 skills, 18 packages, 4 subagent model profiles, and every extension I actually use. The permission policy stops the commands that can destroy something and stays out of the way otherwise. One repo, one command, any machine.

스킬 30종, 패키지 18종, 서브에이전트 모델 프로필 4종, 그리고 실제로 쓰는 익스텐션 전부. 권한 정책은 무언가를 망가뜨릴 수 있는 명령만 막고 나머지는 비켜섭니다. 레포 하나, 명령 하나, 어느 머신에서든.

# fresh machine git clone https://github.com/cskwork/pi-setup-public.git ~/pi-setup-public ~/pi-setup-public/install.sh && pi auth

01The skills I kept남긴 스킬

These are the ones worth the context they cost. I deleted the rest.

쓰는 컨텍스트만큼 값을 하는 스킬만 남겼습니다. 나머지는 지웠습니다.

agent-browser

Browser automation CLI. Navigate, fill, screenshot, scrape.

브라우저 자동화 CLI. 탐색·입력·스크린샷·스크래핑.

vercel-labs/agent-browser

impeccable

Frontend design critique, audit, and polish. The taste skill.

프론트엔드 디자인 비평·감사·폴리시. 감각을 담당합니다.

oddxinformatics/impeccable

gpt-image-2

Image generation through your ChatGPT plan via Codex CLI.

ChatGPT 플랜 + Codex CLI로 이미지 생성.

verify

5 verification gates. Never calls a green build "verified".

5단계 검증 게이트. 빌드 성공을 '검증됨'이라 부르지 않음.

cskwork/verify-skill

ego-browser

Agent-friendly browser that shares your logged-in state, zero config.

로그인 상태를 공유하는 에이전트 친화 브라우저, 설정 제로.

citrolabs/ego-lite

call-agent

Routes a task to the peer AI CLI that fits it: Codex, agy, Kiro, Claude.

작업에 맞는 동료 AI CLI로 라우팅합니다. Codex, agy, Kiro, Claude.

cskwork/call-agent

sdlc-kit

Six stages with human approvals, fresh-context review, evidence, and bounded memory.

사람 승인, 새 컨텍스트 검토, 증거, 제한된 메모리를 갖춘 6단계 SDLC.

cskwork/sdlc-kit

browser-qa

Browser QA on anything. YAML DAG scenarios, engine choice, real API evidence.

어떤 사이트든 브라우저 QA. YAML DAG 시나리오, 엔진 선택, 실제 API 증적.

cskwork/browser-qa

playwright-cli

Drive a browser directly; inspect or author Playwright tests.

브라우저를 직접 조작하고 Playwright 테스트를 검사·작성.

verification-before-completion superpowers

Evidence before assertions. Never call unverified work done.

주장 전에 증거. 검증 안 된 일을 끝났다고 말하지 않습니다.

obra/superpowers

find-skills

Discover and install new agent skills on demand.

새 에이전트 스킬을 필요할 때 발견·설치.

tdd

Test-driven development. Red-green-refactor, integration tests, mocking.

테스트 주도 개발. red-green-refactor, 통합 테스트, mocking.

mattpocock/skills

diagnosing-bugs

Diagnosis loop for hard bugs and perf regressions: reproduce → minimise → hypothesise → instrument.

버그·성능 회귀 진단 루프: 재현→최소화→가설→계측.

mattpocock/skills

code-review

Reviews changes since a fixed point on two axes, Standards and Spec, in parallel sub-agents.

기준점 이후 변경을 Standards·Spec 두 축으로, 병렬 서브에이전트가 리뷰합니다.

mattpocock/skills

implement

Implement a piece of work from a spec or tickets.

스펙·티켓 기반 작업 구현.

mattpocock/skills

research

Investigate against high-trust primary sources, capture as Markdown.

신뢰 원천 조사 후 Markdown로 저장.

mattpocock/skills

domain-modeling

Build and sharpen a project's domain model in CONTEXT.md and ADRs.

CONTEXT.md와 ADR로 도메인 모델을 구축하고 정교화합니다.

mattpocock/skills

improve-codebase-architecture

Scans for places worth deepening, writes an HTML report, then grills the one you pick.

깊게 팔 만한 지점을 스캔하고, HTML 리포트를 쓰고, 고른 항목을 그릴링합니다.

mattpocock/skills

resolving-merge-conflicts

Resolve an in-progress git merge/rebase conflict.

진행 중 git merge/rebase 충돌 해결.

mattpocock/skills

grilling

Stress-tests a plan or decision until it breaks or holds.

계획이나 결정이 깨지거나 버틸 때까지 압박합니다.

mattpocock/skills

wait-what

Stop. That last message did not land, so re-pitch it.

멈추세요. 직전 메시지가 안 통했으니 다시 제안합니다.

mattpocock/skills

writing-for-agents

Writing documents for agents: skills, AGENTS.md, CLAUDE.md.

에이전트용 문서 작성: skills, AGENTS.md, CLAUDE.md.

mattpocock/skills

handoff

Compact the conversation into a handoff doc for the next agent.

대화를 다음 에이전트용 인수인계 문서로 압축.

mattpocock/skills

teach

Teach a skill or concept within the workspace.

워크스페이스 내 기술·개념 교육.

mattpocock/skills

db-intelligence

One DB skill, four engines: PostgreSQL, MySQL, SQLite, MongoDB. Credential-safe and read-first.

DB 스킬 하나에 엔진 4개: PostgreSQL, MySQL, SQLite, MongoDB. 자격증명 보호, 읽기 우선.

pi-settings

Audit and configure pi's own settings.json: skill isolation, routing, packages.

pi 자체 settings.json 감사·구성: 스킬 격리, 라우팅, 패키지.

sync-agent-prompt

Sync the AGENTS.md operating contract and essential skills across the repos that hold copies; diffs before writing.

사본을 가진 저장소 사이에 AGENTS.md 운영 계약과 필수 스킬 동기화. 쓰기 전 diff.

Agents load their domain skills by default. QA agents get browser-qa, coders get TDD, verifiers get the verify gate. Nothing to wire up per call.

에이전트는 도메인 스킬을 기본으로 로드합니다. QA엔 browser-qa, 코더엔 TDD, 검증엔 verify 게이트. 호출마다 연결할 일이 없습니다.

02Permission policy권한 정책

Reads, file tools, skills, search, and ordinary shell commands run without a prompt, the same as stock pi. The guards sit on the few commands that can destroy something. Your live config is gitignored, so it stays yours.

읽기·파일 도구·스킬·검색·일반 셸 명령은 기본 pi와 똑같이 프롬프트 없이 실행됩니다. 가드는 무언가를 망가뜨릴 수 있는 몇 개 명령에만 걸립니다. 실제 설정 파일은 gitignore되어 각자 로컬에 남습니다.

  • ✓ Allowreads · find/grep/ls · skills · ctx tools · web · normal bash · curl읽기 · find/grep/ls · 스킬 · ctx 도구 · 웹 · 일반 bash · curl
  • ? Askany rm · sudo · ctx_purge모든 rm · sudo · ctx_purge
  • ✕ Denyrm -rf · reading .env* and ~/.ssh/* (every tool)rm -rf · .env*와 ~/.ssh/* 읽기(모든 도구)

03Extensions익스텐션

The installer reads settings.json and pulls these in.

인스톨러가 settings.json을 읽어 설치합니다.

pi-permission-system

Pattern permissions with TUI modal, review log, fail-closed validation.

pi-goal

Give pi a goal; it keeps working from each settled boundary until done.

pi-usage

Token/cost tracking per session.

pi-subagents

Parallel, scripted, and coordinated subagent workflows.

pi-lens

Code feedback while the agent edits: LSP diagnostics, linters, formatters, type-checks.

glm-vision

GLM-4.6V image understanding for text-only zai models.

pi-background-tasks

Named background shell tasks with durable notifications.

context-mode

Big tool outputs stay out of your context window (FTS5-indexed).

pi-memory (@samfp)

Learns corrections and preferences, then injects them into future sessions.

pi-oracle

Async ChatGPT Pro/Grok web jobs with isolated one-time browser auth.

pi-mcp-adapter

MCP servers on-demand, without burning context on tool defs.

pi-web-access

Web search and fetch.

locals

permission-gate · dirty-repo-guard · herdr-agent-state · superset-hooks · ai-memory-pi

04Subagent model profiles서브에이전트 모델 프로필

Swap every gate's model in one command: /subagents-load-profile <name>

명령 하나로 모든 게이트의 모델을 교체합니다: /subagents-load-profile <name>

Gatecodex-onlyclaude-onlymixglm-max
specifiersol · highsonnet-5 · highopus-5 · highglm-5.3 · max
codersol · mediumopus-5 · highcodex sol · highglm-5.3 · max
cleanersol · mediumhaiku-4-5 · highsol · mediumglm-5.3 · max
sw-architectsol · highopus-5 · highcodex sol · highglm-5.3 · max
hardendersol · highopus-5 · highcodex sol · highglm-5.3 · max
qasol · mediumsonnet-5 · highglm-5.3-flash · maxglm-5.3-flash · max

The hardender always gets a top model. It is the only gate that invents its own checks instead of reading a given artifact, and when it fails it emits a silent PASS that no later gate catches.

hardender에는 항상 최상위 모델을 붙입니다. 주어진 문서를 읽는 다른 게이트와 달리 검사 항목을 스스로 만들어야 하고, 실패하면 조용히 PASS를 내보내 이후 어느 게이트도 이를 잡지 못합니다.

Utility agents. Every profile also routes the non-gate agents on two tiers. planner and security take the profile's deep model. The rest (refactorer, doc-writer, git-ops, *-pro, scout, reviewer, worker, …) take the cheap, fast one.

유틸리티 에이전트. 모든 프로필은 게이트가 아닌 에이전트도 2단 티어로 배정합니다. plannersecurity는 상위 모델을 받고, 나머지(refactorer, doc-writer, git-ops, *-pro, scout, reviewer, worker …)는 저렴하고 빠른 쪽을 받습니다.

Gotcha. Never put model: in an agent's frontmatter. pi-subagents resolves it before agentOverrides, so that agent silently ignores every profile. All agents/*.md ship without it, and profiles are the one place routing gets decided.

함정. 에이전트 frontmatter에 model:을 넣지 마세요. pi-subagents는 이것을 agentOverrides보다 먼저 해석하므로, 모델을 박아둔 에이전트는 모든 프로필을 조용히 무시합니다. 이 저장소의 agents/*.md에는 모두 없습니다. 라우팅은 프로필에서만 결정됩니다.