← Back to Skills Marketplace
hei-maom

group-director

by HeiMaoM · GitHub ↗ · v1.0.2 · MIT-0
cross-platform ⚠ suspicious
218
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install group-director
Description
create short videos from claw-prepared prompts for feishu or lark group chat scenarios. use when claw already has the chat context in its own memory, has alr...
README (SKILL.md)

group-director

Use this skill only as a video execution layer for Feishu/Lark group-chat video generation.

Hard rules

  • Assume Claw already has enough context from its own memory and recent reading.
  • Do not ask extra questions in normal group-director use.
  • Do not ask the user to repeat or recap the group chat.
  • Do not read Feishu/Lark history inside this skill.
  • Do not summarize group chat inside this skill.
  • Treat final_video_prompt as already finalized by Claw.
  • Use exactly two steps:
    1. create the task
    2. poll by Python every 30 seconds until it finishes
  • Keep the model fixed to Seedance-Pro-1.5.
  • Always set provider_specific.generate_audio=true.
  • Never send raw JSON back to Feishu.
  • When the task finishes successfully, send only a normal natural-language message plus the final video_url.
  • Do not send debug objects, raw provider payloads, or JSON-looking blocks to Feishu.

What Claw is responsible for

Claw is responsible for:

  • reading the group context
  • using its own memory and recent context
  • summarizing the discussion when needed
  • turning that into the final video prompt
  • calling this skill
  • sending the final natural-language message back to Feishu/Lark

What this skill is responsible for

This skill is responsible only for:

  • creating the video task
  • polling status until completion, failure, or timeout
  • returning the final video URL or a plain-text failure message

Fixed defaults

  • model: Seedance-Pro-1.5
  • duration: 12
  • resolution: 720p
  • allowed orientation: portrait or landscape
  • poll interval: 30 seconds
  • timeout: 600 seconds
  • audio generation: always enabled

Do not expose square mode. Do not let the model vary. Do not omit generate_audio.

Input expected from Claw

Required:

  • final_video_prompt

Optional:

  • orientation

If orientation is missing, default to portrait. If orientation is present, it must be portrait or landscape.

Calling pattern

Step 1: create task

python3 scripts/main.py video-create \
  --final-video-prompt "这里放 Claw 已整理好的最终视频提示词" \
  --orientation portrait

This returns only the task_id as plain text.

Step 2: poll by Python until done

python3 scripts/main.py video-poll --task-id "task_xxx"

This polls every 30 seconds until one of these happens:

  • completed -> prints only the final video_url
  • failed -> prints a plain-text failure message
  • timeout -> prints a plain-text timeout message

Feishu return rule

When Claw sends the result back to Feishu/Lark:

  • use a normal message
  • include the final video_url
  • do not include raw JSON
  • do not include provider payloads
  • do not paste structured blobs

Good style:

视频生成好了:
https://...

Bad style:

{"status":"completed","task_id":"...","video_url":"https://..."}

Environment variable

Only this variable is required:

export SENSEAUDIO_API_KEY="your_key"

Optional:

export SENSEAUDIO_BASE_URL="https://api.senseaudio.cn"

Resource layout

  • scripts/main.py: CLI entrypoint with plain-text outputs
  • scripts/video_api.py: provider wrapper for create, status, and polling
  • references/provider_notes.md: fixed model and parameter notes
  • references/integration_cn.md: Chinese integration rules for Claw
Usage Guidance
This skill appears to do what it says (create and poll SenseAudio video tasks) and the included code matches the SKILL.md rules. However: 1) the registry metadata incorrectly states no required environment variables while the code requires SENSEAUDIO_API_KEY — confirm the registry is updated or that you can provide the API key. 2) Ensure your agent/runtime provides Python and the requests library (the package does not declare dependencies). 3) Be careful with SENSEAUDIO_BASE_URL — only set it to a trusted provider endpoint. 4) If you plan to install this in a production agent, ask the maintainer to add a proper dependency/install spec and to correct the manifest so required credentials are explicit. If you cannot verify the owner or cannot supply the API key securely, do not enable the skill.
Capability Analysis
Type: OpenClaw Skill Name: group-director Version: 1.0.2 The skill is a legitimate integration for the SenseAudio video generation service (api.senseaudio.cn), providing a CLI and API wrapper to create and poll video tasks. The Python scripts (scripts/main.py and scripts/video_api.py) follow standard practices for API interaction using the requests library, and the instructions in SKILL.md are focused on workflow efficiency and output formatting for Feishu/Lark without any signs of malicious intent, data exfiltration, or unauthorized execution.
Capability Assessment
Purpose & Capability
The name/description and code both implement a video-creation executor calling SenseAudio endpoints (create + poll) and returning a plain URL for Feishu/Lark. Requiring an API key for the provider is appropriate. However, the registry metadata (Requirements) incorrectly lists no required environment variables or primary credential while SKILL.md and the code require SENSEAUDIO_API_KEY; this mismatch is an incoherence that should be resolved before trusting the package metadata.
Instruction Scope
SKILL.md constrains the skill to only accept a final_video_prompt and an optional orientation, perform create+poll, and return a plain-text URL or error message. The code follows this: it does not read chat history, does not emit raw JSON to Feishu, and prints only task_id or video_url / plain error text. No unexpected file reads or external endpoints are referenced beyond the provider base URL.
Install Mechanism
There is no install spec (instruction-only style) which minimizes automated installation risk. However, the included Python scripts use the requests library and assume a Python runtime; the package does not declare this dependency or any setup instructions. That omission is a usability/security concern (missing dependency declaration), though not evidence of malicious intent.
Credentials
At runtime the skill only needs SENSEAUDIO_API_KEY (required) and an optional SENSEAUDIO_BASE_URL — both proportional to calling an external video API. The concern is the manifest/registry metadata claims no env vars are required (contradiction). Also SENSEAUDIO_BASE_URL can be overridden to point to any host, which is a valid feature for testing but should be noted as a potential avenue to redirect requests if an operator or environment variable is misconfigured or maliciously set.
Persistence & Privilege
The skill does not request elevated or persistent privileges, does not set always:true, and does not modify other skills or system settings. Autonomous invocation is allowed by default but that is normal; nothing in the package grants it unusual permanence or cross-skill access.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install group-director
  3. After installation, invoke the skill by name or use /group-director
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
**Summary: This version simplifies group-director to a pure video execution layer, removing chat reading and summarization.** - Now requires Claw to provide a pre-written, finalized video prompt; does not read, summarize, or process group chat itself. - Redesigned workflow: only creates a video task and polls for completion, returning a plain video URL or error text. - Model fixed to Seedance-Pro-1.5 with audio generation always on; orientation only portrait/landscape. - Outputs to Feishu are always plain text; never sends JSON or structured/raw provider payloads. - Old scripts for chat reading, ASR, summarization, and Feishu API are removed; only video creation logic remains. - Adds Chinese integration and provider reference notes; updates documentation to clarify new contract and usage.
v1.0.1
No user-facing changes in this version. - No file changes detected between 1.0.0 and 1.0.1. - Documentation and features remain unchanged.
v1.0.0
**Initial release of group-director: automated Feishu/Lark group video summaries** - Adds a director mode triggerable via "群聊导演" or its variants, summarizing recent group chat (text + voice). - Integrates ASR for voice messages; combines text and transcriptions for context gathering. - Removes reliance on StoryBoard API—generates video stories internally, with 1 self-review iteration. - Directly creates videos via SenseAudio API and sends native Feishu videos back to the group. - Protects concurrent video tasks per API key, allowing only one active job per key at a time. - Includes clear error handling: context missing, ASR failures, video timeouts, or Feishu send issues are reported explicitly.
Metadata
Slug group-director
Version 1.0.2
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is group-director?

create short videos from claw-prepared prompts for feishu or lark group chat scenarios. use when claw already has the chat context in its own memory, has alr... It is an AI Agent Skill for Claude Code / OpenClaw, with 218 downloads so far.

How do I install group-director?

Run "/install group-director" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is group-director free?

Yes, group-director is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does group-director support?

group-director is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created group-director?

It is built and maintained by HeiMaoM (@hei-maom); the current version is v1.0.2.

💬 Comments