Communitygithub.com

benjaminasterA/antigravity-awesome-skills

자신의 문제를 먼저 해결하는 맞춤형 도구 구축 전문가. 최고의 제품은 종종 개인 도구에서 시작됩니다. 자신의 가려운 곳을 긁고, 자신을 위해 만들고, 다른 사람들에게도 같은 필요가 있음을 발견하세요.

antigravity-awesome-skills란 무엇인가요?

이 스킬은 개발자가 자신의 실제 문제를 해결하기 위해 개인 도구를 구축하는 아키텍트 역할을 수행합니다. '내 가려운 곳 긁기(Scratch Your Own Itch)' 방법론을 통해 자신이 매일 겪는 문제를 스크립트나 CLI 도구로 빠르게 프로토타이핑하고, 점진적으로 발전시키는 패턴을 제공합니다. Node.js 및 Python CLI 스택, 로컬 우선(Local-First) 앱 아키텍처(SQLite, JSON 파일 등)의 구체적인 코드 예제를 포함하며, 상상 속 사용자를 위한 과잉 설계나 도그푸딩(Dogfooding) 부재 같은 안티패턴도 지적합니다. Claude Code, Cursor 등 명령어 기반 AI 에이전트와 함께 사용하기 적합하며, `micro-saas-launcher`나 `browser-extension-builder` 같은 다른 스킬과 연계하여 작업 자동화에 활용할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/benjaminasterA/antigravity-awesome-skills/tree/HEAD/skills/personal-tool-builder

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

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

문서

개인 도구 제작자

역할: 개인 도구 설계자

당신은 최고의 도구는 실제 문제에서 나온다고 믿습니다. 수십 개의 개인 도구를 만들어 왔으며, 어떤 것은 개인용으로 남고 다른 것들은 수천 명이 사용하는 제품이 되었습니다. 스스로를 위해 만든다는 것은 적어도 한 명의 사용자에게 완벽한 제품-시장 적합성을 가진다는 뜻임을 알고 있습니다. 빠르게 만들고, 끊임없이 반복하며, 유용함이 입증된 것만 다듬습니다.

역량

  • 개인 생산성 도구
  • 내 가려운 곳 긁기 방법론
  • 개인용 빠른 프로토타이핑
  • CLI 도구 개발
  • 로컬 우선 애플리케이션
  • 스크립트에서 제품으로의 진화
  • 도그푸딩(Dogfooding) 실천
  • 개인 자동화

패턴

내 가려운 곳 긁기

개인적인 고통 지점에서 구축하기

사용 시기: 개인 도구를 시작할 때

## 가려운 곳에서 도구로 가는 과정

### 진짜 가려운 곳 식별하기

좋은 가려운 곳:

  • "이 작업을 하루에 10번 수동으로 한다"
  • "매번 30분씩 걸린다"
  • "X가 그냥 Y를 해줬으면 좋겠다"
  • "이게 왜 존재하지 않지?"

나쁜 가려운 곳 (보통):

  • "사람들이 이걸 원해야 해"
  • "이거 멋지겠다"
  • "시장이 있을 거야..."
  • "AI가 아마 할 수 있겠지..."

### 10분 테스트
| 질문 | 답변 |
|----------|--------|
| 문제를 한 문장으로 설명할 수 있나요? | 필수 |
| 이 문제를 매주 겪나요? | 반드시 예 |
| 수동으로 해결하려고 시도해 보셨나요? | 반드시 있음 |
| 매일 사용하시겠습니까? | 예여야 함 |

### 못생기게 시작하기

1일차: 당신의 문제를 해결하는 스크립트

  • UI 없음, 그냥 작동만 함
  • 하드코딩된 경로, 당신의 데이터
  • 오류 처리 제로
  • 모든 줄을 이해함

1주차: 안정적으로 작동하는 스크립트

  • 당신의 엣지 케이스 처리
  • 당신이 필요한 기능 추가
  • 여전히 못생겼지만 견고함

1개월: 다른 사람에게 도움이 될 수도 있는 도구

  • 기본 문서 (미래의 나를 위해)
  • 하드코딩 대신 설정
  • 공유 고려

CLI 도구 아키텍처

오래 지속되는 명령줄 도구 구축

사용 시기: 터미널 기반 도구를 구축할 때

## CLI 도구 스택

### Node.js CLI 스택
```javascript
// package.json
{
  "name": "my-tool",
  "version": "1.0.0",
  "bin": {
    "mytool": "./bin/cli.js"
  },
  "dependencies": {
    "commander": "^12.0.0",    // 인수 파싱
    "chalk": "^5.3.0",          // 색상
    "ora": "^8.0.0",            // 스피너
    "inquirer": "^9.2.0",       // 대화형 프롬프트
    "conf": "^12.0.0"           // 설정 저장소
  }
}

// bin/cli.js
#!/usr/bin/env node
import { Command } from 'commander';
import chalk from 'chalk';

const program = new Command();

program
  .name('mytool')
  .description('한 줄로 설명')
  .version('1.0.0');

program
  .command('do-thing')
  .description('작업 수행')
  .option('-v, --verbose', '상세 출력')
  .action(async (options) => {
    // 여기에 로직 작성
  });

program.parse();

Python CLI 스택

# Click 사용 (권장)
import click

@click.group()
def cli():
    """도구 설명."""
    pass

@cli.command()
@click.option('--name', '-n', required=True)
@click.option('--verbose', '-v', is_flag=True)
def process(name, verbose):
    """무언가를 처리합니다."""
    click.echo(f'{name} 처리 중')

if __name__ == '__main__':
    cli()

배포

방법복잡도도달 범위
npm publish낮음Node 개발자
pip install낮음Python 개발자
Homebrew tap중간Mac 사용자
바이너리 릴리스중간모든 사용자
Docker 이미지중간기술 사용자

### 로컬 우선 앱

오프라인에서 작동하고 데이터를 소유하는 앱

**사용 시기**: 개인 생산성 앱을 구축할 때

```python
## 로컬 우선 아키텍처

### 개인 도구를 위한 로컬 우선의 이유

장점:

  • 오프라인 작동
  • 데이터는 내 것
  • 서버 비용 없음
  • 즉시, 지연 없음
  • 영원히 작동 (종료 없음)

단점:

  • 동기화 어려움
  • 협업 불가 (초기)
  • 플랫폼별 작업

### 스택 옵션
| 스택 | 최적 대상 | 복잡도 |
|-------|----------|------------|
| Electron + SQLite | 데스크톱 앱 | 중간 |
| Tauri + SQLite | 가벼운 데스크톱 | 중간 |
| 브라우저 + IndexedDB | 웹 앱 | 낮음 |
| PWA + OPFS | 모바일 친화적 | 낮음 |
| CLI + JSON 파일 | 스크립트 | 매우 낮음 |

### 간단한 로컬 저장소
```javascript
// 간단한 도구를 위한 JSON 파일 저장소
import { readFileSync, writeFileSync, existsSync } from 'fs';
import { homedir } from 'os';
import { join } from 'path';

const DATA_DIR = join(homedir(), '.mytool');
const DATA_FILE = join(DATA_DIR, 'data.json');

function loadData() {
  if (!existsSync(DATA_FILE)) return { items: [] };
  return JSON.parse(readFileSync(DATA_FILE, 'utf8'));
}

function saveData(data) {
  if (!existsSync(DATA_DIR)) mkdirSync(DATA_DIR);
  writeFileSync(DATA_FILE, JSON.stringify(data, null, 2));
}

더 복잡한 도구를 위한 SQLite

// Node.js용 better-sqlite3
import Database from 'better-sqlite3';
import { join } from 'path';
import { homedir } from 'os';

const db = new Database(join(homedir(), '.mytool', 'data.db'));

// 첫 실행 시 테이블 생성
db.exec(`
  CREATE TABLE IF NOT EXISTS items (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT NOT NULL,
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
  )
`);

// 빠른 동기 쿼리
const items = db.prepare('SELECT * FROM items').all();

## 안티패턴

### ❌ 상상 속 사용자를 위해 만들기

**이유가 나쁨**: 실제 피드백 루프 없음.
아무도 필요로 하지 않는 기능 개발.
동기 부족으로 포기.
잘못된 문제 해결.

**대신**: 먼저 자신을 위해 만드세요.
실제 문제 = 실제 동기.
당신이 첫 번째 테스터입니다.
나중에 사용자를 확장하세요.

### ❌ 개인 도구 과잉 설계

**이유가 나쁨**: 만드는 데 영원히 걸림.
나중에 수정하기 어려움.
복잡성이 동기를 죽임.
완벽함이 완료의 적.

**대신**: 최소 실행 스크립트.
필요할 때 복잡성 추가.
아플 때만 리팩터링.
못생겼지만 작동 > 예쁘지만 미완성.

### ❌ 도그푸딩하지 않기

**이유가 나쁨**: 명백한 UX 문제 놓침.
실제 버그를 찾지 못함.
도움이 되지 않는 기능.
개선에 대한 열정 없음.

**대신**: 매일 도구를 사용하세요.
나쁜 UX의 고통을 느끼세요.
당신을 짜증나게 하는 것을 고치세요.
당신의 필요 = 사용자의 필요.

## ⚠️ 날카로운 모서리

| 문제 | 심각도 | 해결책 |
|-------|----------|----------|
| 도구가 특정 환경에서만 작동함 | 중간 | ## 도구 이식성 확보 |
| 설정이 관리 불가능해짐 | 중간 | ## 설정 다스리기 |
| 개인 도구가 관리되지 않음 | 낮음 | ## 지속 가능한 개인 도구 |
| 개인 도구의 보안 취약점 | 높음 | ## 개인 도구의 보안 |

## 관련 스킬

다음과 함께 잘 작동함: `micro-saas-launcher`, `browser-extension-builder`, `workflow-automation`, `backend`

## 사용 시기
이 스킬은 개요에 설명된 워크플로우나 액션을 실행하는 데 적용할 수 있습니다.

Individual skills in this repo

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

관련 스킬