@yeongjaeyou/claude-code-config 0.14.0 → 0.15.0

package/.claude/skills/notion-md-uploader/SKILL.md

@@ -25,16 +25,22 @@ Before using this skill, ensure the following setup is complete:
 
 ### 2. Environment Configuration
 
-Set the API key in the environment:
+Set the API key in the environment. The script automatically loads `.env` files if `python-dotenv` is installed:
 
 ```bash
-# In .env file
+# In .env file (recommended - auto-loaded)
 NOTION_API_KEY=ntn_xxxxx
 
 # Or export directly
 export NOTION_API_KEY=ntn_xxxxx
 ```
 
+To install dotenv support:
+
+```bash
+uv add python-dotenv
+```
+
 ### 3. Page Access
 
 Share the target parent page with the integration:
@@ -65,6 +71,8 @@ uv run python .claude/skills/notion-md-uploader/scripts/upload_md.py \
 
 ### Dry Run (Preview)
 
+Preview parsing results and validate local images before uploading:
+
 ```bash
 uv run python .claude/skills/notion-md-uploader/scripts/upload_md.py \
     docs/analysis.md \
@@ -72,6 +80,11 @@ uv run python .claude/skills/notion-md-uploader/scripts/upload_md.py \
     --dry-run
 ```
 
+The dry run validates:
+- Markdown block parsing
+- Local image file existence
+- Conversion to Notion blocks
+
 ## Supported Markdown Elements
 
 | Element | Markdown Syntax | Notion Block |

package/.claude/skills/notion-md-uploader/scripts/upload_md.py

@@ -18,10 +18,17 @@ import sys
 from pathlib import Path
 from typing import Any
 
+# Load .env file if python-dotenv is available
+try:
+    from dotenv import load_dotenv
+    load_dotenv()
+except ImportError:
+    pass  # python-dotenv not installed, use env vars directly
+
 # Add scripts directory to path for imports
 sys.path.insert(0, str(Path(__file__).parent))
 
-from markdown_parser import MarkdownParser
+from markdown_parser import BlockType, MarkdownParser
 from notion_client import NotionClient, NotionAPIError, NotionConfig
 from notion_converter import NotionBlockConverter
 
@@ -236,8 +243,8 @@ Setup:
         print(f"Parsing: {args.md_file}")
         content = md_path.read_text(encoding="utf-8")
 
-        parser = MarkdownParser(base_path=str(md_path.parent))
-        blocks = parser.parse(content)
+        md_parser = MarkdownParser(base_path=str(md_path.parent))
+        blocks = md_parser.parse(content)
 
         print(f"Found {len(blocks)} blocks:")
         for i, block in enumerate(blocks[:10]):
@@ -251,6 +258,34 @@ Setup:
         if len(blocks) > 10:
             print(f"  ... and {len(blocks) - 10} more blocks")
 
+        # Validate image files
+        base_path = md_path.parent
+        image_blocks = [b for b in blocks if b.block_type == BlockType.IMAGE]
+        missing_images = []
+        found_images = []
+
+        for block in image_blocks:
+            img_src = block.metadata.get("url", "")
+            if img_src and not img_src.startswith(("http://", "https://")):
+                img_path = base_path / img_src
+                if img_path.exists():
+                    found_images.append(str(img_src))
+                else:
+                    missing_images.append(str(img_src))
+
+        if found_images:
+            print(f"\nLocal images ({len(found_images)}):")
+            for img in found_images[:5]:
+                print(f"  [OK] {img}")
+            if len(found_images) > 5:
+                print(f"  ... and {len(found_images) - 5} more")
+
+        if missing_images:
+            print(f"\nMissing images ({len(missing_images)}):")
+            for img in missing_images:
+                print(f"  [MISSING] {img}")
+            print("\nWarning: Missing images will cause upload to fail.")
+
         converter = NotionBlockConverter(base_path=str(md_path.parent))
         notion_blocks = converter.convert_blocks(blocks)
         print(f"\nConverted to {len(notion_blocks)} Notion blocks")
@@ -272,10 +307,13 @@ Setup:
 
         page_url = page.get("url", "")
         page_id = page.get("id", "")
+        image_count = len(uploader._uploaded_images)
 
         print(f"\nSuccess!")
         print(f"Page ID: {page_id}")
         print(f"URL: {page_url}")
+        if image_count > 0:
+            print(f"Images uploaded: {image_count}")
 
     except NotionAPIError as e:
         print(f"\nNotion API Error: {e}")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yeongjaeyou/claude-code-config",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "Claude Code CLI custom commands, agents, and skills",
   "bin": {
     "claude-code-config": "./bin/cli.js"