viruagent-cli 0.3.0 → 0.3.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 greekr4
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ko.md

@@ -1,9 +1,21 @@
 
-![viru_run2](https://github.com/user-attachments/assets/76be6d06-3f0d-44e5-8152-d64b2fc68894)
+<p align="center">
+  <img src="https://github.com/user-attachments/assets/76be6d06-3f0d-44e5-8152-d64b2fc68894" alt="viruagent-cli" />
+</p>
+
+<h1 align="center">viruagent-cli</h1>
 
 <p align="center">
-  <a href="README.ko.md"><img src="https://img.shields.io/badge/한국어-red?style=for-the-badge" alt="Korean"></a>
-  <a href="README.md"><img src="https://img.shields.io/badge/English-blue?style=for-the-badge" alt="English"></a>
+  <a href="https://github.com/greekr4/viruagent-cli/stargazers"><img src="https://img.shields.io/github/stars/greekr4/viruagent-cli" alt="GitHub stars"></a>
+</p>
+<p align="center">
+  <a href="https://www.npmjs.com/package/viruagent-cli"><img src="https://img.shields.io/npm/v/viruagent-cli?color=blue" alt="npm version"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/npm/l/viruagent-cli" alt="license"></a>
+  <a href="https://nodejs.org"><img src="https://img.shields.io/node/v/viruagent-cli" alt="node version"></a>
+</p>
+<p align="center">
+  <a href="README.md"><img src="https://img.shields.io/badge/English-blue" alt="English"></a>
+  <a href="README.ko.md"><img src="https://img.shields.io/badge/한국어-red" alt="Korean"></a>
 </p>
 
 **AI 에이전트가 블로그를 쓰고, 태그를 만들고, 발행까지 자동으로 처리하는 CLI 도구**
@@ -28,25 +40,25 @@
 - **에이전트**: 스킬을 읽고 CLI를 조합하여 자율적으로 실행
 - **커스텀**: 스킬 파일을 직접 수정하여 원하는 대로 동작하도록 설정 가능
 
-## 설치
+## 빠른 시작
 
 ![viru_install](https://github.com/user-attachments/assets/35efb57f-fada-44c0-8dd4-6d586ef33a7c)
 
-아래 내용을 AI 에이전트에게 그대로 복사해서 보여주세요.
+아래 내용을 AI 에이전트에게 그대로 복사해서 보여주세요. (AI 에이전트 대상이므로 영어로 작성되어 있습니다)
 
 ```
 You are installing viruagent-cli, a blog publishing CLI tool. Follow these steps in order.
 
-Step 1: Verify CLI
-npx viruagent-cli --spec
-If the output contains "ok": true, the CLI is ready. If it fails, check that Node.js
->= 18 is installed.
-
-Step 2: Install skill
+Step 1: Install skill
 npx viruagent-cli install-skill
 This copies the skill file to ~/.claude/commands/viruagent.md. Confirm the file
 exists before proceeding.
 
+Step 2: Verify CLI
+npx viruagent-cli --spec
+If the output contains "ok": true, the CLI is ready. If it fails, check that Node.js
+>= 18 is installed.
+
 Tell the user that viruagent-cli installation is complete.
 ```
 
@@ -63,7 +75,8 @@ npx viruagent-cli login --from-chrome --profile "Profile 2"
 npx viruagent-cli login --username <id> --password <pw> --headless
 ```
 
-`--from-chrome`은 macOS Keychain을 통해 Chrome 쿠키 DB를 직접 복호화합니다. 브라우저 실행 없이, 2FA 없이, 1초 내 완료됩니다.
+> [!TIP]
+> `--from-chrome`은 macOS Keychain을 통해 Chrome 쿠키 DB를 직접 복호화합니다. 브라우저 실행 없이, 2FA 없이, 1초 내 완료됩니다.
 
 ## 사용법
 
@@ -93,14 +106,14 @@ npx viruagent-cli login --username <id> --password <pw> --headless
 
 ## 기술 스택
 
-| 영역 | 기술 | 설명 |
-| --- | --- | --- |
-| CLI 프레임워크 | Commander.js | 명령어 정의, 옵션 파싱, `--spec` 스키마 자동 생성 |
-| 브라우저 자동화 | Playwright (Chromium) | 로그인 자동화 |
-| 쿠키 복호화 | macOS Keychain + AES-128-CBC | Chrome 세션 임포트 (`--from-chrome`) |
-| 세션 관리 | JSON 파일 (`~/.viruagent-cli/`) | 쿠키 기반 세션 저장/복원 |
-| 이미지 검색 | DuckDuckGo, Wikimedia, Commons | 키워드 기반 이미지 자동 검색 |
-| 출력 형식 | JSON envelope | `{ ok, data }` / `{ ok, error, hint }` |
+| 영역 | 기술 |
+| --- | --- |
+| CLI 프레임워크 | Commander.js |
+| 브라우저 자동화 | Playwright (Chromium) |
+| 쿠키 복호화 | macOS Keychain + AES-128-CBC |
+| 세션 관리 | JSON 파일 (`~/.viruagent-cli/`) |
+| 이미지 검색 | DuckDuckGo, Wikimedia, Commons |
+| 출력 형식 | JSON envelope (`{ ok, data }` / `{ ok, error, hint }`) |
 
 ## Contributing
 
@@ -116,7 +129,3 @@ git checkout -b feature/my-feature
 git commit -m "[FEAT] Add my feature"
 git push origin feature/my-feature
 ```
-
-## License
-
-MIT

package/README.md

@@ -1,9 +1,21 @@
 
-![viru_run2](https://github.com/user-attachments/assets/76be6d06-3f0d-44e5-8152-d64b2fc68894)
+<p align="center">
+  <img src="https://github.com/user-attachments/assets/76be6d06-3f0d-44e5-8152-d64b2fc68894" alt="viruagent-cli" />
+</p>
+
+<h1 align="center">viruagent-cli</h1>
 
 <p align="center">
-  <a href="README.ko.md"><img src="https://img.shields.io/badge/한국어-red?style=for-the-badge" alt="Korean"></a>
-  <a href="README.md"><img src="https://img.shields.io/badge/English-blue?style=for-the-badge" alt="English"></a>
+  <a href="https://github.com/greekr4/viruagent-cli/stargazers"><img src="https://img.shields.io/github/stars/greekr4/viruagent-cli" alt="GitHub stars"></a>
+</p>
+<p align="center">
+  <a href="https://www.npmjs.com/package/viruagent-cli"><img src="https://img.shields.io/npm/v/viruagent-cli?color=blue" alt="npm version"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/npm/l/viruagent-cli" alt="license"></a>
+  <a href="https://nodejs.org"><img src="https://img.shields.io/node/v/viruagent-cli" alt="node version"></a>
+</p>
+<p align="center">
+  <a href="README.md"><img src="https://img.shields.io/badge/English-blue" alt="English"></a>
+  <a href="README.ko.md"><img src="https://img.shields.io/badge/한국어-red" alt="Korean"></a>
 </p>
 
 **A CLI tool where AI agents write, tag, and publish blog posts automatically.**
@@ -28,7 +40,7 @@ User: /viruagent "Write a post"
 - **Agent**: Reads the skill and orchestrates CLI commands autonomously
 - **Custom**: Edit the skill file to customize behavior
 
-## Installation
+## Quick Start
 
 ![viru_install](https://github.com/user-attachments/assets/35efb57f-fada-44c0-8dd4-6d586ef33a7c)
 
@@ -37,16 +49,16 @@ Copy the following to your AI agent:
 ```
 You are installing viruagent-cli, a blog publishing CLI tool. Follow these steps in order.
 
-Step 1: Verify CLI
-npx viruagent-cli --spec
-If the output contains "ok": true, the CLI is ready. If it fails, check that Node.js
->= 18 is installed.
-
-Step 2: Install skill
+Step 1: Install skill
 npx viruagent-cli install-skill
 This copies the skill file to ~/.claude/commands/viruagent.md. Confirm the file
 exists before proceeding.
 
+Step 2: Verify CLI
+npx viruagent-cli --spec
+If the output contains "ok": true, the CLI is ready. If it fails, check that Node.js
+>= 18 is installed.
+
 Tell the user that viruagent-cli installation is complete.
 ```
 
@@ -63,7 +75,8 @@ npx viruagent-cli login --from-chrome --profile "Profile 2"
 npx viruagent-cli login --username <id> --password <pw> --headless
 ```
 
-`--from-chrome` decrypts Chrome's cookie database directly via macOS Keychain. No browser launch, no 2FA — completes in under 1 second.
+> [!TIP]
+> `--from-chrome` decrypts Chrome's cookie database directly via macOS Keychain. No browser launch, no 2FA — completes in under 1 second.
 
 ## Usage
 
@@ -93,14 +106,14 @@ Ask the agent for detailed usage or customization help.
 
 ## Tech Stack
 
-| Area | Tech | Description |
-| --- | --- | --- |
-| CLI Framework | Commander.js | Command definitions, option parsing, `--spec` schema |
-| Browser Automation | Playwright (Chromium) | Login automation |
-| Cookie Decryption | macOS Keychain + AES-128-CBC | Chrome session import (`--from-chrome`) |
-| Session Management | JSON file (`~/.viruagent-cli/`) | Cookie-based session save/restore |
-| Image Search | DuckDuckGo, Wikimedia, Commons | Keyword-based auto image search |
-| Output Format | JSON envelope | `{ ok, data }` / `{ ok, error, hint }` |
+| Area | Tech |
+| --- | --- |
+| CLI Framework | Commander.js |
+| Browser Automation | Playwright (Chromium) |
+| Cookie Decryption | macOS Keychain + AES-128-CBC |
+| Session Management | JSON file (`~/.viruagent-cli/`) |
+| Image Search | DuckDuckGo, Wikimedia, Commons |
+| Output Format | JSON envelope (`{ ok, data }` / `{ ok, error, hint }`) |
 
 ## Contributing
 
@@ -116,7 +129,3 @@ git checkout -b feature/my-feature
 git commit -m "[FEAT] Add my feature"
 git push origin feature/my-feature
 ```
-
-## License
-
-MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viruagent-cli",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "AI-agent-optimized CLI for blog publishing (Tistory, Naver)",
   "private": false,
   "type": "commonjs",

package/skills/viruagent.md

@@ -62,47 +62,67 @@ Every post must follow this structure. Write in the same language as the user's
 
 ```html
 <!-- 1. Hook (blockquote style2 for topic quote) -->
-<blockquote data-ke-style="style2">[One impactful sentence about the topic]</blockquote>
+<blockquote data-ke-style="style2">[One impactful sentence that captures the core insight or tension]</blockquote>
 <p data-ke-size="size16">&nbsp;</p>
 
-<!-- 2. Introduction (what this post covers, what the reader will learn) -->
-<p>[Brief overview — set expectations clearly]</p>
+<!-- 2. Introduction (2~3 paragraphs: context, reader empathy, what this post covers) -->
+<p data-ke-size="size18">[Describe the situation the reader relates to — paint a vivid picture, 3~5 sentences]</p>
+<p data-ke-size="size18">[Set expectations: what angle this post takes, what the reader will gain]</p>
 <p data-ke-size="size16">&nbsp;</p>
 
-<!-- 3. Body (2~4 sections with h2/h3, short paragraphs, lists) -->
+<!-- 3. Body (3~4 sections with h2, each section has 2~3 paragraphs) -->
 <!-- Use <p data-ke-size="size16">&nbsp;</p> between sections for spacing -->
 <h2>[Section 1 Title — keyword-rich]</h2>
-<p>[Short paragraph, max 2~3 sentences]</p>
+<p data-ke-size="size18">[Explain the concept or situation in 3~5 sentences. Include evidence: expert quotes, data, or real-world examples]</p>
+<p data-ke-size="size18">[Deepen the point with analysis, comparison, or implication. Connect to the reader's experience]</p>
 <ul>
+  <li>[Key point — only use lists for 3+ concrete items worth scanning]</li>
   <li>[Key point]</li>
   <li>[Key point]</li>
 </ul>
+<p data-ke-size="size16">&nbsp;</p>
 
 <h2>[Section 2 Title]</h2>
-<p>[Short paragraph]</p>
+<p data-ke-size="size18">[Introduce a new angle, case study, or supporting argument. 3~5 sentences with specific details]</p>
+<p data-ke-size="size18">[Analyze why this matters. Use <strong>bold</strong> for key terms. Connect back to the main thesis]</p>
+<p data-ke-size="size16">&nbsp;</p>
+
+<h2>[Section 3 Title]</h2>
+<p data-ke-size="size18">[Practical application or actionable insight. Show, don't just tell]</p>
+<p data-ke-size="size18">[Bridge to the conclusion — "what this all means"]</p>
+<p data-ke-size="size16">&nbsp;</p>
 
 <!-- 4. Summary / Key Takeaways -->
 <h2>핵심 정리</h2>
 <ul>
-  <li>[Takeaway 1]</li>
+  <li>[Takeaway 1 — one complete sentence, not a fragment]</li>
   <li>[Takeaway 2]</li>
   <li>[Takeaway 3]</li>
 </ul>
+<p data-ke-size="size16">&nbsp;</p>
 
-<!-- 5. Closing (CTA or next step) -->
-<p>[Closing sentence — encourage action, share, or further reading]</p>
+<!-- 5. Closing (specific action the reader can take) -->
+<p data-ke-size="size18">[Closing 1~2 sentences — suggest a concrete, immediate action. Not vague "stay tuned" but specific "try this tomorrow"]</p>
 ```
 
 ### Writing Rules
 
 - **Title**: Include the primary keyword. 10~20 characters. Short and impactful.
-- **Paragraphs**: Max 2~3 sentences each. Break long ideas into multiple paragraphs for readability.
+- **Length**: 3000~4000 characters (한글 기준). Aim for depth, not padding.
+- **Paragraphs**: 3~5 sentences each. Develop ideas fully within a paragraph before moving on. Do NOT write 1~2 sentence paragraphs repeatedly.
+- **Font size**: Use `<p data-ke-size="size18">` for all body text paragraphs. Use `<p data-ke-size="size16">&nbsp;</p>` only for spacing between sections.
 - **Spacing**: Use `<p data-ke-size="size16">&nbsp;</p>` between sections for line breaks (Tistory-specific).
 - **Hook**: Always use `<blockquote data-ke-style="style2">` for the opening topic quote.
-- **Lists**: Use `<ul>` or `<ol>` for 3+ items. Easier to scan.
+- **Introduction**: 2~3 paragraphs that set context and build reader empathy before diving into the body.
+- **Body sections**: Each h2 section must have 2~3 substantial paragraphs. Do NOT jump straight to bullet lists.
+- **Lists**: Use sparingly — only for 3+ concrete, scannable items. Default to paragraphs for explanation and analysis.
+- **Evidence**: Each body section should include at least one of: expert quote, data point, real company example, or research finding. Cite sources naturally within the text.
+- **Perspective shift**: Include at least one moment that reframes the reader's thinking (e.g., "X is not about A, it's about B").
+- **Transitions**: Connect sections with bridge sentences. Avoid abrupt jumps between topics.
+- **Bold**: Use `<strong>` for key terms and concepts (2~3 per section max).
 - **Subheadings**: Use `<h2>` for ALL section titles. Do NOT use `<h3>`. Keep heading sizes consistent.
-- **Tone**: Conversational but informative. Avoid jargon unless the audience expects it.
-- **Length**: 1500~2000 characters (한글 기준) for standard posts. Do NOT exceed 2000 characters.
+- **Tone**: Conversational but substantive. Write as if explaining to a smart colleague, not listing facts for a report.
+- **Closing**: End with a specific, actionable suggestion the reader can try immediately — not a vague "stay tuned."
 - **SEO**: Primary keyword in title, first paragraph, and at least one `<h2>`. Don't keyword-stuff.
 
 ```bash