NixOS AI Skill
AI 코딩 어시스턴트를 위한 자동 업데이트된 NixOS 및 Nix 문서입니다.
오픈 Agent Skills 표준(SKILL.md)을 사용합니다. Claude Code, Cursor, Windsurf, GitHub Copilot, OpenAI Codex, Gemini CLI, Amp, OpenCode, Cline, Aider, Goose, Roo Code 등 33개 이상의 AI 코딩 어시스턴트와 작동하며 더 많은 클라이언트도 지원합니다.
참고 자료는 GitHub Actions을 통해 네 개의 공식 NixOS 저장소에서 매일 자동 생성됩니다.
출처 (Sources)
설치 (Install)
빠른 시작 (Quick start)
AI 도구가 컨텍스트를 읽는 디렉터리에 클론합니다:
git clone https://github.com/marceloeatworld/nixos-ai-skill.git .cursor/skills/nixos
...
설치 스크립트를 이용하는 방법 (With the install script)
curl -fsSL https://raw.githubusercontent.com/marceloeatworld/nixos-ai-skill/main/install.sh | bash -s -- --claude
curl -fsSL https://raw.githubusercontent.com/marceloeatworld/nixos-ai-skill/main/install.sh | bash -s -- --cursor
curl -fsSL https://raw.githubusercontent.com/marceloeatworld/nixos-ai-skill/main/install.sh | bash -s -- --windsurf
...
모든 옵션은 ./install.sh --help를 실행하여 확인하세요.
업데이트 (Update)
git -C <install-path> pull
참고 자료는 GitHub Actions에 의해 매일 업데이트되므로, git pull을 실행하면 항상 최신 문서를 얻을 수 있습니다.
다루는 내용 (What it covers)
| 카테고리 | 주제 |
|---|
| 시작하기 | Nix 설치, NixOS 설치, 첫 단계, 업그레이드, FAQ, 용어집 |
| ... | |
작동 방식 (How it works)
User asks about NixOS / Nix
|
v
...
SKILL.md 파일은 라우팅 테이블 역할을 합니다: 주제를 참고 파일에 매핑하고 라이브 페칭을 위한 폴백(fallback) URL을 제공합니다.
references/ 디렉터리에는 요약본이 아닌, 네 개의 공식 NixOS 리포지토리에서 가져온 전체 수정되지 않은 문서가 포함되어 있습니다.
참조 자료 업데이트 방법
GitHub Actions 워크플로우가 매일 실행됩니다:
NixOS/nix.dev, NixOS/nix-pills, NixOS/release-wiki를 클론합니다 (얕은 복제).NixOS/nixpkgs에서 nixos/doc/manual/만 희소 체크아웃(Sparse-checkout)합니다.- 모든 참조 파일을 재생성하기 위해
scripts/generate-references.sh를 실행합니다.
- 변경된 사항이 있으면 커밋하고 푸시합니다.
수동으로도 재생성할 수 있습니다:
bash scripts/generate-references.sh
구조
nixos-ai-skill/
├── SKILL.md # 메인 명령어 파일 (주제 -> 참조 맵)
├── install.sh # 다중 도구 설치 스크립트
...
호환성
오픈 Agent Skills 표준(SKILL.md)을 기반으로 구축되었습니다. 다음의 33개 이상의 AI 코딩 도구와 호환됩니다:
| 도구 | 설치 경로 |
|---|
| 크로스 에이전트 표준 | .agents/skills/nixos |
| ... | |
목록에 없는 도구의 경우, 해당 도구가 컨텍스트/규칙을 읽어오는 디렉터리에 클론하십시오.
예시
> 플래크(flakes)를 사용하여 NixOS 구성을 설정하려면 어떻게 해야 하나요?
> nix-shell과 nix develop의 차이점은 무엇인가요?
> 내 NixOS 시스템에 사용자 지정 패키지를 추가하려면 어떻게 해야 하나요?
...
크레딧