← Back to Skills Marketplace
TimeCamp
by
kamil-rudnicki
· GitHub ↗
· v1.1.1
· MIT-0
776
Downloads
0
Stars
1
Active Installs
3
Versions
Install in OpenClaw
/install timecamp
Description
Use when the user asks about time tracking, time entries, tasks, timers, or anything related to TimeCamp. Triggers on keywords like "timecamp", "time entries...
Usage Guidance
This skill mostly does what it says (interact with TimeCamp and run a data pipeline), but it expects you to clone and run external repositories and tools that the skill metadata doesn't list. Before installing or running it: 1) verify the GitHub repos (https://github.com/timecamp-org/...) are authentic and review their code; 2) ensure you have or are willing to install git, npm, Python and DuckDB (and clarify what 'uv run' means); 3) use a dedicated/limited TIMECAMP_API_KEY (don't expose a full admin key); 4) be aware the pipeline can fetch 'computer_activities' (desktop telemetry) — avoid running that if you don't want local activity data collected; 5) refuse or inspect any automatic 'npm link' or other commands that install code globally. If you want to proceed safely, ask the publisher for a homepage or signed release artifacts and clarification of the 'uv' command and required binaries.
Capability Analysis
Type: OpenClaw Skill
Name: timecamp
Version: 1.1.1
The skill automates the cloning and execution of external code from GitHub repositories (timecamp-org) and uses 'uv run' to execute Python scripts with dynamic dependency installation in SKILL.md. While these actions are aligned with the stated purpose of providing a TimeCamp integration and include user confirmation steps, the pattern of downloading and running remote artifacts constitutes a high-risk capability. The skill also requires a sensitive environment variable (TIMECAMP_API_KEY) and performs broad file system and network operations.
Capability Assessment
Purpose & Capability
The skill's declared purpose (TimeCamp time tracking, entries, timers, analytics) aligns with the instructions. However, the SKILL.md expects cloning and running two GitHub repositories and invoking tools (git, npm, Python pipeline, DuckDB) while the skill metadata lists no required binaries or install steps. The missing declaration of git/npm/python/duckdb/uv is an incoherence: the skill implicitly requires them but doesn't declare them.
Instruction Scope
Instructions stay within TimeCamp functionality (timer/entries/analytics) and include sensible safety prompts (ask before cloning, confirm before modifying entries, show commands). But the data pipeline explicitly fetches 'computer_activities' (desktop app tracking) and writes JSONL data under ~/data and uses ~/.duckdb — this accesses potentially sensitive personal telemetry. The SKILL.md also refers to an ambiguous command 'uv run --with-requirements requirements.txt', which is not a standard, widely-known tool and should be clarified before execution.
Install Mechanism
This is instruction-only (no install spec), so nothing is automatically installed by the registry. However, the runtime guidance clones external GitHub repos and suggests running 'npm link' and other commands that will write and execute code on the user's disk. Cloning arbitrary repos is higher-risk than instruction-only usage and the repos' provenance is not verifiable from the metadata (homepage: none).
Credentials
Only TIMECAMP_API_KEY is required, which is appropriate for a TimeCamp integration. No unrelated credentials are requested. That said, the pipeline will fetch potentially sensitive datasets (computer activities), so limiting the API key's scope and using a dedicated account/token is advisable.
Persistence & Privilege
The skill is not always-enabled, does not request elevated registry privileges, and is user-invocable. It does write/read files under user home when following its instructions (~/utils, ~/data, ~/.duckdb), which is expected for local tooling but should be made explicit to the user.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install timecamp - After installation, invoke the skill by name or use
/timecamp - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.1
- Added Author and License sections to documentation.
- No changes to code or functionality.
- Documentation now clarifies software authorship and license (MIT).
v1.1.0
**Major update: Migrated from a custom shell script to official CLI and analytics pipeline tools for TimeCamp.**
- Replaced the legacy wrapper script with two official tools: TimeCamp CLI (for personal actions) and a dedicated Data Pipeline (for analytics and reports).
- Added instructions for repo location, auto-clone, and env vars for robust setup.
- Provided detailed CLI usage examples for tracking, time entry management, and task listing.
- Introduced advanced analytics and reporting workflow using the data pipeline and DuckDB queries.
- Updated trigger keywords and usage description for better discoverability and coverage.
- Removed the legacy bash wrapper (`scripts/timecamp-wrapper.sh`); all workflows now use the official tools.
v1.0.0
Initial release of the TimeCamp skill:
- Start, stop, and check the status of time tracking timers.
- Add, update, remove, and list time entries (with options for date ranges and details).
- List available tasks and refresh the task cache.
- Supports both task IDs and partial name selectors, with automatic disambiguation for multiple matches.
Metadata
Frequently Asked Questions
What is TimeCamp?
Use when the user asks about time tracking, time entries, tasks, timers, or anything related to TimeCamp. Triggers on keywords like "timecamp", "time entries... It is an AI Agent Skill for Claude Code / OpenClaw, with 776 downloads so far.
How do I install TimeCamp?
Run "/install timecamp" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is TimeCamp free?
Yes, TimeCamp is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does TimeCamp support?
TimeCamp is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created TimeCamp?
It is built and maintained by kamil-rudnicki (@kamil-rudnicki); the current version is v1.1.1.
More Skills