{
  "schemaVersion": "1.0",
  "item": {
    "slug": "feishu-folder-summary",
    "name": "飞书文档文件夹摘要生成器",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/henryjing96/feishu-folder-summary",
    "canonicalUrl": "https://clawhub.ai/henryjing96/feishu-folder-summary",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/feishu-folder-summary",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=feishu-folder-summary",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "scripts/summary_generator.py",
      "references/feishu_api.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/feishu-folder-summary"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/feishu-folder-summary",
    "agentPageUrl": "https://openagent3.xyz/skills/feishu-folder-summary/agent",
    "manifestUrl": "https://openagent3.xyz/skills/feishu-folder-summary/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/feishu-folder-summary/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Feishu Folder Summary",
        "body": "This skill extracts summaries from all documents in a Feishu folder (wiki or drive), recursively scanning sub-folders and generating a comprehensive Markdown report."
      },
      {
        "title": "Overview",
        "body": "The skill performs the following operations:\n\nParses the Feishu folder URL to extract space_id and node_token\nRecursively traverses the folder structure using feishu_wiki API\nReads each document's content using feishu_doc API\nGenerates structured summaries for each document\nCompiles a comprehensive Markdown report with:\n\nComplete directory tree\nDocument summaries organized by folder\nStatistics and status overview\nLinks to original documents"
      },
      {
        "title": "Supported URL Formats",
        "body": "Wiki folders: https://{domain}.feishu.cn/wiki/{node_token}\nDrive folders: https://{domain}.feishu.cn/drive/folder/{folder_token}"
      },
      {
        "title": "Step 1: Extract Folder Information",
        "body": "Parse the provided Feishu URL to identify:\n\nDocument type (wiki or drive)\nSpace ID (for wiki)\nNode token or folder token"
      },
      {
        "title": "Step 2: Recursive Traversal",
        "body": "Use feishu_wiki API to traverse the folder structure:\n\nfeishu_wiki action=\"get\" token=\"{node_token}\"         # Get folder info\nfeishu_wiki action=\"nodes\" space_id=\"{space_id}\"      # List child nodes\n\nFor folders with has_child: true, recursively process child nodes."
      },
      {
        "title": "Step 3: Document Reading",
        "body": "For each document node, read its content:\n\nfeishu_doc action=\"read\" doc_token=\"{obj_token}\""
      },
      {
        "title": "Step 4: Generate Summary",
        "body": "Extract from each document:\n\nTitle: Document title\nType: Document or Folder\nStatus: Complete, In Progress, or Empty\nCore Content: Key points, main topics, important information\nChild Documents: If folder, list contained documents"
      },
      {
        "title": "Step 5: Compile Report",
        "body": "Generate a Markdown report with:\n\nHeader (source URL, generation time, document count)\nDirectory tree visualization\nHierarchical summaries (by folder level)\nStatistics table\nRelated links"
      },
      {
        "title": "Output Format",
        "body": "The generated report includes:\n\n# {Folder Name} Document Summary Report\n\n**Source:** {URL}  \n**Generated:** {Timestamp}  \n**Total Documents:** {Count}\n\n---\n\n## Directory Structure\n\n{Tree visualization}\n\n---\n\n## Level 1 Summaries\n\n### 1. {Document Name}\n- **Type:** {docx/folder}\n- **Status:** {Complete/In Progress/Empty}\n- **Summary:** {Core content description}\n\n### 2. {Folder Name}/\n- **Type:** folder\n- **Documents:** {Count}\n- **Summary:** {Folder description}\n\n#### 2.1 {Child Document}\n- **Type:** docx\n- **Summary:** {Content summary}\n\n---\n\n## Statistics\n\n| Category | Count | Status |\n|----------|-------|--------|\n| Total | X | - |\n| Complete | X | ✅ |\n| In Progress | X | 🚧 |\n| Empty | X | ⚠️ |\n\n---\n\n*Report generated by feishu-folder-summary skill*"
      },
      {
        "title": "Example Usage",
        "body": "User Request:\n\n\"Extract summaries from https://caz6yhvgk5z.feishu.cn/wiki/BzslwD3Nei1Dggkvin5cV2hDnob\"\n\nSkill Execution:\n\nParse URL → Wiki folder, node_token=BzslwD3Nei1Dggkvin5cV2hDnob\nGet folder info → space_id=7593876306731732193, title=\"AI云平台\"\nRecursively traverse → Found 14 level-1 nodes, 30+ child documents\nRead each document → Extract content and generate summaries\nCompile report → Generate comprehensive Markdown summary\n\nOutput:\n\nComplete directory tree\nHierarchical summaries for all 44 documents\nStatus tracking (✅ Complete, 🚧 In Progress, ⚠️ Empty)\nStatistics overview"
      },
      {
        "title": "Key Considerations",
        "body": "Recursive Depth: Process all levels of nested folders\nDocument Types: Handle docx (documents) and folder (containers)\nError Handling: Continue processing if individual document read fails\nContent Length: Generate concise but informative summaries\nStatus Detection: Identify empty or placeholder documents\nToken Efficiency: Summarize long documents appropriately"
      },
      {
        "title": "API Reference",
        "body": "See references/feishu_api.md for detailed API documentation."
      }
    ],
    "body": "Feishu Folder Summary\n\nThis skill extracts summaries from all documents in a Feishu folder (wiki or drive), recursively scanning sub-folders and generating a comprehensive Markdown report.\n\nOverview\n\nThe skill performs the following operations:\n\nParses the Feishu folder URL to extract space_id and node_token\nRecursively traverses the folder structure using feishu_wiki API\nReads each document's content using feishu_doc API\nGenerates structured summaries for each document\nCompiles a comprehensive Markdown report with:\nComplete directory tree\nDocument summaries organized by folder\nStatistics and status overview\nLinks to original documents\nSupported URL Formats\nWiki folders: https://{domain}.feishu.cn/wiki/{node_token}\nDrive folders: https://{domain}.feishu.cn/drive/folder/{folder_token}\nWorkflow\nStep 1: Extract Folder Information\n\nParse the provided Feishu URL to identify:\n\nDocument type (wiki or drive)\nSpace ID (for wiki)\nNode token or folder token\nStep 2: Recursive Traversal\n\nUse feishu_wiki API to traverse the folder structure:\n\nfeishu_wiki action=\"get\" token=\"{node_token}\"         # Get folder info\nfeishu_wiki action=\"nodes\" space_id=\"{space_id}\"      # List child nodes\n\n\nFor folders with has_child: true, recursively process child nodes.\n\nStep 3: Document Reading\n\nFor each document node, read its content:\n\nfeishu_doc action=\"read\" doc_token=\"{obj_token}\"\n\nStep 4: Generate Summary\n\nExtract from each document:\n\nTitle: Document title\nType: Document or Folder\nStatus: Complete, In Progress, or Empty\nCore Content: Key points, main topics, important information\nChild Documents: If folder, list contained documents\nStep 5: Compile Report\n\nGenerate a Markdown report with:\n\nHeader (source URL, generation time, document count)\nDirectory tree visualization\nHierarchical summaries (by folder level)\nStatistics table\nRelated links\nOutput Format\n\nThe generated report includes:\n\n# {Folder Name} Document Summary Report\n\n**Source:** {URL}  \n**Generated:** {Timestamp}  \n**Total Documents:** {Count}\n\n---\n\n## Directory Structure\n\n{Tree visualization}\n\n---\n\n## Level 1 Summaries\n\n### 1. {Document Name}\n- **Type:** {docx/folder}\n- **Status:** {Complete/In Progress/Empty}\n- **Summary:** {Core content description}\n\n### 2. {Folder Name}/\n- **Type:** folder\n- **Documents:** {Count}\n- **Summary:** {Folder description}\n\n#### 2.1 {Child Document}\n- **Type:** docx\n- **Summary:** {Content summary}\n\n---\n\n## Statistics\n\n| Category | Count | Status |\n|----------|-------|--------|\n| Total | X | - |\n| Complete | X | ✅ |\n| In Progress | X | 🚧 |\n| Empty | X | ⚠️ |\n\n---\n\n*Report generated by feishu-folder-summary skill*\n\nExample Usage\n\nUser Request:\n\n\"Extract summaries from https://caz6yhvgk5z.feishu.cn/wiki/BzslwD3Nei1Dggkvin5cV2hDnob\"\n\nSkill Execution:\n\nParse URL → Wiki folder, node_token=BzslwD3Nei1Dggkvin5cV2hDnob\nGet folder info → space_id=7593876306731732193, title=\"AI云平台\"\nRecursively traverse → Found 14 level-1 nodes, 30+ child documents\nRead each document → Extract content and generate summaries\nCompile report → Generate comprehensive Markdown summary\n\nOutput:\n\nComplete directory tree\nHierarchical summaries for all 44 documents\nStatus tracking (✅ Complete, 🚧 In Progress, ⚠️ Empty)\nStatistics overview\nKey Considerations\nRecursive Depth: Process all levels of nested folders\nDocument Types: Handle docx (documents) and folder (containers)\nError Handling: Continue processing if individual document read fails\nContent Length: Generate concise but informative summaries\nStatus Detection: Identify empty or placeholder documents\nToken Efficiency: Summarize long documents appropriately\nAPI Reference\n\nSee references/feishu_api.md for detailed API documentation."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/henryjing96/feishu-folder-summary",
    "publisherUrl": "https://clawhub.ai/henryjing96/feishu-folder-summary",
    "owner": "henryjing96",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/feishu-folder-summary",
    "downloadUrl": "https://openagent3.xyz/downloads/feishu-folder-summary",
    "agentUrl": "https://openagent3.xyz/skills/feishu-folder-summary/agent",
    "manifestUrl": "https://openagent3.xyz/skills/feishu-folder-summary/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/feishu-folder-summary/agent.md"
  }
}