How do I install the Greenclaw Usage skill?

Run npx skillmds@latest add dvcrn/greenclaw-usage in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Greenclaw Usage safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. Capability flags: reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Greenclaw Usage?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Greenclaw Usage free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Greenclaw Usage?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Greenclaw Usage by dvcrn — Agent Skill

Name: Greenclaw Usage
Rating: 4.2 (5 reviews)
Author: dvcrn

File contents

GreenClaw Usage Analytics

You have access to the greenclaw CLI tool for querying token usage, cost analytics, and managing budget alerts. Run it via npx greenclaw (requires pnpm install and pnpm build first). All commands output JSON.

Available Commands

Usage Queries

Daily summary:

 npx greenclaw usage summary --period day

Weekly or monthly summary:

 npx greenclaw usage summary --period week
 npx greenclaw usage summary --period month

Breakdown by model, tier, or provider:

 npx greenclaw usage breakdown --by model --period day
 npx greenclaw usage breakdown --by tier --period week
 npx greenclaw usage breakdown --by provider --period month

Trends over time:

 npx greenclaw usage trends --period day --last 7
 npx greenclaw usage trends --period week --last 4

Budget Alerts

List alert rules:

 npx greenclaw alerts list

Set a daily cost budget:

 npx greenclaw alerts set --name "daily budget" --metric daily_cost --threshold 50 --unit usd --period day

Set a weekly token limit:

 npx greenclaw alerts set --name "weekly tokens" --metric weekly_cost --threshold 100 --unit usd --period week

Set a per-model cost cap:

 npx greenclaw alerts set --name "gpt-4 cap" --metric per_model_cost --threshold 30 --unit usd --period day --model gpt-4

Check alerts now:

 npx greenclaw alerts check

View alert history:

 npx greenclaw alerts history --last 10

Remove an alert rule:

 npx greenclaw alerts remove <rule-id>

Raw Traces

Aggregated stats:

 npx greenclaw traces --stats

Filter by tier or model:

 npx greenclaw traces --tier HEARTBEAT
 npx greenclaw traces --model gpt-4o-mini

How to Present Results

Parse the JSON output and present it in a clear, readable format
For summaries: show total tokens, cost, savings, and request count
For breakdowns: show a table with group key, tokens, cost, savings
For alerts: explain which rules triggered and current metric values
Round dollar amounts to 2 decimal places
Use natural language to explain savings (e.g., "You saved $8.91 today by routing 412 requests through cheaper models")

Environment

The greenclaw CLI uses the GREENCLAW_TELEMETRY_DB environment variable for the SQLite database path (defaults to data/telemetry.db).

---name: greenclaw-usagedescription: Token usage analytics and budget alerting for the GreenClaw inference proxy. Query spending, set budget alerts, and track savings.---# GreenClaw Usage AnalyticsYou have access to the `greenclaw` CLI tool for querying token usage, cost analytics, and managing budget alerts. Run it via `npx greenclaw` (requires `pnpm install` and `pnpm build` first). All commands output JSON.## Available Commands### Usage Queries**Daily summary:**```bash npx greenclaw usage summary --period day```**Weekly or monthly summary:**```bash npx greenclaw usage summary --period week npx greenclaw usage summary --period month```**Breakdown by model, tier, or provider:**```bash npx greenclaw usage breakdown --by model --period day npx greenclaw usage breakdown --by tier --period week npx greenclaw usage breakdown --by provider --period month```**Trends over time:**```bash npx greenclaw usage trends --period day --last 7 npx greenclaw usage trends --period week --last 4```### Budget Alerts**List alert rules:**```bash npx greenclaw alerts list```**Set a daily cost budget:**```bash npx greenclaw alerts set --name "daily budget" --metric daily_cost --threshold 50 --unit usd --period day```**Set a weekly token limit:**```bash npx greenclaw alerts set --name "weekly tokens" --metric weekly_cost --threshold 100 --unit usd --period week```**Set a per-model cost cap:**```bash npx greenclaw alerts set --name "gpt-4 cap" --metric per_model_cost --threshold 30 --unit usd --period day --model gpt-4```**Check alerts now:**```bash npx greenclaw alerts check```**View alert history:**```bash npx greenclaw alerts history --last 10```**Remove an alert rule:**```bash npx greenclaw alerts remove <rule-id>```### Raw Traces**Aggregated stats:**```bash npx greenclaw traces --stats```**Filter by tier or model:**```bash npx greenclaw traces --tier HEARTBEAT npx greenclaw traces --model gpt-4o-mini```## How to Present Results- Parse the JSON output and present it in a clear, readable format- For summaries: show total tokens, cost, savings, and request count- For breakdowns: show a table with group key, tokens, cost, savings- For alerts: explain which rules triggered and current metric values- Round dollar amounts to 2 decimal places- Use natural language to explain savings (e.g., "You saved $8.91 today by routing 412 requests through cheaper models")## EnvironmentThe `greenclaw` CLI uses the `GREENCLAW_TELEMETRY_DB` environment variable for the SQLite database path (defaults to `data/telemetry.db`).

Frequently asked questions

Greenclaw Usage