# Lsp Setup

> Claude Code 의 LSP 툴이 Unity 프로젝트의 `.cs` 를 인식하도록 OmniSharp 를 설치·연결하는 자동 설정 스킬. `No LSP server available for file type: .cs` 응답을 받았거나, 처음 세팅할 때 에이전트가 자동 호출한다.

- **Type:** Skill
- **Install:** `agentstack add skill-zaffre001-unity-claude-template-lsp-setup`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [zaffre001](https://agentstack.voostack.com/s/zaffre001)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [zaffre001](https://github.com/zaffre001)
- **Source:** https://github.com/zaffre001/unity-claude-template/tree/main/.claude/skills/lsp-setup

## Install

```sh
agentstack add skill-zaffre001-unity-claude-template-lsp-setup
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Skill: /lsp-setup (LSP 자동 세팅)

프로그래밍을 몰라도 되게 설계됨. 아래 절차는 **에이전트가 실행**, 사용자는 brew 권한 프롬프트 1회 + Claude Code 재시작 1회만 눌러 주면 된다.

---

## 1. 왜 이게 필요한가

`/debug` 와 `/qa` 는 LSP 로 소스 구조 (심볼·참조·호출자) 를 읽는다. LSP 가 연결돼 있지 않으면 Grep 폴백으로 돌아가지만 정확도·속도가 떨어진다. Unity C# (.cs) 은 자동 연결 안 되므로 1회 세팅 필요.

> **핑거프린트:** `LSP.documentSymbol` 호출 시 `No LSP server available for file type: .cs` 응답 → 세팅 안 됨.

---

## 2. 에이전트 자동 실행 순서

아래 순서를 **그대로** 돌린다. 중간 실패 시 다음 스텝으로 넘어가지 말고 사용자에게 한 줄 보고.

### Step 1 — 현재 상태 점검
```bash
# 1-a) 이미 OmniSharp 설치됐는가
which omnisharp || echo "MISSING:omnisharp"

# 1-b) settings.json 에 LSP 활성화 플래그 있는가
grep -q '"ENABLE_LSP_TOOL"' .claude/settings.json 2>/dev/null || echo "MISSING:flag"
```

### Step 2 — OmniSharp 설치 (macOS)
`MISSING:omnisharp` 나왔으면:
```bash
brew install omnisharp
```
- 사용자 프롬프트 1회 발생 (brew 설치). 에이전트는 이 프롬프트가 뜬 직후 사용자에게 "OmniSharp 설치 권한을 눌러 주세요" 한 줄 고지.
- Windows/Linux 는 [공식 릴리즈](https://github.com/OmniSharp/omnisharp-roslyn/releases) 에서 바이너리 다운로드 후 PATH 에 추가 — 이건 사용자에게 링크 제시 후 위임.

### Step 3 — `.claude/settings.json` 에 LSP 활성화
파일이 없으면 새로 생성, 있으면 기존 키와 병합. `settings.local.json` 이 아니라 **`settings.json`** 에 쓴다 (프로젝트 공유 설정이라).

```json
{
  "env": {
    "ENABLE_LSP_TOOL": "1"
  },
  "enabledPlugins": {
    "omnisharp-lsp@claude-plugins-official": true
  }
}
```

> 플러그인 이름이 다를 수 있음. 위 이름으로 Step 4 에서 설치 실패 시 `claude plugin search omnisharp` 또는 `claude plugin search csharp` 로 대체 이름 확인.

### Step 4 — 플러그인 설치
```bash
claude plugin install omnisharp-lsp@claude-plugins-official
```
실패하면:
```bash
claude plugin search omnisharp    # 대체 이름 탐색
claude plugin search csharp
```
찾은 이름으로 재시도, 그에 맞춰 `settings.json` 의 `enabledPlugins` 키도 수정.

### Step 5 — Unity `.sln` 생성 확인
OmniSharp 는 `.sln` 또는 `.csproj` 가 있어야 프로젝트 인덱싱. Unity 는 Editor 가 열리면 자동 생성.

```bash
ls *.sln 2>/dev/null || echo "MISSING:sln"
```

`MISSING:sln` 이면:
- Unity Hub 에서 프로젝트 1회 열기 (사용자) → `.sln` / `Assembly-CSharp.csproj` 등 자동 생성
- 또는 `/run editor` 로 에이전트가 Editor 를 한 번 띄우면 자동 생성됨

### Step 6 — Claude Code 재시작
설정 반영 위해 **사용자가 Claude Code 재시작**. 에이전트는 이 시점에 작업 일시 중단하고 "LSP 활성화를 위해 Claude Code 를 재시작해 주세요. 재시작 후 이어서 진행합니다." 로 안내.

### Step 7 — 검증
재시작 후 첫 작업에서:
```
LSP.documentSymbol
  filePath=Assets/Scripts/_Core/Any.cs   # 프로젝트 안의 아무 .cs 파일
  line=1  character=1
```
- 심볼 목록 반환 → ✅ 세팅 성공
- `No LSP server available for file type: .cs` 여전 → Step 1 로 복귀, 어느 스텝이 안 먹혔는지 재점검.

---

## 3. 실패 시 대응 — Grep 폴백

세팅이 실패하거나 사용자가 재시작을 미루면 LSP 대신 **Grep 을 정적 평가 1순위로** 사용. `debug.md` §2 와 `qa.md` §3 의 Grep 스니펫이 모든 LSP 경로를 커버한다. 이 때 에이전트는 "LSP 미연결 상태 — Grep 폴백으로 진행" 을 세션 시작 시 1회 고지.

---

## 4. 금지 사항

- **사용자에게 개별 명령을 복붙 시키지 않는다.** 에이전트가 `Bash` 툴로 직접 돌린다. 사용자는 권한 프롬프트만 본다.
- **`brew install` 실패를 무시하고 넘어가지 않는다.** 실패 메시지 그대로 사용자에게 고지 후 중단.
- **`settings.local.json` 에 쓰지 않는다** — 그 파일은 개인 설정 (.gitignore). LSP 는 프로젝트 공유 설정이 맞으므로 `settings.json`.
- **`.sln` 없다고 수동으로 만들지 않는다.** Unity 에디터가 생성하게 한다. 수동 생성은 어셈블리 참조가 어긋난다.

---

## 5. 참고

- 이 스킬의 설치 파라미터는 [Claude Code 플러그인 레지스트리](https://code.claude.com/docs/en/plugins-reference.md) 기반. 레지스트리 이름 변경 시 Step 4 의 대체 검색으로 대응.
- OmniSharp 는 deprecated 권고가 있지만 2026-04 기준 Unity C# 에 여전히 가장 안정. 대체로 Microsoft 공식 **Roslyn Language Server** 도 있지만 C# Dev Kit VSIX 번들이라 Claude Code 직접 사용은 설정 복잡.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [zaffre001](https://github.com/zaffre001)
- **Source:** [zaffre001/unity-claude-template](https://github.com/zaffre001/unity-claude-template)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-zaffre001-unity-claude-template-lsp-setup
- Seller: https://agentstack.voostack.com/s/zaffre001
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.