Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
aaaaqwq avatar

Feishu Doc Optimizer

  • 41 installs
  • 82 repo stars
  • Updated August 2, 2026
  • aaaaqwq/claude-code-skills

feishu-doc-optimizer is a Claude Code skill that reads Feishu cloud documents and rewrites their structure, formatting, and layout for readability.

About

feishu-doc-optimizer is a Claude Code skill that improves the structure, formatting, and readability of Feishu cloud documents. It reads a document by token via the Feishu API, restructures the content, and replaces it using Playwright browser automation because the API cannot delete document blocks directly. A developer or writer uses it to clean up and standardize Feishu doc layout. It applies a defined convention of section numbering, emoji markers, separators, and aligned tables.

  • Reads, restructures, and reformats Feishu cloud documents
  • Uses the Feishu API to read and Playwright browser automation to replace content
  • Ships an emoji, separator, and table formatting convention

Feishu Doc Optimizer by the numbers

  • 41 all-time installs (skills.sh)
  • Ranked #389 of 687 Office & Documents skills by installs in the Skillselion catalog
  • Data as of Aug 3, 2026 (Skillselion catalog sync)
At a glance

feishu-doc-optimizer capabilities & compatibility

Free skill; requires Feishu app credentials with docx scopes and a logged-in browser.

Capabilities
document formatting · content restructure · doc optimization · browser automation
Works with
playwright
Use cases
documentation
Pricing
Bring your own API key
From the docs

What feishu-doc-optimizer says it does

飞书云文档内容优化与格式美化。当用户需要优化飞书文档的排版、结构、格式、美观度时使用此技能。
SKILL.md
飞书 API 不支持直接删除文档块
SKILL.md
npx skills add https://github.com/aaaaqwq/claude-code-skills --skill feishu-doc-optimizer

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs41
repo stars82
Last updatedAugust 2, 2026
Repositoryaaaaqwq/claude-code-skills

What it does

A writer optimizes Feishu document structure and formatting by reading via API and replacing content through browser automation.

Who is it for?

Writers standardizing Feishu doc layout with consistent numbering, emoji markers, and tables.

Skip if: Editing that must go purely through the API, since the Feishu API cannot delete document blocks and browser automation is used instead.

When should I use this skill?

When a user wants to optimize, beautify, or reformat a Feishu document's layout and structure.

What you get

A restructured, consistently formatted Feishu document with clear hierarchy, emoji markers, and aligned tables.

  • Reformatted Feishu document

By the numbers

  • 12-row emoji usage convention table
  • 2 documented Feishu tenant configurations

Files

SKILL.mdMarkdownGitHub ↗

飞书云文档优化器

优化飞书云文档的内容结构、排版格式和视觉美观度。

工作流程

1. 读取文档内容

使用飞书 API 读取文档原始内容:

python3 scripts/feishu_doc_reader.py <doc_token>

文档 token 从 URL 提取:https://xxx.feishu.cn/docx/<doc_token>

2. 分析并优化内容

优化原则:

  • 结构清晰:使用标准章节编号(1. 2. 3.)
  • 层次分明:一级标题、二级标题、正文层次清晰
  • 内容精炼:删除冗余,保留核心信息
  • 视觉美观:使用 emoji 标记、分隔线、表格对齐

3. 替换文档内容

通过 Playwright 浏览器自动化:

python3 scripts/feishu_doc_editor.py <doc_token> <content_file>

流程: 1. 连接已登录的浏览器 2. 打开文档进入编辑模式 3. 循环 Ctrl+A + Backspace 清空内容 4. 逐行输入新内容

飞书 API 配置

租户配置

租户App ID用途
hanxingREDACTED_FEISHU_HANXING_APP_ID汉兴企业(默认)
personalREDACTED_FEISHU_PERSONAL_APP_ID个人应用

API 权限

需要的权限范围:

  • docx:document:readonly - 读取文档
  • docx:document - 编辑文档(API 方式)

优化模板

项目文档模板

# [项目名称]

> [一句话描述]
> 📅 版本:vX.X | 更新日期:YYYY-MM-DD

---

## 📋 目录
1. 项目背景  2. 系统架构  3. 核心功能  ...

---

## 1. 项目背景

### 1.1 痛点分析
🔴 痛点1 - 描述 ⭐⭐⭐⭐⭐
🔴 痛点2 - 描述 ⭐⭐⭐⭐

### 1.2 解决方案
方案描述...

---

## 2. 核心功能

### 2.1 功能名称 ✅
**功能**:功能描述
**流程**:步骤1 ➜ 步骤2 ➜ 步骤3

---

## N. 项目价值

### N.1 投入成本
| 项目 | 成本 | 说明 |
|------|------|------|
| 项目1 | ¥0 | 说明 |

### N.2 产出价值
⏱️ 指标1:描述
💰 指标2:描述

---

💡 如有改进建议,欢迎提出!

格式规范

Emoji 使用

场景Emoji
目录/导航📋
日期/版本📅
痛点/问题🔴
已完成
进行中🔄
待办
重要提示⚠️ 💡
数据采集📥
数据处理⚙️
数据展示📊
时间⏱️
成本💰
增长📈

分隔符

  • 章节分隔:---(三个短横线)
  • 流程箭头:
  • 星级评分:⭐⭐⭐⭐⭐

表格格式

| 列1 | 列2 | 列3 |
|:---:|------|:---:|
| 居中 | 左对齐 | 居中 |

注意事项

1. 登录状态:浏览器编辑需要已登录飞书 2. API 限制:飞书 API 不支持直接删除文档块 3. 编辑模式:确保文档处于"编辑"模式而非"阅读"模式 4. 保存确认:编辑后等待"已保存到云端"提示

相关文件

  • scripts/feishu_doc_reader.py - 读取文档内容
  • scripts/feishu_doc_editor.py - 编辑文档内容
  • references/optimization-examples.md - 优化案例参考

Related skills

FAQ

How does it replace content?

It connects a logged-in browser with Playwright, opens the doc in edit mode, clears content, and types the new content because the API cannot delete blocks.

What permissions does it need?

docx:document:readonly to read and docx:document to edit via the API.

Office & Documentsnotesworkflow

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.