dingtalk-misc

Operate long-tail DingTalk products like approvals, attendance, reports, and sheets via dws CLI.

2.8k|221|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli --skill dingtalk-misc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dingtalk-misc
Source: https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli/tree/main/skills/multi/dingtalk-misc
Command: npx skills add https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli --skill dingtalk-misc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openpyxl, and includes scripts (resource) and references (resource) components.

What problem does it solve?

It routes natural-language requests to the correct low-frequency DingTalk product commands (OA approvals, attendance, live, DING, dev apps, Agoal goals, reports, sheets, whiteboard, recruiting, and more) so agents do not guess command syntax or mix up product boundaries.

Core Features & Use Cases

  • Product routing index: Maps trigger keywords to the exact dws command prefix and a dedicated reference file for each of 17+ DingTalk products.
  • Attendance workflows: Query check-in records, import schedules, and export monthly/daily/detail Excel reports through guarded Python scripts.
  • Agoal and report separation: Distinguishes rule-level submission statistics and follow-ups (Agoal) from daily/weekly/monthly report content (Report).
  • Use Case: Ask to export last month's attendance report for a department; the skill resolves user IDs, runs the monthly report script, and returns an Excel file with warnings preserved.

Quick Start

Ask the agent to check your pending OA approvals or export this month's attendance report for your team using the dws CLI.

Frequently Asked Questions about dingtalk-misc

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I export a DingTalk attendance report to Excel?

Use the attendance report scripts with resolved user IDs and a date range, such as attendance_report_monthly.py for monthly summaries. The script handles batching, column mapping, and Excel generation, returning the output path and any warnings.

How do I query or approve pending OA approvals in DingTalk?

Route approval tasks to the oa reference, which covers listing pending approvals, viewing details, and approving, rejecting, transferring, or revoking instances via the dws oa command prefix. Real-time approval event listening belongs to the separate dingtalk-event skill.

What is the difference between Agoal and Report for weekly reports?

Report handles writing, submitting, and querying daily/weekly/monthly report content. Agoal handles rule-level statistics like on-time, late, and not-submitted counts plus personnel follow-ups, so the skill checks for rule or statistics keywords before routing.

Does this skill support DingTalk developer app management?

Yes, the dws dev prefix covers enterprise internal apps including credentials, members, permissions, robots, versions, event subscriptions, and MCP services. Single-domain tasks load exactly one dev reference file.

Why does a write operation require confirmation before executing?

Write commands marked user_required must first run with dry-run to preview the exact target, action, and parameters. Only after explicit user confirmation is the same command re-run with the confirmation flag, preventing unintended changes.

What dependencies do the attendance export scripts need?

The Excel export scripts require the openpyxl Python package and an authenticated dws CLI on PATH. Missing dependencies are reported to the user rather than auto-installed.