← Back to Skills Marketplace
x3r081

Cron Job Token Auditor

by x3r081 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
107
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install cron-job-token-auditor
Description
Audits OpenClaw Gateway cron jobs from jobs.json (or CLI), classifies scheduled workloads by token cost (agent turns vs deterministic work), and suggests whe...
README (SKILL.md)

Cron Job Auditor

This skill guides read-only reviews of OpenClaw Gateway cron jobs so the user can spot token-saving opportunities—typically moving purely mechanical recurring work to an OS-scheduled script (systemd timer, launchd, etc.) that calls openclaw message send without running the model on every tick.

Hard boundaries

  • Do not edit jobs.json, systemd units, or user scripts unless the user explicitly asks for a draft or a diff to apply themselves.
  • Do not claim guaranteed savings; give confidence levels (high / medium / low).
  • Do not assume paths: default is often ~/.openclaw/cron/jobs.json — confirm or use openclaw cron / docs if the install differs.

When to apply this skill

  • User asks to audit, review, optimize, or reduce tokens for cron, scheduled jobs, or recurring OpenClaw tasks.
  • User shares or points to jobs.json (or pastes JSON).

What to read

  1. jobs.json (or user-provided excerpt): each job’s name, enabled, schedule, payload, delivery, agentId.
  2. Prefer openclaw cron / openclaw cron list (or current CLI) when available — aligns with the live Gateway.
  3. REFERENCE.md in this skill folder for glossary and checklist language.

Classification (per job)

  • payload.kind: agentTurn → counts as LLM-invoking for each run (unless documentation says otherwise for this version).
  • Extract a short summary of the message / instructions (first ~200 chars + ellipsis if long). Do not reproduce secrets or API keys; redact chat IDs as ***.

Heuristics — “script candidate”

Flag as candidate only when medium or high confidence:

Signal Suggests
Same task could be a shell/Python script + one message Possible migration
Prompt needs search, summarization, judgment, variable tool use Usually keep agent cron
Only fetch fixed URL, run CLI, grep, template message Stronger candidate

Patterns (map each candidate to one):

  • A — CLI + send: e.g. some-cli … \| … then openclaw message send …
  • B — HTTP + send: curl/fetch + parse + send (no LLM).
  • C — Hybrid: data from script; optional rare agent run for exceptions only (document separately).

Output format — use this template every time

## Cron Job Auditor — Summary

- **Source**: (path or CLI)
- **Jobs scanned**: N (enabled: M)
- **Likely LLM per run**: (count of agentTurn-style jobs, or “unknown” if schema unclear)

## Per-job table

| Job name | Enabled | Schedule | Payload kind | LLM? | Confidence (migration) | Notes |
|----------|---------|----------|--------------|------|------------------------|-------|

## Candidates for OS timer + script (no auto-migration)

For each row with confidence **medium** or **high**:

### 1. `\x3Cjob name>`

- **Why it costs tokens**: …
- **Suggested pattern**: A / B / C (one paragraph)
- **Prerequisites**: …
- **Manual steps** (numbered):
  1. Implement script at `…` (user path)
  2. Test with dry-run / manual run
  3. Add systemd timer (or launchd) — user edits unit files
  4. **Disable or remove** the Gateway cron entry to avoid duplicate sends
  5. Verify with checklist in REFERENCE.md

## Not recommended for migration

| Job | Reason |
|-----|--------|

## Low-confidence items

(Brief list — what would be needed to decide.)

Tone

  • Clear, cautious, actionable. Prefer numbered steps over prose walls.
  • Link to OpenClaw Cron documentation when reminding users how Gateway scheduling works.

Related

  • Users who already moved jobs to OS scripts often keep openclaw message send for delivery only — that path avoids per-tick LLM usage for the poll itself.
Usage Guidance
This is a read-only advisory skill and appears coherent: it will examine jobs.json or use the OpenClaw CLI to produce audit reports and migration suggestions. Before installing, confirm that the agent will only be given access to the job definitions you want it to see (do not upload secrets or API keys). If you paste job JSON for review, redact any inline tokens/IDs you don't want exposed. Remember the agent could be invoked autonomously by default—if you prefer manual invocation, keep using it only on demand. If you need higher assurance, request the skill author to publish a minimal CHANGELOG or sign-off, but functionally the skill is proportionate to its purpose.
Capability Analysis
Type: OpenClaw Skill Name: cron-job-token-auditor Version: 1.0.0 The 'cron-job-token-auditor' skill is a read-only advisory tool designed to help users optimize token usage by identifying OpenClaw cron jobs that can be replaced by standard OS scripts. The instructions in SKILL.md and REFERENCE.md explicitly restrict the agent from making unauthorized changes to system configurations or job files, focusing instead on analysis and reporting. No evidence of data exfiltration, malicious execution, or prompt injection was found.
Capability Assessment
Purpose & Capability
Name/description match the runtime instructions: the skill only needs to read jobs.json or use the OpenClaw CLI to classify scheduled jobs and recommend script-based migrations. No unrelated binaries, services, or credentials are requested.
Instruction Scope
SKILL.md confines itself to reading job definitions (jobs.json or openclaw cron), heuristics for classification, redaction of secrets, and producing a report. It explicitly forbids editing jobs.json or system units unless the user requests drafts; it does not instruct the agent to read other system files or exfiltrate data to external endpoints.
Install Mechanism
There is no install spec and no code files—this is documentation-only. Nothing is downloaded, written, or executed by the skill itself, minimizing install-time risk.
Credentials
The skill declares no required environment variables, credentials, or config paths. The operations described (reading jobs.json or invoking the OpenClaw CLI) align with the skill's stated purpose and do not request excessive permissions.
Persistence & Privilege
always:false and normal autonomous invocation are appropriate. The skill does not request permanent system changes or to modify other skills/configs; SKILL.md explicitly forbids automatic edits.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install cron-job-token-auditor
  3. After installation, invoke the skill by name or use /cron-job-token-auditor
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of Cron Job Token Auditor — a READ-ONLY tool for optimizing OpenClaw Gateway cron jobs and reducing LLM token consumption. - Audits jobs.json or CLI-listed cron jobs, identifying recurring LLM-invoking workloads. - Classifies each job by token cost and migration confidence, highlighting opportunities to use OS timers plus scripts as alternatives. - Provides clear, per-job summaries and actionable migration steps without editing or migrating jobs automatically. - Helps users review, optimize, or reduce token usage for scheduled OpenClaw tasks. - Follows strict boundaries: no automatic changes, no guaranteed savings, and no assumption of user environment specifics.
Metadata
Slug cron-job-token-auditor
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Cron Job Token Auditor?

Audits OpenClaw Gateway cron jobs from jobs.json (or CLI), classifies scheduled workloads by token cost (agent turns vs deterministic work), and suggests whe... It is an AI Agent Skill for Claude Code / OpenClaw, with 107 downloads so far.

How do I install Cron Job Token Auditor?

Run "/install cron-job-token-auditor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Cron Job Token Auditor free?

Yes, Cron Job Token Auditor is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Cron Job Token Auditor support?

Cron Job Token Auditor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Cron Job Token Auditor?

It is built and maintained by x3r081 (@x3r081); the current version is v1.0.0.

💬 Comments