Install
npx skills add vercel-labs/konsistent --skill konsistent-config누구를 위한가
TypeScript 저장소에 이미(또는 곧 쓸) 프로젝트급 구조 약속이 있고, CLI로 파일과 디렉터리가 그 패턴에 맞는지 검사하려는 사람에게 맞습니다. 공식 저장소는 https://github.com/vercel-labs/konsistent 입니다. files and directories가 match declared structural patterns인지 검사하며, ESLint, Biome, oxlint가 파일 안 스타일만 다루고 프로젝트급 구조를 검증하지 않는 빈틈을 메운다고 설명합니다. 예는 every provider package must export the same shape, 또는 every adapter must extend the base class. 또 하나의 코드 스타일 도구가 아닙니다.
먼저 konsistent.json를 쓰고 나서 validate / check하는 사람에게 더 맞습니다. 저장소에 아직 구조 약속이 없다면 첫 시도를 모든 파일을 자동으로 고치는 일로 이해하지 마세요. 자료는 어떤 에이전트 제품을 써야 한다고 쓰지 않았습니다.
3분 만에 첫 시도
스킬 주 경로는 먼저 설정 스킬을 설치합니다.
npx skills add vercel-labs/konsistent --skill konsistent-config
선행 조건: 현재 환경에서 npx를 실행할 수 있고, TypeScript 저장소에서 konsistent.json를 쓰거나 검사할 준비가 되어 있습니다. 자료는 Node 버전을 쓰지 않습니다. 디렉터리에 설정을 써도 되는지 확인한 뒤 실행하세요. 부작용은 konsistent-config 스킬이 설치되는 것입니다. 설치 후 스킬이 설정을 대조하거나 초안을 쓰게 하고, 업무 코드를 한꺼번에 바꾸지 마세요.
저위험 작업: 이 스킬을 이미 쓸 수 있는 에이전트에서 konsistent.json만 만들거나 검사한 뒤 공식 검증을 실행합니다.
konsistent validate
성공 신호는 설정 파일이 Validate the konsistent.json configuration file를 통과하는 것이며, 소스 여러 개가 이미 바뀐 것이 아닙니다. 아직 CLI가 없다면 자료의 개발 의존성 설치 예는 npm install konsistent --save-dev입니다. 쓰기를 허용한 저장소인지 확인한 뒤 실행하세요. 이 단계에서 수정 스킬을 돌리지 마세요.
인터페이스가 자료에 없는 키를 요구하거나 모든 패키지 관리자 설치 명령을 한꺼번에 돌리려 하면 즉시 멈추세요.
사용 사례
사례 1: 구조 약속을 선언하고 검증합니다. konsistent-config 스킬과 konsistent validate에 해당합니다. 아직 안정된 konsistent.json가 없고 패턴을 먼저 맞게 쓰고 싶은 사람에게 맞습니다. 설정 필드 목록은 없습니다. 확인할 수 있는 것은 먼저 설정, 그다음 validate입니다. 사례 1을 저장소 전체가 이미 통과한 것으로 쓰지 마세요.
사례 2: 약속에 따라 검사하거나 위반을 하나씩 봅니다. konsistent / konsistent check(Check structural conventions), 그리고 두 번째 스킬 npx skills add vercel-labs/konsistent --skill konsistent-fix-violations에 해당합니다. 설정 검증이 끝났고 어떤 파일이 패턴에 안 맞는지 보고 싶은 사람에게 맞습니다. check는 비교적 가역적입니다. fix-violations는 walks violations하며 파일 변경 위험이 있으므로 실행 전에 현재 브랜치 수정을 허용하는지 확인하세요. 자료는 자동 수정이 항상 안전하다고 쓰지 않았습니다.
사용 경계
ESLint, Biome, oxlint의 파일 안 규칙을 대체하지 않고 프로젝트급 구조만 보완합니다. 자료는 NPM, PNPM, Bun 세 가지 개발 의존성 설치를 동시에 줍니다. 첫 시도에서는 지금 쓰는 하나만 고르고 세 개를 모두 실행해야 한다고 보지 마세요. konsistent는 konsistent check의 줄임말이며 둘 다 쓸 수 있는 konsistent.json가 필요합니다. 게시, 포맷, 비 TypeScript 저장소에 대한 약속은 없습니다. 나타나지 않은 설치 방식은 보태지 마세요.