diff --git a/skills/skill-email/SKILL.md b/skills/skill-email/SKILL.md
index 737a155..f61424b 100644
--- a/skills/skill-email/SKILL.md
+++ b/skills/skill-email/SKILL.md
@@ -29,9 +29,30 @@ Gmail 통합 스킬. 포트 8501.
 
 ## API
 
-- `POST /send` - 이메일 전송
-- `GET /fetch` - 이메일 조회
-- `POST /summary` - 이메일 요약
+### 이메일 전송
+
+POST /send
+
+| 파라미터 | 타입 | 필수 | 설명 |
+|---------|------|------|------|
+| to | string | 필수 | 수신자 이메일 |
+| subject | string | 필수 | 제목 |
+| body | string | 필수 | 본문 |
+
+### 이메일 조회
+
+GET /messages
+
+| 파라미터 | 타입 | 필수 | 설명 |
+|---------|------|------|------|
+| user_id | UUID | 필수 | 사용자 ID (쿼리 파라미터) |
+| limit | int | 선택 | 최대 결과 수 (기본 10) |
+| query | string | 선택 | 검색 쿼리 |
+| provider | string | 선택 | "gmail" (기본) |
+
+### 이메일 요약
+
+POST /process
 
 ## 환경변수
 
diff --git a/skills/skill-news/SKILL.md b/skills/skill-news/SKILL.md
index 937adbc..6193afd 100644
--- a/skills/skill-news/SKILL.md
+++ b/skills/skill-news/SKILL.md
@@ -28,8 +28,33 @@ runtime:
 
 ## API
 
-- `POST /api/news/search` - 뉴스 검색
-- `POST /api/news/summarize` - 뉴스 요약
+### 뉴스 검색
+
+POST /api/news/search
+
+| 파라미터 | 타입 | 필수 | 설명 |
+|---------|------|------|------|
+| keywords | List[str] | 필수 | 검색 키워드 |
+| max_items | int | 선택 | 최대 수집 수 (기본 20) |
+| days_back | int | 선택 | 검색 기간 (기본 7일) |
+| format | string | 선택 | 응답 형식: "json" (기본) 또는 "slack" |
+
+### 뉴스 요약
+
+POST /api/news/summarize
+
+| 파라미터 | 타입 | 필수 | 설명 |
+|---------|------|------|------|
+| article_id | string | 필수 | 기사 ID |
+| style | string | 선택 | 요약 스타일 |
+
+### 최신 뉴스 조회
+
+GET /api/news/latest
+
+| 파라미터 | 타입 | 필수 | 설명 |
+|---------|------|------|------|
+| limit | int | 선택 | 조회 수 (기본 20) |
 
 ## 환경변수