feishu-doc-orchestrator

Original：🇨🇳 Chinese

Translated

4 scriptsChecked / no sensitive code detected

Feishu Document Creation Orchestration Skill - Convert Markdown files to Feishu documents, orchestrate multiple sub-skills to collaborate on the task, and use file transfer for data to save Tokens.

4installs

Sourcerosalynyang/feishu-doc-creator-skill

Added on2026-02-08

NPX Install

npx skill4agent add rosalynyang/feishu-doc-creator-skill feishu-doc-orchestrator

SKILL.md Content (Chinese)

View Translation Comparison →

Feishu Document Creation Orchestration Skill

Quick Start

Command Line Usage

bash

# Create document
python scripts/orchestrator.py input.md "Document Title"

# Use default title (filename)
python scripts/orchestrator.py input.md

Usage as a Skill

Please help me convert docs/example.md to a Feishu document

Workflow (5-Step Orchestration)

This skill orchestrates 5 sub-skills to collaborate on document creation:

Step 1: Markdown Parsing

Call the

feishu-md-parser

sub-skill

Input: Markdown file path
Output:
```
workflow/step1_parse/blocks.json
```
Description: Parse Markdown into Feishu block format

Step 2: Document Creation + Permission Management ⭐ Atomic Operation

Call the

feishu-doc-creator-with-permission

sub-skill

Input: Document title

Output:

workflow/step2_create_with_permission/doc_with_permission.json

Description: Create a document and automatically complete permission assignment (add collaborators + transfer ownership)
⚠️ Important: Document creation and permission management are combined to ensure correct permission assignment for each creation

Step 3: Block Addition

Call the

feishu-block-adder

sub-skill

Input:

step1_parse/blocks.json

+

step2_create_with_permission/doc_with_permission.json

Output:

workflow/step3_add_blocks/add_result.json

Description: Add content blocks to the document in batches

Step 4: Document Verification

Call the

feishu-doc-verifier

sub-skill

Input:

step2_create_with_permission/doc_with_permission.json

Output:

workflow/step4_verify/verify_result.json

Description: Use Playwright to verify document accessibility

Step 5: Logging

Call the

feishu-logger

sub-skill

Input: Result files from all steps
Output:
```
CREATED_DOCS.md
```
+
```
created_docs.json
```
Description: Summarize and record to log files

Data Flow (File Transfer)

input.md
    ↓
[feishu-md-parser]
    ↓ workflow/step1_parse/blocks.json
[feishu-doc-creator-with-permission] ⭐ Creation + Permission Atomic Operation
    ↓ workflow/step2_create_with_permission/doc_with_permission.json
    ├─→ [feishu-block-adder] → workflow/step3_add_blocks/add_result.json
    └─→ [feishu-doc-verifier] → workflow/step4_verify/verify_result.json
[feishu-logger]
    ↓
CREATED_DOCS.md + created_docs.json

Key Design Principles

1. Only pass file paths, not content

Sub-skills only pass file paths instead of actual content to save Tokens.

2. Save intermediate results as files

Results of each step are saved to the

workflow/

directory, enabling traceability and resumable execution.

3. Natural language orchestration

The main skill describes the process in natural language, and each sub-skill is independent and testable.

4. Single Responsibility

Each sub-skill only does one thing:

```
feishu-md-parser
```
: Only parses Markdown
```
feishu-doc-creator-with-permission
```
: Creates documents and assigns permissions (atomic operation) ⭐
```
feishu-block-adder
```
: Only adds blocks
```
feishu-doc-verifier
```
: Only verifies documents
```
feishu-logger
```
: Only records logs

Workflow Directory Structure

workflow/
├── step1_parse/
│   ├── blocks.json       # Parsed block data
│   └── metadata.json     # Parsing metadata
├── step2_create_with_permission/
│   └── doc_with_permission.json  # Document info + permission status ⭐
├── step3_add_blocks/
│   └── add_result.json   # Block addition result
└── step4_verify/
    └── verify_result.json      # Verification result

Output Results

After successful completion, you will get:

Document URL: Directly accessible Feishu document link
CREATED_DOCS.md: Creation log in Markdown format
created_docs.json: Creation log in JSON format
workflow/: Complete intermediate results, allowing traceability of each step

Configuration Requirements

Need to configure

.claude/feishu-config.env

:

ini

FEISHU_APP_ID = "cli_xxx"
FEISHU_APP_SECRET = "xxxxxxxx"
FEISHU_API_DOMAIN = "https://open.feishu.cn"
FEISHU_AUTO_COLLABORATOR_ID = "ou_xxx"

Usage Examples

Example 1: Basic Usage

Please help me convert .claude/skills/feishu-doc-creator/test_doc.md to a Feishu document

Example 2: Specify Title

Please convert docs/report.md to a Feishu document with the title "Weekly Report - 2026-01-22"

Example 3: Resumable Workflow

If a step fails, you can manually modify the intermediate results and continue:

# Step 2 creation + permission failed, manually re-execute
python .claude/skills/feishu-doc-creator-with-permission/scripts/doc_creator_with_permission.py "Document Title" workflow/step2_create_with_permission

Frequently Asked Questions

Q1: What to do if a step fails?

A: Check the JSON files in the

workflow/stepX_*/

directory, you can manually fix them and proceed to the next step.

Q2: How to execute only a specific step?

A: Directly call the corresponding sub-skill script and pass the correct file path.

Q3: How effective is Token saving?

A: The file transfer method saves approximately 60-80% of Tokens compared to content transfer.

⚠️ Important Debugging Notes

Callout Block Color Issue

If the created callout (highlight block) has no color or border:

Cause: The color field of the callout block must be placed directly under the

callout

object, not nested in

style

.

Verification Method: Check if the callout object returned by the API contains the color field:

python

# If only emoji_id exists without background_color, the format is incorrect
returned_callout = result["data"]["children"][0].get("callout", {})

Solution: Already fixed in

feishu-md-parser

and

feishu-block-adder

.

Detailed Troubleshooting: See

TROUBLESHOOTING.md

(Issue 1)

Test Script:

test_callout_only.py

- Test callout format independently

feishu-doc-orchestrator

NPX Install

Tags

SKILL.md Content (Chinese)

Feishu Document Creation Orchestration Skill

Quick Start

Command Line Usage

Usage as a Skill

Workflow (5-Step Orchestration)

Step 1: Markdown Parsing

Step 2: Document Creation + Permission Management ⭐ Atomic Operation

Step 3: Block Addition

Step 4: Document Verification

Step 5: Logging

Data Flow (File Transfer)

Key Design Principles

1. Only pass file paths, not content

2. Save intermediate results as files

3. Natural language orchestration

4. Single Responsibility

Workflow Directory Structure

Output Results

Configuration Requirements

Usage Examples

Example 1: Basic Usage

Example 2: Specify Title

Example 3: Resumable Workflow

Frequently Asked Questions

Q1: What to do if a step fails?

Q2: How to execute only a specific step?

Q3: How effective is Token saving?

⚠️ Important Debugging Notes

Callout Block Color Issue