flutter-ai-rules
무엇인가
flutter-ai-rules는 Flutter·Dart 애플리케이션을 다루는 AI 코딩 에이전트에 공식 문서 기반의 규칙과 절차를 주입하는 스킬 묶음이다. 상태 관리, 테스트와 코드 리뷰, Firebase 인증, 앱 아키텍처, 배포와 제품화 영역을 규율한다. 개인 선호나 임의 관례를 배제하고 Flutter·Dart·Firebase 및 각 패키지의 공식 문서에서만 내용을 끌어온다.
어떻게 동작하나
각 스킬은 SKILL.md 파일 하나를 담은 폴더다. 에이전트는 파일의 description을 읽고 현재 작업이 해당 스킬과 맞는지 스스로 판단해 지침을 끌어온다. 인증 코드를 만지면 Firebase Auth 지침이, 프로바이더를 만지면 Riverpod 지침이 로드되는 식이다. 규칙 파일에 내용을 붙여넣거나 @로 문서를 지목할 필요가 없고, 설치 후에는 별도 호출 없이 동작한다.
무엇과 다른가
프로젝트에 규칙 파일을 상시 두는 방식과 구조가 다르다. rules/·combined/ 같은 정적 파일은 매 요청마다 컨텍스트를 소비하지만, 스킬은 작업이 일치할 때만 로드된다. 프롬프트에 규칙을 직접 적는 방식과 달리 규칙이 저장소에 버전 관리되고 여러 에이전트가 같은 내용을 공유하며, 패키지별 지침이 해당 패키지를 다룰 때만 붙는다.
어떻게 쓰나
설치는 npx skills add evanca/flutter-ai-rules 한 줄이다. --list로 목록을 먼저 보거나 --skill로 특정 스킬만 설치할 수 있다. 플러그인 마켓플레이스 경로도 있다. Claude Code에서는 /plugin marketplace add evanca/flutter-ai-rules 뒤 /plugin install flutter-ai-skills@flutter-ai-rules를 실행하면 flutter-ai-skills:bloc 같은 이름으로 로드된다. 수동으로는 스킬 폴더를 .claude/skills/, .cursor/skills/, .codex/skills/, .agents/skills/, .windsurf/skills/에 복사하거나 심볼릭 링크한다.
전제와 한계
Skills CLI는 Node 22.20 이상을 요구하며 그 미만에서는 SyntaxError로 중단된다. 플러그인 설치와 수동 복사 경로는 Node 버전 제약이 없다. GitHub Copilot은 SKILL.md를 읽지 않으므로 rules/ 파일을 .github/instructions/에 두거나 combined/ 번들을 .github/copilot-instructions.md에 복사해야 한다. Windsurf·Devin은 플러그인 매니페스트가 없어 .agents/skills/ 수동 복사가 설치 경로다. Bloc·Riverpod·Firebase·Mockito 같은 패키지별 지침은 스킬에만 있고 rules/에는 포함되지 않는다.