Ponytail 설치 가이드 + 명령어 7개 한글 정리 + 코드 줄이는 프롬프트 30개

AI 에이전트에게 기능 하나 시키면 코드를 수백 줄씩 써 오죠? 포니테일(Ponytail)은 AI 에이전트를 "제일 게으른 시니어 개발자"처럼 생각하게 만드는 무료 스킬이에요. 새로 짜기 전에 이미 있는 코드·표준 기능·브라우저 기능부터 찾아서 필요한 만큼만 써요(깃허브 별 18.5만, 2026-11-06 기준, MIT 라이선스, v5.3.3).
이 페이지에 README 공식 설치 명령어, 명령어 7개 한글 정리, 우리가 직접 돌려 본 결과, 바로 복사해 쓰는 프롬프트 30개를 정리했어요.

더 많은 클로드 활용법: 유튜브 빌더조쉬 구독 · 조쉬의 뉴스레터 구독

한눈에 보기 (명령어 7개)

• 핵심 규칙은 "토큰을 제일 적게"가 아니라 "필요한 것만 쓰고, 입력 검사·에러 처리·보안·접근성은 절대 빼지 않는다"예요.
• 코드를 쓰기 전에 7계단을 차례로 확인해요: ① 정말 필요한가 → ② 이 저장소에 이미 있나 → ③ 표준 라이브러리로 되나 → ④ 플랫폼 기본 기능이 있나 → ⑤ 깔려 있는 패키지로 되나 → ⑥ 한 줄로 되나 → ⑦ 그제야 동작하는 최소한만. 로직이 있으면 작은 테스트 하나를 남겨요.
• 답이 끝날 때마다 건너뛴 것·확인 못 한 것·알아야 할 위험을 적어 줘요.

설치 — 명령어 두 줄

클로드 코드 안에서 (기본, 추천) — 프롬프트 창에 한 줄씩 따로 입력하세요.

/plugin marketplace add DietrichGebert/ponytail

/plugin install ponytail@ponytail

• 이렇게 깔면 내 모든 프로젝트(사용자 범위, 기본값)에서 포니테일이 켜져요.

터미널에서 해도 돼요

claude plugin marketplace add DietrichGebert/ponytail
claude plugin install ponytail@ponytail

• 폴더 하나에서만 쓰고 싶으면 두 줄 끝에 모두 --scope project를 붙이세요.

Codex를 쓰면 (README 공식 명령)

codex plugin marketplace add DietrichGebert/ponytail
codex plugin add ponytail@ponytail

• 그다음 Codex에서 /hooks를 열어 훅 두 개를 신뢰(trust)하고 새 스레드를 시작하세요.
• 커서·코파일럿·제미나이 등 다른 에이전트는 저장소의 AGENTS.md를 프로젝트에 복사하거나 INSTALL.md를 따라 하세요. 모두 20개 에이전트를 지원해요.

• 포니테일은 깃허브 DietrichGebert/ponytail 또는 npm @dietrichgebert/ponytail에서만 받으세요. 공식 버전은 .exe·.dll 파일을 절대 넣지 않는다고 해요.

명령어 7개 자세히

설치하면 매 세션 자동으로 켜져 있어요. 아래 명령은 필요할 때만 쓰면 돼요.

1. /ponytail [lite | full | ultra | off] — 강도 조절

• 무엇: 게으름 강도를 정하거나 꺼요. 아무것도 안 붙이면, 꺼져 있을 땐 기본 단계로 켜고 켜져 있을 땐 지금 단계를 알려 줘요.
• 언제: 가벼운 수정은 lite, 평소엔 full, 코드가 너무 부풀었을 땐 ultra, 잠깐 원래대로 쓰고 싶으면 off.

/ponytail ultra

2. /ponytail band [on | off] · /ponytail band import — 비용 띠

• 무엇: 클로드 코드 입력창 위에 "띠"를 보여 줘요. 이번 작업의 비용, 토큰, 에이전트 시간, 기존 코드를 얼마나 재사용했는지, 마지막 변경 뒤 테스트가 통과했는지가 나와요. 아무것도 안 붙이면 켜고 끄기를 바꿔요. import를 붙이면 지난 클로드 코드 세션을 "보드"(내 컴퓨터에서 열리는 페이지)에 비용·시간·토큰과 함께 넣어 줘요.
• 언제: 비용을 보면서 일하고 싶을 때, 이번 달에 얼마나 썼는지 보고 싶을 때.
• 클로드 코드 2.1.290 이상, 터미널이나 데스크톱 앱에서만 보여요(VS Code 채팅 패널, 클라우드 세션, claude -p에서는 안 보여요). 기록은 기본으로 내 컴퓨터 ~/.config/ponytail/band/에만 저장돼요.

/ponytail band

/ponytail band import

3. /ponytail-review — 시니어 리뷰

• 무엇: 지금 바뀐 코드를 "장애 나면 새벽에 전화 받는 시니어"처럼 리뷰해요. 버그, 보안, 실제 부하, 테스트 없는 위험 코드, 느린 부분, 줄일 것을 봐요. 바뀐 부분만이 아니라 그 변경이 건드리는 다른 코드까지 읽어요. 항목마다 무엇인지 → 문제 → 고치는 법 → 안 고치면 생기는 일을 적어 줘요.
• 언제: 커밋 전, PR 올리기 전.
• 범위는 말로 정해요: uncommitted(커밋 안 한 것), staged(스테이징한 것), branch(브랜치 전체), 또는 PR 링크.

/ponytail-review uncommitted

4. /ponytail-audit — 저장소 전체 점검

• 무엇: 리뷰와 같은 점검을 저장소 전체에 해요. 먼저 시작 지점·데이터 흐름·예상 부하를 파악한 뒤, 찾은 문제를 중요한 순으로 매기고 "이것부터 고치세요"를 알려 줘요.
• 언제: 남이 만든 프로젝트를 넘겨받았을 때, 출시 전 한 번.

/ponytail-audit

5. /ponytail-debt — 미뤄 둔 일 장부

• 무엇: 포니테일은 일부러 줄인 곳에 shortcut: 주석을 남겨요. 이 명령은 그 주석을 모아 장부로 만들어 줘요.
• 언제: 일주일에 한 번, "나중에 하자"가 쌓였을 때.

/ponytail-debt

6. /ponytail-gain — 효과 점수판

• 무엇: 벤치마크로 잰 효과(코드·비용 감소, 속도)를 점수판으로 보여 줘요.
• 언제: 팀에 포니테일을 소개할 때, 효과가 궁금할 때.

/ponytail-gain

7. /ponytail-help — 빠른 안내

• 무엇: 위 명령어들을 짧게 정리해서 보여 줘요.
• 언제: 명령어 이름이 기억 안 날 때.

/ponytail-help

• 명령어는 스킬을 지원하는 에이전트(클로드 코드, Codex, 제미나이, OpenCode 등)에서 써요. Codex에서는 $ponytail:ponytail-review처럼 불러요.

실제 실행 예 — 직접 돌려 봤어요

2026-11-06, 작은 React 예약 폼 저장소에서 클로드 코드 2.1.318로 같은 요청을 포니테일 없이 한 번, 켜고 한 번 시켜 봤어요.

예약 폼에 날짜 고르는 칸을 추가해 줘

포니테일 켜고 — 2줄 추가

   const [name, setName] = useState("");
+  const [date, setDate] = useState("");
 ...
+      <Input label="날짜" type="date" value={date} onChange={(e) => setDate(e.target.value)} />

포니테일이 남긴 답(원문 그대로):

이름 칸에 쓰던 Input 부품을 그대로 썼고, 종류만 날짜(type="date")로 정했어요.
그래서 따로 라이브러리를 깔지 않아도 브라우저에 있는 달력이 뜨고, 생김새도 이름 칸과 같아요.

하지 않은 것: 날짜를 꼭 고르게 하기, 지난 날짜 막기, 고른 날짜를 서버로 보내기는 넣지 않았어요.
지금 폼이 이름도 어디로 보내지 않고 있어서 날짜도 똑같이 두었어요.
화면을 직접 띄워서 확인하지는 않았어요.

• 포인트는 "뭘 안 했는지"를 솔직하게 적어 준다는 거예요. 지난 날짜 막기가 필요하면 "지난 날짜도 막아 줘" 한 줄만 더 시키면 돼요.

/ponytail-review — SQL 인젝션 넣은 파일 리뷰

일부러 SQL 인젝션이 들어간 예약 API 파일(src/api/bookings.js)을 만들고 /ponytail-review를 돌렸어요. 결과는 Must fix(꼭 고칠 것) 4개 + Should fix(고치면 좋은 것) 1개.

리뷰 원문 발췌(1번 항목):

1. Anyone can read every booking or wipe the table (src/api/bookings.js:5, :10)
   - What this is: Both queries paste user input straight into the SQL text.
     This is called SQL injection.
   - Problem: ?name=' OR '1'='1 returns every booking with every column.
     DELETE /bookings/1 OR 1=1 deletes every row.
   - Fix: Use parameters, for example
     db.query("SELECT * FROM bookings WHERE name = $1", [name])
     db.query("DELETE FROM bookings WHERE id = $1", [req.params.id])
   - If we skip it: Customer data leaks and the bookings table can be emptied with one request.

Verdict: fix 1, 2, 3 and 4 first.

• 항목마다 무엇인지 → 문제 → 고치는 법 → 안 고치면 생기는 일 순서로 나와요. 마지막엔 "확인 못 한 것"(어떤 DB 드라이버인지, 로그인 방식)도 적어 줬어요.
• 이 스킬을 만든 개발자 측정으로는 리뷰가 심어 둔 문제를 100% 찾았다고 해요(스킬 없이 87%).

코드 줄이는 프롬프트 30개

포니테일을 설치한 클로드 코드에 그대로 붙여 넣으세요. 파일 이름·기능 이름만 바꾸면 돼요. 명령어(/ponytail-…)로 시작하는 건 그 명령과 함께 쓰는 문장이에요.

새 기능 만들 때 (1~5)

리팩터링·줄이기 (6~10)

리뷰·보안 (11~15)

테스트 (16~20)

비용·토큰 아끼기 (21~25)

감사·빚 정리 (26~30)

이렇게 조합하면 좋아요

1. 평소: 설치만 해 두면 매 세션 자동으로 켜져요. 그냥 평소처럼 시키세요.
2. 커밋 전: /ponytail-review uncommitted → Must fix만 고치기 → 한 번 더 리뷰.
3. 일주일에 한 번: /ponytail-debt로 미뤄 둔 일 확인 → 작은 것부터 처리.
4. 한 달에 한 번 / 출시 전: /ponytail-audit로 저장소 전체 점검.
5. 비용이 신경 쓰일 때: /ponytail band로 띠를 켜 두고, /ponytail band import로 지난 기록까지 모아 보기.

자주 묻는 질문

링크

• 저장소: https://github.com/DietrichGebert/ponytail
• 한국어 README: https://github.com/DietrichGebert/ponytail/blob/main/i18n/README.ko.md
• 다른 에이전트 설치 방법: https://github.com/DietrichGebert/ponytail/blob/main/INSTALL.md
• 공식 사이트: https://ponytail.dev

더 받아보기

유튜브 빌더조쉬 구독 · 조쉬의 뉴스레터 구독

이 자료가 나온 영상: 유튜브 쇼츠 · 인스타 릴스