avoid-ai-writing
무엇인가
이 스킬은 산문에서 AI가 쓴 티가 나는 표현·구조·리듬을 찾아 표시하고 고쳐 쓰는 절차를 에이전트에 주입한다. 규율 대상은 챗봇 도입부("Certainly!"), 홍보성 수식어, 부풀린 의의, 우회 동사, 모호한 출처 표기, 일반론적 결론, 해시태그 나열, 빈 명사구 불릿, 플레이스홀더·인용 마크업·UTM 파라미터 같은 도구 지문이다. 재작성은 원문에 있는 사실만 남기고 근거 없는 전망은 삭제한다.
어떻게 동작하나
진입 파일은 SKILL.md이고, 감사 전에 references/patterns.md의 74개 패턴 카탈로그를 로드한다. scripts/, detector/, examples/는 선택적 기계 검증용이다. 모드는 셋이다. rewrite가 기본이며 2차 교정 패스를 내장하고, detect는 재작성 없이 표시만 하며, edit는 Edit 도구로 산문 파일을 제자리에서 최소 수정하고 소스 코드·설정·생성 데이터는 거부한다. --iterate N은 감사·재작성 주기를 반복하되 상한이 2다. 단어 대체 표는 3계층 112개 항목과 Tier 3 구문 10개로 구성된다. Tier 1은 빈도 표지(1A)와 명료성 교정(1B)으로 갈리고 1B는 가중치가 낮아 단순 문장 다듬기가 AI 판정을 밀어 올리지 못한다. Tier 2는 군집할 때, Tier 3는 고밀도일 때만 표시한다. 출력은 인용문·재작성문·변경 요약·2차 감사 네 절로 나뉜다.
무엇과 다른가
한 번짜리 "사람처럼 써줘" 프롬프트와 달리 판정 근거가 단어 표와 패턴 목록으로 외부화되어 있고, 패턴 개수는 CI가 카탈로그와 대조해 강제한다. detect 모드는 의도적으로 쓴 패턴일 수 있는 문서를 건드리지 않고 감사만 수행한다. edit 모드는 구조화 콘텐츠를 손상시킬 위험 때문에 코드·설정 파일을 거부하고 전체 파일 대신 수정 내역과 검증 보고만 돌려준다. CLAUDE.md에 규칙 몇 줄을 직접 쓰는 방식과 달리 SKILL.md와 references를 함께 두는 디렉터리 구조를 요구한다.
어떻게 쓰나
설치는 저장소를 스킬 디렉터리로 복제하는 방식이 기준이다. git clone https://github.com/conorbronsdon/avoid-ai-writing ~/.claude/skills/avoid-ai-writing 을 실행한 뒤 에이전트가 해당 디렉터리를 스킬로 인식하게 한다. 단일 파일 규칙 필드가 필요하면 dist/avoid-ai-writing.md를 내려받아 CLAUDE.md에서 경로를 참조하고, ~/.claude/commands/ 아래에 명령 파일을 만들어 슬래시 명령으로도 등록할 수 있다. 루트 SKILL.md만 가져오는 구형 설치기는 필수 참조 파일을 빠뜨리므로 쓰지 않는다.
전제와 한계
Claude Code, Cowork(플러그인), OpenClaw, Cursor(포팅 규칙), agentskills.io 호환 에이전트에서 동작한다. 디렉터리를 읽지 못하는 에이전트에서는 단일 파일 배포본과 수동 대체 절차를 써야 한다. edit 모드는 구조화 콘텐츠를 거부하므로 코드나 설정 정리에 쓸 수 없고, --iterate 상한이 2라 교정 패스를 더 얹을 수 없다. 판정이 표와 패턴 목록에 묶여 있으므로 목록에 없는 표현은 잡지 못한다.