Enhance skill

Author: Bobholamovic

skills/paddleocr-doc-parsing/SKILL.md

@@ -198,11 +198,13 @@ Then return:
 
 ### First-Time Configuration
 
+You can generally assume that the required environment variables have already been configured. Only when a parsing task fails should you analyze the error message to determine whether it is caused by a configuration issue. If it is indeed a configuration problem, you should notify the user to fix it.
+
 **When API is not configured**:
 
 The error will show:
 ```
-PADDLEOCR_DOC_PARSING_API_URL not configured. Get your API at: https://paddleocr.com
+CONFIG_ERROR: PADDLEOCR_DOC_PARSING_API_URL not configured. Get your API at: https://paddleocr.com
 ```
 
 **Configuration workflow**:
@@ -217,29 +219,25 @@ PADDLEOCR_DOC_PARSING_API_URL not configured. Get your API at: https://paddleocr
      - PADDLEOCR_ACCESS_TOKEN
      - Optional: PADDLEOCR_DOC_PARSING_TIMEOUT
      ```
+   - For security reasons, do not run `configure.py` or create a local `.env` file by default if the skill is installed under a host application directory (for example, `~/.claude/skills`). You should also advise the user not to do this.
 
-3. **If the user provides credentials in chat anyway** (accept any reasonable format):
+3. **If the user provides credentials in chat anyway** (accept any reasonable format), for example:
    - `PADDLEOCR_DOC_PARSING_API_URL=https://xxx.paddleocr.com/layout-parsing, PADDLEOCR_ACCESS_TOKEN=abc123...`
    - `Here's my API: https://xxx and token: abc123`
    - Copy-pasted code format
    - Any other reasonable format
    - **Security note**: Warn the user that credentials shared in chat may be stored in conversation history. Recommend setting them through the host application's configuration instead when possible.
 
-4. **Parse and validate the values**:
+   Then parse and validate the values:
    - Extract `PADDLEOCR_DOC_PARSING_API_URL` (look for URLs with `paddleocr.com` or similar)
    - Confirm `PADDLEOCR_DOC_PARSING_API_URL` is a full endpoint ending with `/layout-parsing`
    - Extract `PADDLEOCR_ACCESS_TOKEN` (long alphanumeric string, usually 40+ chars)
-   - Tell the user exactly which environment variables to set
 
-5. **Ask the user to confirm the environment is configured**:
-   - Wait for the user to confirm these values have been set in their host application, runtime environment, or appropriate config file
-   - For security reasons, do not run `configure.py` or create a local `.env` file by default if the skill is installed under a host application directory (for example, `~/.claude/skills`)
+4. **Ask the user to confirm the environment is configured**.
 
-6. **Retry only after confirmation**:
+5. **Retry only after confirmation**:
    - Once the user confirms the environment variables are available, retry the original parsing task
 
-**IMPORTANT**: The error message format is STRICT and must be shown exactly as provided by the script. Do not modify or paraphrase it.
-
 ### Handling Large Files
 
 There is no file size limit for the API. For PDFs, the maximum is 100 pages per request.

skills/paddleocr-text-recognition/SKILL.md

@@ -156,6 +156,8 @@ The output JSON structure is as follows:
 
 ### First-Time Configuration
 
+You can generally assume that the required environment variables have already been configured. Only when an OCR task fails should you analyze the error message to determine whether it is caused by a configuration issue. If it is indeed a configuration problem, you should notify the user to fix it.
+
 **When API is not configured**:
 
 The error will show:
@@ -175,25 +177,23 @@ CONFIG_ERROR: PADDLEOCR_OCR_API_URL not configured. Get your API at: https://pad
      - PADDLEOCR_ACCESS_TOKEN
      - Optional: PADDLEOCR_OCR_TIMEOUT
      ```
+   - For security reasons, do not run `configure.py` or create a local `.env` file by default if the skill is installed under a host application directory (for example, `~/.claude/skills`). You should also advise the user not to do this.
 
-3. **If the user provides credentials in chat anyway** (accept any reasonable format):
+3. **If the user provides credentials in chat anyway** (accept any reasonable format), for example:
    - `PADDLEOCR_OCR_API_URL=https://xxx.paddleocr.com/ocr, PADDLEOCR_ACCESS_TOKEN=abc123...`
    - `Here's my API: https://xxx and token: abc123`
    - Copy-pasted code format
    - Any other reasonable format
    - **Security note**: Warn the user that credentials shared in chat may be stored in conversation history. Recommend setting them through the host application's configuration instead when possible.
 
-4. **Parse and validate the values**:
+   Then parse and validate the values:
    - Extract `PADDLEOCR_OCR_API_URL` (look for URLs with `paddleocr.com` or similar)
    - Confirm `PADDLEOCR_OCR_API_URL` is a full endpoint ending with `/ocr`
    - Extract `PADDLEOCR_ACCESS_TOKEN` (long alphanumeric string, usually 40+ chars)
-   - Tell the user exactly which environment variables to set
 
-5. **Ask the user to confirm the environment is configured**:
-   - Wait for the user to confirm these values have been set in their host application, runtime environment, or appropriate config file
-   - For security reasons, do not run `configure.py` or create a local `.env` file by default if the skill is installed under a host application directory (for example, `~/.claude/skills`)
+4. **Ask the user to confirm the environment is configured**.
 
-6. **Retry only after confirmation**:
+5. **Retry only after confirmation**:
    - Once the user confirms the environment variables are available, retry the original OCR task
 
 ### Error Handling