algokit-mcp 1.0.2 → 1.0.4

package/dist/utils/claudecode-skill-installer.js

@@ -0,0 +1,70 @@
+import { existsSync, readFileSync, writeFileSync, readdirSync } from 'fs';
+import { mkdir, cp } from 'fs/promises';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { homedir } from 'os';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * MCP 등록 방식(로컬/전역)에 따라 스킬 설치 대상 디렉토리를 결정합니다.
+ *
+ * - `claude mcp add algokit ...` (로컬): 프로젝트 루트에 .mcp.json 존재
+ *   → <cwd>/.claude/skills/
+ * - `claude mcp add --global algokit ...` (전역): .mcp.json 없음
+ *   → ~/.claude/skills/
+ */
+function detectInstallTarget() {
+    const localMcpJson = join(process.cwd(), '.mcp.json');
+    if (existsSync(localMcpJson)) {
+        return join(process.cwd(), '.claude', 'skills');
+    }
+    return join(homedir(), '.claude', 'skills');
+}
+/**
+ * Claude Code가 설치된 환경인지 확인합니다.
+ * skills는 Claude Code 전용 개념이므로 다른 클라이언트(Codex, Gemini 등)에서는 설치를 건너뜁니다.
+ *
+ * 감지 기준:
+ * - ~/.claude/ 디렉토리 존재 → Claude Code 전역 설치됨
+ * - 로컬 .mcp.json 존재 → Claude Code 로컬 프로젝트 설정
+ */
+function isClaudeCodeEnvironment() {
+    const globalClaudeDir = join(homedir(), '.claude');
+    const localMcpJson = join(process.cwd(), '.mcp.json');
+    return existsSync(globalClaudeDir) || existsSync(localMcpJson);
+}
+/**
+ * 패키지에 동봉된 skills/를 적절한 위치에 설치합니다.
+ * Claude Code 환경이 아니거나 이미 같은 버전이 설치되어 있으면 건너뜁니다.
+ */
+export async function ensureSkillsInstalled() {
+    if (!isClaudeCodeEnvironment())
+        return;
+    // dist/utils/ → ../../skills (패키지 루트의 skills 디렉토리)
+    const skillsSrc = join(__dirname, '../../skills');
+    if (!existsSync(skillsSrc))
+        return;
+    const targetDir = detectInstallTarget();
+    // 버전 파일로 중복 설치 방지
+    const pkgPath = join(__dirname, '../../package.json');
+    const { version } = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+    const versionFile = join(targetDir, '.algokit-skills-version');
+    if (existsSync(versionFile)) {
+        const installedVersion = readFileSync(versionFile, 'utf-8').trim();
+        if (installedVersion === version)
+            return;
+    }
+    await mkdir(targetDir, { recursive: true });
+    // 기존 .claude/skills/에 다른 스킬이 있을 수 있으므로
+    // algokit 스킬 디렉토리(algo:*)만 선택적으로 복사
+    const skillDirs = readdirSync(skillsSrc);
+    for (const skillDir of skillDirs) {
+        await cp(join(skillsSrc, skillDir), join(targetDir, skillDir), {
+            recursive: true,
+            force: true,
+        });
+    }
+    writeFileSync(versionFile, version);
+    process.stderr.write(`[algokit] skills v${version} installed → ${targetDir}\n`);
+}
+//# sourceMappingURL=claudecode-skill-installer.js.map

package/dist/utils/claudecode-skill-installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claudecode-skill-installer.js","sourceRoot":"","sources":["../../src/utils/claudecode-skill-installer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AAC1E,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAE7B,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC;;;;;;;GAOG;AACH,SAAS,mBAAmB;IAC1B,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,CAAC,CAAC;IACtD,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,uBAAuB;IAC9B,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,CAAC,CAAC;IACtD,OAAO,UAAU,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,IAAI,CAAC,uBAAuB,EAAE;QAAE,OAAO;IAEvC,mDAAmD;IACnD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAClD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO;IAEnC,MAAM,SAAS,GAAG,mBAAmB,EAAE,CAAC;IAExC,kBAAkB;IAClB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;IACtD,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/D,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,yBAAyB,CAAC,CAAC;IAE/D,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5B,MAAM,gBAAgB,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QACnE,IAAI,gBAAgB,KAAK,OAAO;YAAE,OAAO;IAC3C,CAAC;IAED,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,uCAAuC;IACvC,oCAAoC;IACpC,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IACzC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE;YAC7D,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;IACL,CAAC;IAED,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,OAAO,gBAAgB,SAAS,IAAI,CAAC,CAAC;AAClF,CAAC"}

package/dist/utils/skill-installer.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 패키지에 동봉된 skills/를 적절한 위치에 설치합니다.
+ * Claude Code 환경이 아니거나 이미 같은 버전이 설치되어 있으면 건너뜁니다.
+ */
+export declare function ensureSkillsInstalled(): Promise<void>;
+//# sourceMappingURL=skill-installer.d.ts.map

package/dist/utils/skill-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-installer.d.ts","sourceRoot":"","sources":["../../src/utils/skill-installer.ts"],"names":[],"mappings":"AAuCA;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAiC3D"}

package/dist/utils/skill-installer.js

@@ -0,0 +1,70 @@
+import { existsSync, readFileSync, writeFileSync, readdirSync } from 'fs';
+import { mkdir, cp } from 'fs/promises';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { homedir } from 'os';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * MCP 등록 방식(로컬/전역)에 따라 스킬 설치 대상 디렉토리를 결정합니다.
+ *
+ * - `claude mcp add algokit ...` (로컬): 프로젝트 루트에 .mcp.json 존재
+ *   → <cwd>/.claude/skills/
+ * - `claude mcp add --global algokit ...` (전역): .mcp.json 없음
+ *   → ~/.claude/skills/
+ */
+function detectInstallTarget() {
+    const localMcpJson = join(process.cwd(), '.mcp.json');
+    if (existsSync(localMcpJson)) {
+        return join(process.cwd(), '.claude', 'skills');
+    }
+    return join(homedir(), '.claude', 'skills');
+}
+/**
+ * Claude Code가 설치된 환경인지 확인합니다.
+ * skills는 Claude Code 전용 개념이므로 다른 클라이언트(Codex, Gemini 등)에서는 설치를 건너뜁니다.
+ *
+ * 감지 기준:
+ * - ~/.claude/ 디렉토리 존재 → Claude Code 전역 설치됨
+ * - 로컬 .mcp.json 존재 → Claude Code 로컬 프로젝트 설정
+ */
+function isClaudeCodeEnvironment() {
+    const globalClaudeDir = join(homedir(), '.claude');
+    const localMcpJson = join(process.cwd(), '.mcp.json');
+    return existsSync(globalClaudeDir) || existsSync(localMcpJson);
+}
+/**
+ * 패키지에 동봉된 skills/를 적절한 위치에 설치합니다.
+ * Claude Code 환경이 아니거나 이미 같은 버전이 설치되어 있으면 건너뜁니다.
+ */
+export async function ensureSkillsInstalled() {
+    if (!isClaudeCodeEnvironment())
+        return;
+    // dist/utils/ → ../../skills (패키지 루트의 skills 디렉토리)
+    const skillsSrc = join(__dirname, '../../skills');
+    if (!existsSync(skillsSrc))
+        return;
+    const targetDir = detectInstallTarget();
+    // 버전 파일로 중복 설치 방지
+    const pkgPath = join(__dirname, '../../package.json');
+    const { version } = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+    const versionFile = join(targetDir, '.algokit-skills-version');
+    if (existsSync(versionFile)) {
+        const installedVersion = readFileSync(versionFile, 'utf-8').trim();
+        if (installedVersion === version)
+            return;
+    }
+    await mkdir(targetDir, { recursive: true });
+    // 기존 .claude/skills/에 다른 스킬이 있을 수 있으므로
+    // algokit 스킬 디렉토리(algo:*)만 선택적으로 복사
+    const skillDirs = readdirSync(skillsSrc);
+    for (const skillDir of skillDirs) {
+        await cp(join(skillsSrc, skillDir), join(targetDir, skillDir), {
+            recursive: true,
+            force: true,
+        });
+    }
+    writeFileSync(versionFile, version);
+    process.stderr.write(`[algokit] skills v${version} installed → ${targetDir}\n`);
+}
+//# sourceMappingURL=skill-installer.js.map

package/dist/utils/skill-installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-installer.js","sourceRoot":"","sources":["../../src/utils/skill-installer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AAC1E,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAE7B,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC;;;;;;;GAOG;AACH,SAAS,mBAAmB;IAC1B,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,CAAC,CAAC;IACtD,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,uBAAuB;IAC9B,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,CAAC,CAAC;IACtD,OAAO,UAAU,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,IAAI,CAAC,uBAAuB,EAAE;QAAE,OAAO;IAEvC,mDAAmD;IACnD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAClD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO;IAEnC,MAAM,SAAS,GAAG,mBAAmB,EAAE,CAAC;IAExC,kBAAkB;IAClB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;IACtD,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/D,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,yBAAyB,CAAC,CAAC;IAE/D,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5B,MAAM,gBAAgB,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QACnE,IAAI,gBAAgB,KAAK,OAAO;YAAE,OAAO;IAC3C,CAAC;IAED,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,uCAAuC;IACvC,oCAAoC;IACpC,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IACzC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE;YAC7D,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;IACL,CAAC;IAED,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,OAAO,gBAAgB,SAAS,IAAI,CAAC,CAAC;AAClF,CAAC"}

package/dist/utils/tier-converter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tier-converter.d.ts","sourceRoot":"","sources":["../../src/utils/tier-converter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAOb,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,UAAU,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAwBjD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAgB/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAalD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAqF1D"}
+{"version":3,"file":"tier-converter.d.ts","sourceRoot":"","sources":["../../src/utils/tier-converter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAOb,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,UAAU,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAwBjD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAgB/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAgBlD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAqF1D"}

package/dist/utils/tier-converter.js

@@ -92,6 +92,9 @@ export function tierToLevelRange(tier) {
  * getTierBadge(6)  // "⚪ Silver V"
  */
 export function getTierBadge(level) {
+    // level 0 = 미분류(Unrated)
+    if (level === 0)
+        return '⬜ Unrated';
     // levelToTier에서 검증 수행
     const tierName = levelToTier(level);
     // 티어 그룹 찾기

package/dist/utils/tier-converter.js.map

@@ -1 +1 @@
-{"version":3,"file":"tier-converter.js","sourceRoot":"","sources":["../../src/utils/tier-converter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tier-converter.js","sourceRoot":"","sources":["../../src/utils/tier-converter.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "algokit-mcp",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -26,7 +26,8 @@
     "study-helper"
   ],
   "files": [
-    "dist"
+    "dist",
+    "skills"
   ],
   "author": "itsme-shawn <chs98105@gmail.com>",
   "license": "MIT",
@@ -45,14 +46,12 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.26.0",
     "cheerio": "^1.2.0",
-    "puppeteer": "^24.37.3",
     "zod": "3.25.76",
     "zod-to-json-schema": "^3.25.1"
   },
   "devDependencies": {
     "@types/cheerio": "^0.22.35",
     "@types/node": "^25.2.3",
-    "@types/puppeteer": "^5.4.7",
     "@vitest/coverage-v8": "^4.0.18",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",

package/skills/algo:code-review/SKILL.md

@@ -0,0 +1,134 @@
+---
+name: algo:code-review
+description: 백준(BOJ) 또는 프로그래머스 풀이 코드 분석 및 피드백. 정확성·복잡도 검토, 디버깅, 코드 리뷰가 필요할 때 사용.
+---
+
+# algo:code-review - 알고리즘 코드 분석
+
+백준(BOJ)과 프로그래머스 문제 풀이 코드를 분석하고 개선점을 제안하는 스킬입니다.
+
+## 사용법
+
+```
+/algo:code-review <문제식별자> [분석타입]
+```
+
+**예시:**
+- `/algo:code-review boj 1003` - BOJ 1003번 풀이 분석
+- `/algo:code-review programmers 42748 ` - 프로그래머스 42748번 풀이 분석
+- `/algo:code-review 1003` - 숫자만 입력 → 플랫폼 질문
+- `/algo:code-review https://www.acmicpc.net/problem/1003` - URL → BOJ 확정, 전체 분석
+- `/algo:code-review https://school.programmers.co.kr/learn/courses/30/lessons/42748 debug` - URL → 프로그래머스, 디버깅
+
+## 플랫폼 판별 규칙
+
+| 입력 패턴 | 플랫폼 | 예시 |
+|-----------|--------|------|
+| `acmicpc.net` URL | BOJ | `https://www.acmicpc.net/problem/1003` |
+| `school.programmers.co.kr` URL | Programmers | `https://school.programmers.co.kr/...` |
+| **숫자만 입력** | **→ 반드시 되묻기** | `1003`, `42748` |
+
+단, **대화 맥락에서 플랫폼이 이미 확인된 경우** (예: "백준 1003번 풀다가 막혔어")에는 되묻지 않고 그 플랫폼으로 진행합니다.
+
+> ⚠️ **맥락이 없는 숫자 입력은 절대 임의로 플랫폼을 추정하지 않습니다.**
+
+## 동작 방식
+
+1. **플랫폼 판별**: 위 규칙 적용 → 불명확하면 즉시 되묻기
+2. **사용자 코드 입력 요청**: 언어와 코드 받기
+3. **MCP 도구 실행**: 플랫폼별 `analyze_code_submission_*` 사용
+4. **분석 결과 제공**:
+   - 문제 요구사항과 비교
+   - 시간/공간 복잡도 분석
+   - 개선점 제안
+   - 디버깅 가이드
+
+## MCP 도구 사용
+
+### BOJ
+
+```
+algokit/analyze_code_submission_boj {
+  problem_id: 1003,
+  code: "def fib(n):\n    ...",
+  language: "python",
+  analysis_type: "full"
+}
+```
+
+### 프로그래머스
+
+```
+algokit/analyze_code_submission_programmers {
+  problem_id: 42748,
+  code: "def solution(array, commands):\n    ...",
+  language: "python",
+  analysis_type: "full"
+}
+```
+
+## 분석 타입
+
+| 타입 | 설명 | 포함 내용 |
+|------|------|-----------|
+| `full` | 전체 분석 (기본값) | 정확성, 복잡도, 개선점, 스타일 |
+| `hint` | 힌트 제공 | 핵심 개념, 접근 방법, 방향 제시 |
+| `debug` | 디버깅 중심 | 에러 원인, 로직 오류, 엣지 케이스 |
+| `review` | 코드 리뷰 | 스타일, 가독성, 네이밍, 구조 |
+
+
+## 대화형 프로세스
+
+1. **코드 요청**:
+   ```
+   AI: 분석할 코드를 보여주세요. 언어도 함께 알려주세요 (python/cpp/java/js/go)
+   ```
+
+2. **분석 타입 선택** (미지정 시):
+   ```
+   AI: 어떤 분석이 필요하신가요?
+   1. 전체 분석 (정확성 + 복잡도 + 개선점)
+   2. 디버깅 (왜 틀렸는지)
+   3. 힌트 (어떻게 풀어야 하는지)
+   4. 코드 리뷰 (스타일 개선)
+   ```
+
+3. **MCP 도구 실행 및 결과 제시**:
+   ```
+   ## 분석 결과
+
+   ### ✅ 정확성
+   - 문제 요구사항을 충족합니다
+
+   ### ⏱️ 복잡도
+   - 시간: O(n) ✅
+   - 공간: O(n)
+
+   ### 💡 개선점
+   1. ...
+   ```
+
+## 주의사항
+
+- ✅ 코드는 반드시 사용자에게 입력받기 (추측 금지)
+- ✅ 숫자만 입력된 경우 플랫폼 확인 후 진행
+- ✅ 대화 맥락에서 플랫폼이 이미 확인된 경우 그 맥락 활용
+- ✅ 분석 결과는 건설적이고 친절하게
+- ✅ 개선점 제안 시 "왜"를 설명
+- ❌ 맥락 없이 플랫폼 임의 추정 금지
+- ❌ 코드를 함부로 완전히 재작성하지 않기
+- ❌ `hint` 타입 외에는 문제 정답 직접 제공 금지
+
+## 에러 처리
+
+| 에러 | 원인 | 해결 |
+|------|------|------|
+| 언어 미지원 | 지원 언어 외 | 지원 언어로 변환 요청 |
+| 코드 없음 | 코드 미제공 | 전체 코드 요청 |
+| 문제 없음 | 잘못된 번호 | 번호/URL 확인 |
+
+## 관련 스킬
+
+- `/algo:fetch` - 문제 본문 크롤링 (내부 자동 호출)
+- `/algo:hint` - 코드 없이 힌트만 받기
+- `/algo:review` - 풀이 후 복습 문서 작성

package/skills/algo:fetch/SKILL.md

@@ -0,0 +1,102 @@
+---
+name: algo:fetch
+description: 백준(BOJ) 또는 프로그래머스 문제 본문 크롤링. 문제 내용, 입출력 형식, 예제를 확인할 때 사용.
+---
+
+# algo:fetch - 알고리즘 문제 본문 크롤링
+
+백준(BOJ)과 프로그래머스 문제의 전문을 가져오는 스킬입니다.
+
+## 사용법
+
+```
+/algo:fetch <문제식별자>
+```
+
+**예시:**
+- `/algo:fetch 1003` - 숫자만 입력 → 플랫폼 질문
+- `/algo:fetch https://www.acmicpc.net/problem/1003` - URL → BOJ 확정
+- `/algo:fetch https://school.programmers.co.kr/learn/courses/30/lessons/42748` - URL → 프로그래머스 확정
+
+## 플랫폼 판별 규칙
+
+| 입력 패턴 | 플랫폼 | 예시 |
+|-----------|--------|------|
+| `acmicpc.net` URL | BOJ | `https://www.acmicpc.net/problem/1003` |
+| `school.programmers.co.kr` URL | Programmers | `https://school.programmers.co.kr/...` |
+| **숫자만 입력** | **→ 반드시 되묻기** | `1003`, `42748` |
+
+단, **대화 맥락에서 플랫폼이 이미 확인된 경우** (예: "백준 1003번 풀고 있어")에는 되묻지 않고 그 플랫폼으로 진행합니다.
+
+> ⚠️ **맥락이 없는 숫자 입력은 절대 임의로 플랫폼을 추정하지 않습니다.**
+
+## 동작 방식
+
+1. **플랫폼 판별**: 위 규칙 적용 → 불명확하면 즉시 되묻기
+2. **MCP 도구 호출**: 플랫폼별 `fetch_problem_content_*` 실행
+3. **구조화된 데이터 반환**:
+   - 문제 제목, 설명
+   - 입출력 형식
+   - 예제 입출력
+   - 시간/메모리 제한 (BOJ) 또는 제한사항 (Programmers)
+   - 메타데이터
+
+## MCP 도구 사용
+
+### BOJ
+
+```
+algokit/fetch_problem_content_boj { problem_id: 1003 }
+```
+
+크롤링 대상: `https://www.acmicpc.net/problem/{ID}`
+
+### 프로그래머스
+
+```
+# 숫자 ID로
+algokit/fetch_problem_content_programmers { problem_id: 42748 }
+
+# URL로
+algokit/fetch_problem_content_programmers {
+  problem_id: "https://school.programmers.co.kr/learn/courses/30/lessons/42748"
+}
+```
+
+크롤링 대상: `https://school.programmers.co.kr/learn/courses/30/lessons/{ID}`
+
+## 크롤링 제한사항
+
+| 항목 | BOJ | Programmers |
+|------|-----|-------------|
+| 타임아웃 | 10초 | 10초 |
+| 재시도 | 최대 2회 | 최대 2회 |
+| 캐시 | 30일 | 30일 |
+
+## 에러 처리
+
+| 에러 | 원인 | 해결 |
+|------|------|------|
+| NOT_FOUND | 문제 번호가 없음 | 번호/URL 확인 |
+| TIMEOUT | 10초 초과 | 재시도 |
+| PARSE_ERROR | HTML 구조 변경 | 이슈 리포트 |
+
+## 사용 시나리오
+
+1. **문제 풀이 전 확인**: 입출력 예제, 제한 조건 파악
+2. **문제 복습 시 참조**: 요구사항 재확인
+3. **코드 분석 시 비교**: `/algo:code-review`와 연계
+
+## 주의사항
+
+- ✅ 숫자만 입력된 경우 플랫폼 확인 후 진행
+- ✅ 대화 맥락에서 플랫폼이 이미 확인된 경우 그 맥락 활용
+- ✅ 문제 본문 필요 시에만 사용 (서버 부하 최소화)
+- ❌ 맥락 없이 플랫폼 임의 추정 금지
+- ⚠️ 웹사이트 HTML 구조 변경 시 파싱 실패 가능
+
+## 관련 스킬
+
+- `/algo:hint` - 문제 힌트 생성 (내부적으로 fetch 활용)
+- `/algo:code-review` - 코드와 문제 요구사항 비교 분석
+- `/algo:review` - 복습 템플릿 생성

package/skills/algo:hint/SKILL.md

@@ -0,0 +1,111 @@
+---
+name: algo:hint
+description: 백준(BOJ) 또는 프로그래머스 알고리즘 문제의 단계별 힌트 생성. 문제가 막히거나 접근 방향이 필요할 때 사용.
+---
+
+# algo:hint - 알고리즘 문제 힌트 생성
+
+백준(BOJ)과 프로그래머스 문제를 분석하고 단계별 힌트를 제공하는 스킬입니다.
+
+## 사용법
+
+```
+/algo:hint <문제식별자>
+```
+
+**예시:**
+- `/algo:hint 1003` - 숫자만 입력 → 플랫폼 질문
+- `/algo:hint https://school.programmers.co.kr/learn/courses/30/lessons/42748` - URL → 프로그래머스 확정
+- `/algo:hint https://www.acmicpc.net/problem/1003` - URL → BOJ 확정
+
+## 플랫폼 판별 규칙
+
+| 입력 패턴 | 플랫폼 | 예시 |
+|-----------|--------|------|
+| `acmicpc.net` URL | BOJ | `https://www.acmicpc.net/problem/1003` |
+| `school.programmers.co.kr` URL | Programmers | `https://school.programmers.co.kr/...` |
+| **숫자만 입력** | **→ 반드시 되묻기** | `1003`, `42748` |
+
+단, **대화 맥락에서 플랫폼이 이미 확인된 경우** (예: "백준 문제 풀고 있어", 직전에 BOJ 문제를 함께 논의 중)에는 되묻지 않고 그 플랫폼으로 진행합니다.
+
+> ⚠️ **맥락이 없는 숫자 입력은 절대 임의로 플랫폼을 추정하지 않습니다.**
+
+## 동작 방식
+
+1. **플랫폼 판별**: 위 규칙 적용 → 불명확하면 즉시 되묻기
+2. **MCP 도구 호출**: 플랫폼별 `analyze_problem_*` 실행
+3. **분석 정보 수신**: 난이도, 태그, 힌트 가이드 프롬프트
+4. **사용자 상황 파악**: 현재 진행 상황 분석
+5. **단계별 힌트 제공** (한 번에 1개 레벨)
+
+## MCP 도구 사용
+
+### BOJ
+
+```
+algokit/analyze_problem_boj { problem_id: 1003 }
+```
+
+필요 시 문제 본문도 확인:
+```
+algokit/fetch_problem_content_boj { problem_id: 1003 }
+```
+
+### 프로그래머스
+
+```
+algokit/analyze_problem_programmers { problem_id: 42748 }
+```
+
+필요 시 문제 본문도 확인:
+```
+algokit/fetch_problem_content_programmers { problem_id: 42748 }
+```
+
+## 힌트 레벨 선택 가이드
+
+사용자 상황을 파악하고 **단 1개 레벨만** 제공:
+
+| 상황 | 레벨 | 판단 기준 |
+|------|------|-----------|
+| 처음 시도 / 막힘 | Level 1 | 코드 없음, "어떻게 시작?", "접근법?" |
+| 일부 구현 완료 | Level 2 | 코드 작성 중, "더 필요해", "구현 막힘" |
+| 정답 요청 | Level 3 | "정답", "풀이", "코드 보여줘" 명시 |
+
+## 힌트 제공 프로세스
+
+1. **상황 파악**:
+   ```
+   AI: 어디서 막히셨나요? 코드가 있으시면 보여주세요.
+   ```
+
+2. **Level 1 제공** (처음 막힌 경우):
+   ```
+   hint_levels[0].prompt를 활용해 접근법 안내
+   ```
+
+3. **Level 2 제공** (추가 요청 시):
+   ```
+   hint_levels[1].prompt를 활용해 핵심 로직 안내
+   ```
+
+4. **Level 3 제공** (명시적 요청 시):
+   ```
+   hint_levels[2].prompt를 활용해 상세 구현 가이드 제공
+   ```
+
+## 주의사항
+
+- ❌ 3개 레벨 동시 제공 금지
+- ✅ 사용자 상황 분석 후 1개 레벨만 선택
+- ✅ 프롬프트 가이드를 활용해 문제별 맞춤 힌트 생성
+- ✅ 사용자가 "더 힌트" 요청 시 다음 레벨로 진행
+- ✅ 숫자만 입력된 경우 플랫폼 확인 후 진행
+- ✅ 대화 맥락에서 플랫폼이 이미 확인된 경우 그 맥락 활용
+- ❌ 맥락 없이 플랫폼 임의 추정 금지
+
+## 관련 스킬
+
+- `/algo:fetch` - 문제 본문 직접 확인
+- `/algo:review` - 풀이 후 복습 템플릿 생성
+- `/algo:search` - 유사 난이도 문제 검색