rosalynyang/feishu-doc-creator-skill

Overview

This skill converts Markdown files into Feishu documents and orchestrates multiple helper modules to produce finished docs with full permission handling. It supports 25 Feishu block types, batch block addition, document verification, and logging to streamline automated document creation. The orchestrator focuses on reliable conversion and access control so teams can publish structured Feishu docs from Markdown sources.

How this skill works

The orchestrator parses Markdown into Feishu block types using a dedicated parser, then uses a creator module to assemble the document and apply permissions. A block-adder handles bulk insertion of blocks, while a verifier checks document integrity and a logger records operations. Configuration is driven by a simple environment file and command-line scripts for setup and validation.

When to use it

• You need to publish Markdown content as a Feishu document with structured blocks.
• Automating documentation pipelines that require permission management and folder placement.
• Batch converting many Markdown files or complex Markdown with advanced blocks (tables, boards, grids).
• Testing or validating how different Markdown constructs map to Feishu block types.
• Integrating AI-generated templates or specialized blocks into Feishu documents.

Best practices

• Store Feishu credentials in the designated env file and never commit it to version control.
• Run the provided config setup and check scripts before first use to ensure API access.
• Test conversions locally with the test_all_25_blocks script to confirm rendering of complex blocks.
• Use the default folder and auto-collaborator options to predefine document permissions where possible.
• Log and verify each created document to catch missing blocks or permission issues early.

Example use cases

• Convert a repo README or docs folder into a set of Feishu documents for team onboarding.
• Generate meeting notes from Markdown templates and auto-assign collaborators for follow-up.
• Publish product spec pages with tables, boards, and embedded code blocks into Feishu.
• Automate weekly reports: transform Markdown report drafts into formatted Feishu docs placed in a results folder.
• Integrate an AI template block into documents to include generated summaries or action items.