← Back to Skills Marketplace
70
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install time-calc
Description
通过 7 个原子操作完成日期时间的计算与解析：获取当前时间、日期元信息查询、相对星期查找、 日期时间加减、日期时间差值、时区转换、Unix 时间戳互转。 两类触发场景：(1) 用户直接提问时间问题，如当前日期、星期几、日期加减、日期差值、 时区换算、时间戳转换、闰年判断、第几周等。 (2) 用户请求中包含可解析为...
Usage Guidance
This skill is internally consistent for date/time tasks and doesn't ask for credentials or external installs. Before enabling it, confirm the agent runtime will (1) actually run shell commands only within a restricted context, (2) properly escape or validate any user-supplied date/time strings before interpolating them into shell commands to avoid command injection, and (3) grant the skill only the minimal shell privileges needed. Also test on your target OS because date command behavior differs across platforms (the skill provides cross-platform reference files and safe schemes for GNU date month/year adjustments). If you cannot ensure safe shell invocation or input sanitization, consider rejecting or sandboxing the skill.
Capability Analysis
Type: OpenClaw Skill
Name: time-calc
Version: 1.0.0
The skill provides a framework for date and time calculations by instructing the AI agent to execute shell and PowerShell commands across different platforms. While the logic in SKILL.md and the reference files (linux.md, macos.md, windows.md) is technically sound and aligned with the stated purpose, the design pattern of constructing shell commands from user-provided strings (e.g., dates and offsets) without explicit sanitization instructions introduces a significant risk of shell injection. The use of complex nested command substitutions and arithmetic expansion in the Linux and macOS reference files further increases the attack surface for potential RCE if the agent is manipulated via prompt injection.
Capability Assessment
Purpose & Capability
Name/description (time/date arithmetic and parsing) match the actual contents: an instruction-only skill that runs platform-specific shell commands (BSD/GNU/PowerShell) using the included references. It does not request unrelated credentials, binaries, or config paths.
Instruction Scope
SKILL.md instructs the agent to detect the platform, read the skill's own reference files ($SKILL_ROOT/references/*.md), and execute shell commands to compute times. This is appropriate for the stated purpose, but because the runtime executes shell commands constructed from user inputs, there is an implementation risk: user-provided strings must be safely validated/escaped to avoid command injection. The skill itself documents safe handling for month/year arithmetic (GNU date overflow handling).
Install Mechanism
No install spec and no code files beyond documentation — lowest-risk model. Nothing is downloaded or written to disk by an installer.
Credentials
The skill requires no environment variables, credentials, or external config paths beyond reading its own bundled reference files. Requested access is proportional to its function.
Persistence & Privilege
always:false and user-invocable:true; the skill does not request permanent presence or attempt to modify other skill/system settings. Autonomous invocation is allowed (platform default) but not excessive here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install time-calc - After installation, invoke the skill by name or use
/time-calc - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
time-calc v1.0.0 Initial Release
- Provides 7 atomic operations for date/time calculation and parsing: current time, date info, relative weekday, add/subtract, difference, timezone conversion, and Unix timestamp conversion.
- Directly invokes platform-specific shell commands for all operations; no mental math or external dependencies required.
- Supports smart parsing of user queries (e.g., “明天”, “下周三”, “3天后”) and maps to corresponding time calculation.
- Handles complex corner cases like month-end adjustment for date arithmetic and correct weekday calculation per ISO week.
- Cross-platform: macOS, Linux (WSL), and Windows PowerShell supported, with detailed platform references for each operation.
- Fully user-invocable for a wide variety of everyday and technical date/time questions.
Metadata
Frequently Asked Questions
What is time-calc?
通过 7 个原子操作完成日期时间的计算与解析：获取当前时间、日期元信息查询、相对星期查找、 日期时间加减、日期时间差值、时区转换、Unix 时间戳互转。 两类触发场景：(1) 用户直接提问时间问题，如当前日期、星期几、日期加减、日期差值、 时区换算、时间戳转换、闰年判断、第几周等。 (2) 用户请求中包含可解析为... It is an AI Agent Skill for Claude Code / OpenClaw, with 70 downloads so far.
How do I install time-calc?
Run "/install time-calc" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is time-calc free?
Yes, time-calc is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does time-calc support?
time-calc is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created time-calc?
It is built and maintained by LiaoYk (@mrlyk); the current version is v1.0.0.
More Skills