스킬

naskah-id: 인도네시아어 학술 작성 및 편집을 위한 AI Agent Skill

인도네시아어로 학술지 논문, 학위논문, 연구비 신청서 등 학술 텍스트를 작성·편집하며 EYD V와 KBBI 규범을 따르는 데 가장 적합합니다. Node.js 18+ agent 환경이 필요하며, 데이터나 문헌을 절대 날조하지 않고 인용이 없으면 보완 대기 마커를 남깁니다.

Official source · nothinx/naskah-id

Install

npx skills add nothinx/naskah-id

누구에게 적합한가

naskah-id는 인도네시아어 학술 작성을 위한 AI agent Skill로, 다음과 같은 텍스트를 작성하거나 편집해야 하는 사람에게 적합합니다: 학술지 논문, 졸업논문(skripsi/tesis), 연구비 신청서, 연구 보고서. EYD V(제5판 철자 규범)와 KBBI 어휘 표준이 내장되어 있으며, 학술적 성실성 제약을 강조합니다: 바인딩된 agent는 데이터, 결과, 인용 또는 참고문헌을 지어내서는 안 되고, 편집 시 숫자·결과·인용을 변경해서는 안 됩니다. 검증 가능한 문헌이 없으면 출처를 날조하는 대신 [PERLU RUJUKAN: ...] 마커를 기록합니다.

적합하지 않은 경우: 인도네시아어가 아닌 작성 작업, 또는 AI가 실제 문헌을 자동으로 보완해 주기를 기대하는 경우입니다. 이 Skill은 날조를 명확히 금지하며, 문헌은 여전히 직접 확인해야 합니다.

3분 만에 첫 시도 완료하기

공식적으로 권장되는 설치 방법은 한 줄 명령입니다:

npx skills add nothinx/naskah-id

전제 조건과 설치 위치:

  • Node.js 18 이상이 필요합니다.
  • 위의 -g 없는 명령은 현재 프로젝트에 Skill을 설치하고, -g를 붙이면(npx skills add nothinx/naskah-id -g) 모든 프로젝트에 적용됩니다.
  • 공식 설명에 따르면 이 명령은 Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf, OpenCode, Cline, Kiro, Antigravity 및 Agent Skills 형식을 지원하는 수십 가지 agent에 적용됩니다. 일부 agent는 -a 매개변수로 설치 경로를 지정할 수 있으며, 예를 들어 Claude Code는 .claude/skills/naskah-id에 해당합니다.

첫 번째 저위험 시도(검사류 작업부터 권장):

  1. Skill이 설치된 프로젝트에서 이를 지원하는 agent가 naskah-id를 로드하도록 합니다.
  2. 읽기 전용 진단 작업을 요청합니다: 인도네시아어 학술 텍스트(예: 논문 단락, Markdown 또는 일반 텍스트 모두 가능)를 agent에게 전달하고 EYD V와 KBBI에 따라 철자와 용어를 검사하되, 우선 파일을 수정하지 않도록 합니다. "보고서만 제공하고 파일에 쓰지 말 것"을 명확히 지시합니다.
  3. 성공 신호: agent가 학술 규범에 따라 철자, 용어 또는 구조에 대한 진단 의견을 제시합니다. 문헌이 관련되면 날조된 인용 대신 [PERLU RUJUKAN: ...] 마커가 나타나야 합니다.

주의: agent가 Skill을 로드한 후 파일을 읽고 쓰거나 명령을 실행하거나 네트워크에 접근하는지에 대해서는 공식 증거가 항목별로 설명하지 않으므로, 무위험이라고 가정하지 마십시오. 파일 수정이 포함된 작업 전에 부작용을 확인하고 백업을 확보하십시오.

또한 저장소에는 scripts/periksa.py(선택 사항, Python 3.7+ 필요, 추가 의존성 없음)가 포함되어 있습니다: python scripts/periksa.py naskah.md를 실행하면 어떤 모델도 호출하지 않고 원고의 위반 패턴과 AI 특유의 문체를 표시할 수 있습니다. 이는 agent를 거치지 않는 독립 로컬 검사로, 첫 시도 전의 빠른 사전 검토로 활용할 수 있습니다. Skill에는 문헌을 찾고 검증하는 데 사용되는 scripts/openalex.py(계정 불필요)도 함께 제공됩니다.

사용 사례

사례 1: 논문 단락이 규범에 맞는지 검사. 인도네시아어 학술지 투고 텍스트의 한 단락을 Skill이 설치된 agent에게 전달하고, EYD V와 KBBI에 따른 편집 진단을 요청합니다. agent는 제약을 따릅니다: 숫자·결과·인용을 변경하지 않고, 어떤 내용도 지어내지 않으며, 검증 가능한 문헌이 없는 곳에는 [PERLU RUJUKAN: ...]로 표시합니다. 철자와 용어 수준의 수정 제안을 받을 수 있으며, 숫자와 인용은 원본 그대로 유지됩니다.

사례 2: 검증 가능한 문헌 찾기. agent가 함께 제공된 scripts/openalex.py(계정 불필요)를 사용하여 논문 주제와 관련된 참고문헌을 검색하고 기존 인용을 검증하도록 합니다. OpenAlex 검색을 도와줄 수 있다는 점은 확인할 수 있습니다. 검색 결과의 정확성과 후속 쓰기 작업은 사용 전에 agent와 확인하십시오. 검색 결과를 원고에 직접 쓰게 하지 마십시오.

사용 경계

  • 파일 및 명령 접근: scripts/periksa.py와 scripts/openalex.py는 로컬 스크립트이며, 전자는 Python 3.7+가 필요하고 후자는 문헌 검색용입니다(외부 서비스 OpenAlex 접근 포함). agent가 Skill을 로드한 후 이 스크립트를 자동 실행하거나 파일을 읽고 쓰는지는 증거가 항목별로 설명하지 않습니다.
  • 부작용과 확인 지점: 편집류 작업은 수정된 텍스트를 생성할 수 있습니다. 파일을 직접 수정한다는 증거는 없습니다. 파일을 변경하거나 외부 서비스를 호출하는 모든 동작은 영향 범위를 먼저 명확히 하고 확인하십시오.
  • 실행 환경과 클라이언트 전제: 설치 명령은 Node.js 18+가 필요하며, Agent Skills 형식을 지원하는 agent(예: Claude Code, Cursor 등)를 통해 사용합니다.
  • 공식 명시 제한: 데이터·결과·인용·참고문헌을 지어내서는 안 되고, 편집 시 숫자·결과·인용을 변경해서는 안 되며, 신뢰할 수 있는 출처가 없을 때는 [PERLU RUJUKAN: ...] 마커를 사용합니다.
  • 아직 확인되지 않음: 인도네시아어 외 텍스트 지원 여부, 구체적인 파일 읽기/쓰기 및 네트워크 동작 세부 사항, 그리고 각 agent에서의 실제 효과 차이는 설치 후 직접 테스트한 결과를 기준으로 합니다.