Agent skill

Versioning Documents

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

A skill your agent uses when the user wants to retrieve a stored document and its extraction result, list a document's versions, or diff two versions.

Apache-2.0Auto-check passed

Install Versioning Documents

skills CLI
$ npx skills add hashgraph-online/awesome-codex-plugins --skill versioning-documents -a claude-code

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

GitHub CLI
$ gh skill install hashgraph-online/awesome-codex-plugins versioning-documents --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/versioning-documents .claude/skills/versioning-documents && 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
versioning-documents
GitHub stars
1.2k
Token cost
~945 tokens
SKILL.md length
355 words
Files
1
Skills in repo
736
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when the user wants to retrieve a stored document and its extraction result, list a document's versions, or diff two versions.

  • The user wants to retrieve a stored document and its extraction result
  • SKILL.md covers Endpoints, Get the latest version, List versions and Diff two versions, plus 2 more sections
  • Calls curl; reaches api.kreuzberg.dev; needs KREUZBERG_API_KEY
  • List a documents versions

What it does

Versioning Documents is an agent skill from hashgraph-online/awesome-codex-plugins. Use when the user wants to retrieve a stored document and its extraction result, list a document's versions, or diff two versions. Covers GET /v1/documents/{id}, GET /v1/documents/{id}/versions, and the sync-with-async-fallback diff at GET /v1/documents/{id}/diff plus its poll endpoint.

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

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 wants to retrieve a stored document and its extraction result
  • List a documents versions
  • Diff two versions

Example prompts

  • “/versioning-documents”

Requirements

  • A credential in KREUZBERG_API_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit 16b4156. 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

    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

Versioning Documents loads about 945 tokens when it runs. Until then it costs about 77 tokens; SKILL.md has 355 words of instructions outside code blocks.

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

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 16b4156, republished under its Apache-2.0 licence (© hashgraph-online). 355 words, ~945 tokens.

Download SKILL.mdSave it as .claude/skills/versioning-documents/SKILL.md (or your agent's skills folder).
name
versioning-documents
description
Use when the user wants to retrieve a stored document and its extraction result, list a document's versions, or diff two versions. Covers GET /v1/documents/{id}, GET /v1/documents/{id}/versions, and the sync-with-async-fallback diff at GET /v1/documents/{id}/diff plus its poll endpoint.

Versioning documents

Every extraction is stored against a stable document_id that persists across re-processing. Use these endpoints when an application extracts the same logical document more than once and needs the latest result, the full version history, or a diff between two versions.

All four endpoints are GET and require a Bearer token.

Endpoints

MethodPathPurpose
GET/v1/documents/{document_id}Latest version of a document with its extraction result.
GET/v1/documents/{document_id}/versionsList all versions (paginated), newest first.
GET/v1/documents/{document_id}/diff?from={v}&to={v}Diff two versions — sync (200), async fallback (202) when over budget.
GET/v1/documents/{document_id}/diff/{diff_job_id}Poll an async diff job.

document_id is the UUID returned alongside each extraction job. The from and to query params accept either a version sequence integer or a job UUID.

Get the latest version

bash
curl -s https://api.kreuzberg.dev/v1/documents/$DOC_ID \
  -H "Authorization: Bearer $KREUZBERG_API_KEY"

Returns the latest version's extraction result (same result shape as GET /v1/jobs/{id} — content, tables, images, metadata).

List versions

bash
curl -s https://api.kreuzberg.dev/v1/documents/$DOC_ID/versions \
  -H "Authorization: Bearer $KREUZBERG_API_KEY"

Returns an array of DocumentVersionEntry (paginated). Each entry carries its version sequence number and the job ID that produced it — use either as a from/to value when diffing.

Diff two versions

bash
curl -s "https://api.kreuzberg.dev/v1/documents/$DOC_ID/diff?from=1&to=3" \
  -H "Authorization: Bearer $KREUZBERG_API_KEY"

The diff is computed synchronously and returned inline as 200 when it fits the request budget:

json
{
  "document_id": "…",
  "from_job_id": "…", "from_version": 1,
  "to_job_id": "…",   "to_version": 3,
  "diff": { "…": "kreuzberg ExtractionDiff shape" },
  "computed_at": "2026-06-20T10:00:00Z"
}

The diff field is the full kreuzberg::diff::ExtractionDiff. The OpenAPI schema declares it opaque because the Rust type recurses; decode it against kreuzberg's published diff schema if you need a typed surface — do not hard-code a shape from this skill.

Show full SKILL.md (126 more words)Show less
Async fallback

When the diff exceeds the inline compute budget, the endpoint returns 202 with a job handle instead:

json
{ "diff_job_id": "…", "status": "pending" }

Poll it the same way you poll extraction jobs — exponential backoff capped at ~30s — until terminal:

bash
curl -s https://api.kreuzberg.dev/v1/documents/$DOC_ID/diff/$DIFF_JOB_ID \
  -H "Authorization: Bearer $KREUZBERG_API_KEY"

Treat both 200 (inline) and 202 (queued) as success at submit time; branch on the status code to decide whether to poll.

Errors

StatusMeaningAction
400Invalid from/toPass a version sequence integer or a job UUID.
401Bad API keyCheck the Authorization header.
404Version not foundDocument or version doesn't exist in this project.
422Async diff failedThe queued diff errored server-side; resubmit or report.

Other skills

  • tracking-cloud-jobs — polling cadence and terminal-status detection (reuse it for async diff jobs).
  • offloading-extraction — produces the document_id these endpoints read.

© 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/versioning-documents of hashgraph-online/awesome-codex-plugins.

Open the folder on GitHubat commit 16b4156

Compare with similar skills

Versioning Documents 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.

Versioning Documents compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Versioning Documents this skillhashgraph-online/awesome-codex-plugins1.2k—~945Automated safety check: PassApache-2.0
Agent App Storeruvnet/ruflo74k3 repos~1kAutomated safety check: PassMIT
Iterative Retrievalaffaan-m/ECC274k7 repos~1.6kAutomated safety check: PassMIT
App Store Optimizationalirezarezvani/claude-skills28k1 repos~4.2kAutomated safety check: PassMIT
Semantic Versioningsickn33/agentic-awesome-skills47k1 repos~2.6kAutomated safety check: PassMIT
Eas App Storessickn33/agentic-awesome-skills47k1 repos~1.9kAutomated safety check: PassMIT

Similar skills

  • Agent App Store

    ruvnet/ruflo

    Agent skill for app-store - invoke with $agent-app-store. An agent skill from ruvnet/ruflo.

    74k GitHub starsUsed in 3 repos~1k tokens
    MobileAuto-check passed
  • Pattern for progressively refining context retrieval to solve the subagent context problem.

    274k GitHub starsUsed in 7 repos~1.6k tokens
    Agent WorkflowsAuto-check passed
  • App Store Optimization

    alirezarezvani/claude-skills

    App Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store.

    28k GitHub starsUsed in 1 repo~4.2k tokens
    Marketing & SEOAuto-check passed
  • Semantic Versioning

    sickn33/agentic-awesome-skills

    Automate versioning and changelog generation using semantic versioning principles.

    47k GitHub starsUsed in 1 repo~2.6k tokens
    DevelopmentAuto-check passed
  • Eas App Stores

    sickn33/agentic-awesome-skills

    Curated upstream guidance for Eas App Stores; use when the workflow matches the user goal.

    47k GitHub starsUsed in 1 repo~1.9k tokens
    MobileAuto-check passed
  • App Store Changelog

    sickn33/agentic-awesome-skills

    Generate user-facing App Store release notes from git history since the last tag.

    47k GitHub starsUsed in 2 repos~831 tokens
    DevelopmentAuto-check passed

More from hashgraph-online/awesome-codex-plugins

All 736 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 yesterday
    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 yesterday
    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 yesterday
    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 yesterday
    Auto-check passed
  • Calle

    hashgraph-online/awesome-codex-plugins

    Use CALL-E from Codex through the calle CLI. An agent skill from hashgraph-online/awesome-codex-plugins.

    1.2k GitHub stars~2.9k tokensUpdated yesterday
    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 yesterday
    Auto-check passed

Questions about Versioning Documents

What does Versioning Documents do?

A skill your agent uses when the user wants to retrieve a stored document and its extraction result, list a document's versions, or diff two versions. Versioning Documents is an agent skill from hashgraph-online/awesome-codex-plugins. Use when the user wants to retrieve a stored document and its extraction result, list a document's versions, or diff two versions.

When should I use Versioning Documents?

Versioning Documents fits situations like: the user wants to retrieve a stored document and its extraction result; list a documents versions; diff two versions.

How do I install Versioning Documents in Claude Code?

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

How do I install Versioning Documents in Codex?

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

Can I use Versioning Documents 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 versioning-documents -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/versioning-documents, .gemini/skills/versioning-documents, .github/skills/versioning-documents and .opencode/skills/versioning-documents in your project.

What does Versioning Documents need to run?

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

Does Versioning Documents 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 Versioning Documents 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 Versioning Documents use?

Versioning Documents 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 Versioning Documents use?

About 945 tokens (SKILL.md is roughly 3.8k 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 Versioning Documents?

Skills that share tags, products or a category with Versioning Documents: Agent App Store (ruvnet/ruflo, 74k stars), Iterative Retrieval (affaan-m/ECC, 274k stars), App Store Optimization (alirezarezvani/claude-skills, 28k stars) and Semantic Versioning (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Versioning Documents?

hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,232 GitHub stars. The repository holds 736 skills in this directory. The repository was last updated on October 6, 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.