Agent skill

Managing Cloud Usage

by hashgraph-online in hashgraph-online/awesome-codex-plugins

A skill your agent uses when the user asks about quota, billing visibility, or processed-page counts.

Apache-2.0Auto-check passedBackend & APIs

Install Managing Cloud Usage

skills CLI
$ npx skills add hashgraph-online/awesome-codex-plugins --skill managing-cloud-usage -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hashgraph-online/awesome-codex-plugins managing-cloud-usage --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/kreuzberg-dev/plugins/plugins/kreuzberg-cloud/skills/managing-cloud-usage .claude/skills/managing-cloud-usage && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
managing-cloud-usage
GitHub stars
1.2k
Token cost
~720 tokens
SKILL.md length
232 words
Files
1
Skills in repo
686
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when the user asks about quota, billing visibility, or processed-page counts.

  • The user asks about quota
  • SKILL.md covers Endpoint, Response (200), Examples and When to report usage to the user, plus 1 more section
  • Calls curl and jq; reaches api.kreuzberg.dev; needs KREUZBERG_API_KEY
  • Billing visibility

What it does

Managing Cloud Usage is an agent skill from hashgraph-online/awesome-codex-plugins. Use when the user asks about quota, billing visibility, or processed-page counts. Covers GET /v1/usage — query params, response shape, when to report usage proactively to the user.

Its SKILL.md is about 720 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs. The repository describes itself as: A curated list of awesome OpenAI Codex / ChatGPT plugins, skills, and resources. The 1 Codex Marketplace. See live plugins at: https://hol.org/plugins/best-codex-plugins. The licence is Apache-2.0.

When your agent uses it

  • The user asks about quota
  • Billing visibility
  • Processed-page counts

Example prompts

  • “/managing-cloud-usage”

Requirements

  • A credential in KREUZBERG_API_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit 78497e5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • jq

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.kreuzberg.dev

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • KREUZBERG_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Managing Cloud Usage loads about 720 tokens when it runs. Until then it costs about 50 tokens; SKILL.md has 232 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~50
When it runs · the whole SKILL.md, loaded when a task matches
~720

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from hashgraph-online/awesome-codex-plugins at commit 78497e5, republished under its Apache-2.0 licence (© hashgraph-online). 232 words, ~720 tokens.

Download SKILL.mdSave it as .claude/skills/managing-cloud-usage/SKILL.md (or your agent's skills folder).
name
managing-cloud-usage
description
Use when the user asks about quota, billing visibility, or processed-page counts. Covers GET /v1/usage — query params, response shape, when to report usage proactively to the user.

Managing cloud usage

GET /v1/usage is the only endpoint for quota and billing visibility. It returns aggregate counters for the queried period plus the remaining quota for the project.

Endpoint

text
GET https://api.kreuzberg.dev/v1/usage
Authorization: Bearer $KREUZBERG_API_KEY
Query parameters
ParamFormatDefault
startISO-8601 date (e.g. 2026-03-01)First day of current month.
endISO-8601 date (e.g. 2026-04-01)First day of next month.

Both are optional. Omit both for the current calendar month.

Response (200)

json
{
  "period_start": "2026-05-01",
  "period_end": "2026-06-01",
  "total_pages": 5432,
  "total_documents": 87,
  "total_failed": 2,
  "quota_limit": 100000,
  "quota_remaining": 94568,
  "by_mime_type": {
    "application/pdf": { "documents": 65, "pages": 3200, "failed": 1 },
    "image/png":       { "documents": 15, "pages": 1800, "failed": 0 },
    "text/plain":      { "documents":  7, "pages":  432, "failed": 1 }
  }
}
Reading the response
  • total_pages — pages billed in the period. The unit of cost.
  • total_documents — files submitted, regardless of page count.
  • total_failed — extractions that ended in failed status. Failed jobs do not consume quota.
  • quota_limit / quota_remaining — total and remaining pages on the current plan.
  • by_mime_type — per-MIME breakdown. Useful for identifying which document types drive cost.

Examples

Current-month usage
bash
curl -s https://api.kreuzberg.dev/v1/usage \
  -H "Authorization: Bearer $KREUZBERG_API_KEY" | jq .
Specific date range
bash
curl -s "https://api.kreuzberg.dev/v1/usage?start=2026-01-01&end=2026-02-01" \
  -H "Authorization: Bearer $KREUZBERG_API_KEY" | jq .
Quota remaining as a percentage
bash
curl -s https://api.kreuzberg.dev/v1/usage \
  -H "Authorization: Bearer $KREUZBERG_API_KEY" \
  | jq '.quota_remaining * 100 / .quota_limit'

When to report usage to the user

Pull usage proactively when:

  • A batch job submits more than ~100 documents — report quota_remaining after submit so the user can see the impact.
  • The user asks "how much have I used?" or any quota-shaped question.
  • A 429 response includes a quota-exhausted error — surface the usage shape so the user can decide whether to upgrade.
  • After a long-running crawl finishes, since page count is hard to estimate up front.

Don't report usage on every routine extraction — it's noise.

Errors

StatusCause
400start or end not ISO-8601, or end <= start.
401Bad API key.

© hashgraph-online, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/kreuzberg-dev/plugins/plugins/kreuzberg-cloud/skills/managing-cloud-usage of hashgraph-online/awesome-codex-plugins.

Open the folder on GitHubat commit 78497e5

Compare with similar skills

Managing Cloud Usage next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Managing Cloud Usage compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Managing Cloud Usage this skillhashgraph-online/awesome-codex-plugins1.2k—~720Automated safety check: PassApache-2.0
Configuring Horizoncoollabsio/coolify63k4 repos~898Automated safety check: PassMIT
Nestjs Best Practicesrolling-scopes/rsschool-app10k6 repos~1.2kAutomated safety check: PassMIT
Sub2API AdminWei-Shaw/sub2api43k1 repos~717Automated safety check: PassLGPL-3.0
Firecrawl Build Onboardingfirecrawl/firecrawl190k1 repos~1.4kAutomated safety check: NotesISC
Obsidian BasesAtmosphere/atmosphere3.8k22 repos~3.2kAutomated safety check: PassApache-2.0

Similar skills

  • Configuring Horizon

    coollabsio/coolify

    A skill your agent uses whenever the user mentions Horizon by name in a Laravel context.

    63k GitHub starsUsed in 4 repos~898 tokens
    Backend & APIsAuto-check passed
  • Nestjs Best Practices

    rolling-scopes/rsschool-app

    NestJS best practices and architecture patterns for building production-ready applications.

    10k GitHub starsUsed in 6 repos~1.2k tokens
    Backend & APIsAuto-check passed
  • Sub2API Admin

    Wei-Shaw/sub2api

    Manages a Sub2API deployment from the command line: accounts, redeem and invitation codes, groups, proxies, imports, exports and raw admin API calls.

    43k GitHub starsUsed in 1 repo~717 tokens
    Backend & APIsAuto-check passed
  • Firecrawl Build Onboarding

    firecrawl/firecrawl

    Gets Firecrawl working in a project: signs you in through the browser, saves FIRECRAWL_API_KEY to .env and picks the first SDK or REST path.

    190k GitHub starsUsed in 1 repo~1.4k tokens
    Backend & APIsAuto-check: notes
  • Obsidian Bases

    Atmosphere/atmosphere

    Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries.

    3.8k GitHub starsUsed in 22 repos~3.2k tokens
    Backend & APIsAuto-check passed
  • Fortify Development

    coollabsio/coolify

    ACTIVATE when the user works on authentication in Laravel. An agent skill from coollabsio/coolify.

    63k GitHub starsUsed in 4 repos~1.9k tokens
    Backend & APIsAuto-check passed

More from hashgraph-online/awesome-codex-plugins

All 686 skills in this repo
  • Anime Reaction Gif

    hashgraph-online/awesome-codex-plugins

    Create original anime-style reaction stickers as looping GIFs and MP4 previews, using generated character pose sheets and timed key poses.

    1.2k GitHub stars~922 tokensUpdated today
    Auto-check passed
  • Calibredb

    hashgraph-online/awesome-codex-plugins

    Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs).

    1.2k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Rust API Test Harness

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses when adding, changing, testing, or debugging Rust HTTP APIs and services, especially when Codex needs black-box integration tests, random-port app startup, real database test…

    1.2k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Art

    hashgraph-online/awesome-codex-plugins

    Make a studio's game look like something at build time — a cover from a real frame of the game (free), painted covers, backdrops, textures and character plates from image models through the…

    1.2k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Game Balance Economy

    hashgraph-online/awesome-codex-plugins

    Balance game difficulty, resources, rewards, probability, progression, economies, and dominant strategies.

    1.2k GitHub stars~618 tokensUpdated today
    Auto-check passed
  • Manuscript Engagement Analytics

    hashgraph-online/awesome-codex-plugins

    Analyze nonfiction manuscripts for reader engagement signals, including heading-level word counts, slow starts, long slogs, weak takeaway titles, value pacing, beta-reader comment dropoff, and…

    1.2k GitHub stars~875 tokensUpdated today
    Auto-check passed

Categories

Questions about Managing Cloud Usage

What does Managing Cloud Usage do?

A skill your agent uses when the user asks about quota, billing visibility, or processed-page counts. Managing Cloud Usage is an agent skill from hashgraph-online/awesome-codex-plugins. Use when the user asks about quota, billing visibility, or processed-page counts.

When should I use Managing Cloud Usage?

Managing Cloud Usage fits situations like: the user asks about quota; billing visibility; processed-page counts.

How do I install Managing Cloud Usage in Claude Code?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill managing-cloud-usage -a claude-code`. Or copy the skill folder (plugins/kreuzberg-dev/plugins/plugins/kreuzberg-cloud/skills/managing-cloud-usage in hashgraph-online/awesome-codex-plugins) into .claude/skills/managing-cloud-usage in your project. Claude Code loads it when a task matches its description.

How do I install Managing Cloud Usage in Codex?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill managing-cloud-usage -a codex`. Or copy the skill folder (plugins/kreuzberg-dev/plugins/plugins/kreuzberg-cloud/skills/managing-cloud-usage in hashgraph-online/awesome-codex-plugins) into .agents/skills/managing-cloud-usage in your project. Codex loads it when a task matches its description.

Can I use Managing Cloud Usage in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hashgraph-online/awesome-codex-plugins --skill managing-cloud-usage -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/managing-cloud-usage, .gemini/skills/managing-cloud-usage, .github/skills/managing-cloud-usage and .opencode/skills/managing-cloud-usage in your project.

What does Managing Cloud Usage need to run?

Going by SKILL.md and its folder, Managing Cloud Usage needs the command-line tools its instructions call (curl and jq) and credentials named KREUZBERG_API_KEY. Our summary lists: A credential in KREUZBERG_API_KEY.

Does Managing Cloud Usage access the network?

SKILL.md names 1 domain. In commands or code: api.kreuzberg.dev; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Managing Cloud Usage safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Managing Cloud Usage use?

Managing Cloud Usage is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Managing Cloud Usage use?

About 720 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Managing Cloud Usage?

Skills that share tags, products or a category with Managing Cloud Usage: Configuring Horizon (coollabsio/coolify, 63k stars), Nestjs Best Practices (rolling-scopes/rsschool-app, 10k stars), Sub2API Admin (Wei-Shaw/sub2api, 43k stars) and Firecrawl Build Onboarding (firecrawl/firecrawl, 190k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Managing Cloud Usage?

hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,242 GitHub stars. The repository holds 686 skills in this directory. The repository was last updated on October 8, 2026.

Source: hashgraph-online/awesome-codex-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.