New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Zr Express

by bighadj22 in bighadj22/codflow

ZR Express delivery platform integration for CodFlow — all 129 public API endpoints (catalog, claims, customers, orders/parcels, delivery pricing, hubs, supplier, treasury, users, webhooks)…

Apache-2.0Auto-check passedBackend & APIs

Install Zr Express

skills CLI
$ npx skills add bighadj22/codflow --skill zr-express -a claude-code

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

GitHub CLI
$ gh skill install bighadj22/codflow zr-express --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/bighadj22/codflow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/zr-express .claude/skills/zr-express && 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
zr-express
GitHub stars
354
Token cost
~1.6k tokens
SKILL.md length
648 words
Files
26 (incl. references)
Skills in repo
11
Repo updated
First seen
Licence
Apache-2.0

At a glance

ZR Express delivery platform integration for CodFlow — all 129 public API endpoints (catalog, claims, customers, orders/parcels, delivery pricing, hubs, supplier, treasury, users, webhooks)…

  • Works in 10 steps: No separate validation step — ZR… → Single create returns a parcel UUID; the… → Territories are UUIDs (city + district),… → …
  • Connecting ZR Express as a delivery company
  • SKILL.md covers Reference files (in this skill…, Codebase, Auth and Gotchas (verified against the…, plus 3 more sections
  • Runs Python scripts from its folder; calls wrangler; reaches api.zrexpress.app

What it does

Zr Express is an agent skill from bighadj22/codflow. ZR Express delivery platform integration for CodFlow — all 129 public API endpoints (catalog, claims, customers, orders/parcels, delivery pricing, hubs, supplier, treasury, users, webhooks), organized per domain. Use when connecting ZR Express as a delivery company, auditing or fixing the zrexpress adapter in cod-server, verifying behavior against the official API, pulling tracking/state, registering webhooks, or extending ZR Express support.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 27 other files, including reference files (for example `CONFORMANCE.md`, `README.md` and `endpoints-index.md`).

It sits in Backend & APIs, covering Webhooks and REST APIs. It works with Model Context Protocol. The repository describes itself as: The open-source, COD-first e-commerce + delivery platform for Algeria built agentic-ready. The licence is Apache-2.0.

When your agent uses it

  • Connecting ZR Express as a delivery company
  • Fixing the zrexpress adapter in cod-server
  • Verifying behavior against the official API
  • Pulling tracking/state

Example prompts

  • “/zr-express”

Requirements

  • Python 3

Workflow steps

10 steps, taken from the first numbered list in SKILL.md.

  1. No separate validation step — ZR auto-activates parcels on creation;
  2. Single create returns a parcel UUID; the tracking number only comes back from
  3. Territories are UUIDs (city + district), not wilaya_id/commune strings —
  4. Auth is X-Api-Key + X-Tenant — do not switch to Authorization: Bearer
  5. State names are free text (data.state.name), not a fixed enum: only
  6. Label URLs expire (~1 hour, SAS-token based) — from create you get a
  7. Update semantics — PATCH /parcels/{id}/amount, /customer and
  8. Delete is unreliable (HTTP 405 in tests) — canDeleteBeforeValidation/
  9. Webhook registration is API-driven — POST /webhooks/endpoints with
  10. All IDs (parcel, customer, address, claim, etc.) are UUIDs — any other

What it can do on your machine

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

    Ships script files (Python, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • wrangler

    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.zrexpress.app

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Zr Express loads about 1.6k tokens when it runs, and up to ~33k if it reads all its reference files. Until then it costs about 115 tokens; SKILL.md has 648 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~115
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~33k

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 bighadj22/codflow at commit ed79aa9, republished under its Apache-2.0 licence (© bighadj22). 648 words, ~1,588 tokens.

Download SKILL.mdSave it as .claude/skills/zr-express/SKILL.md (or your agent's skills folder). This skill also uses 25 other files; get the full folder from GitHub.
name
zr-express
description
ZR Express delivery platform integration for CodFlow — all 129 public API endpoints (catalog, claims, customers, orders/parcels, delivery pricing, hubs, supplier, treasury, users, webhooks), organized per domain. Use when connecting ZR Express as a delivery company, auditing or fixing the zr_express adapter in cod-server, verifying behavior against the official API, pulling tracking/state, registering webhooks, or extending ZR Express support.

ZR Express Delivery Integration

ZR Express is an Algerian cash-on-delivery delivery platform (https://api.zrexpress.app, dashboard zrexpress.app). Its REST API covers the full supplier flow: parcels/orders (create, bulk, exchange, refund, labels, state updates), catalog (products, stock, receipts), customers (individual + company, addresses, imports), claims, delivery pricing (rates per territory), treasury (payments, payment requests, balance), users (profile, API keys), hubs, and webhooks (programmatic registration).

Start at references/ in this folder — do not guess from the raw swagger. Read CONFORMANCE.md before assuming the current adapter behavior is correct — it lists live-verified bugs (tracking 404, delete 405, address update 400, stop-desk hub 404, geo naming) that the code comments below may not reflect.

Reference files (in this skill folder)

FileWhat it holds
endpoints-index.mdMaster index — all 129 endpoints, per-domain, with auth notes
CONFORMANCE.mdVerified audit (2026-09-10, live-tested): what works / what's broken / fix order — read before assuming current behavior is correct
references/catalog.mdProducts, stock movements, receipts, categories, catalog reports (17)
references/claims.mdClaim categories, claims, comments, workflows (11)
references/customers.mdIndividual/company customers, addresses, imports/exports (15)
references/orders.mdParcels, pickup bags, modification requests, territories, labels, reports (50)
references/delivery-pricing.mdRates, service pricing, price lists (5)
references/hubs.mdHubs (2)
references/supplier.mdSupplier profile, blocking, price-list assignments (3)
references/treasury.mdSupplier payments, payment requests, treasury reports (15)
references/users.mdProfile, API-key management (4)
references/webhooks.mdWebhook endpoint CRUD (7)
schemas/*.jsonFull request/response schemas per domain (verbatim from swagger)

Path prefix is /api/v1/… (version defaults to 1). Read the domain reference + its schemas/{domain}.json before writing adapter code.

Codebase

  • cod-server/src/endpoints/delivery-companies/providers/zr_express/ — the adapter (adapter.ts, types.ts, capabilities.ts) implementing the DeliveryProvider interface used by dispatch.ts.
  • cod-server/src/endpoints/delivery-companies/providers/registry.ts — routes company code zr_express to the adapter; apiToken = ZR API key, apiUserGuid = ZR tenant Id.
  • cod-server/src/endpoints/delivery-companies/webhook-handlers.ts — programmatic webhook registration (registerZrWebhook) against /api/v1/webhooks/endpoints.
  • cod-server/src/endpoints/webhooks/zr-status-mapper.ts — maps ZR state names to CodFlow statuses.

Auth

  • Headers: X-Api-Key: {secretKey} + X-Tenant: {tenantId} (the adapter uses these consistently; the swagger also lists Bearer).
  • Every request also carries Accept/Content-Type application/json.
Show full SKILL.md (342 more words)Show less

Gotchas (verified against the live integration)

  1. No separate validation step — ZR auto-activates parcels on creation; validateShipment is a no-op.
  2. Single create returns a parcel UUID; the tracking number only comes back from GET /parcels/{id}. Bulk create (POST /parcels/bulk) returns the tracking number directly. maxBulkCreate = 100.
  3. Territories are UUIDs (city + district), not wilaya_id/commune strings — resolve them via POST /territories/search and cache the city per wilaya.
  4. Auth is X-Api-Key + X-Tenant — do not switch to Authorization: Bearer just because examples show it; the stored apiToken is an API key.
  5. State names are free text (data.state.name), not a fixed enum: only "Out for Delivery", "In Transit" and "At Hub" are documented defaults. Unknown names must surface as unmapped — never guessed into a status.
  6. Label URLs expire (~1 hour, SAS-token based) — from create you get a deferred label token (CodFlow uses DEFERRED_LABEL_MARKER); serve labels server-side, never expose a signed URL to the browser.
  7. Update semantics — PATCH /parcels/{id}/amount, /customer and /deliveryAddress apply while canUpdateAfterValidation: true.
  8. Delete is unreliable (HTTP 405 in tests) — canDeleteBeforeValidation/ AfterValidation are both false; prefer state updates/refund flows.
  9. Webhook registration is API-driven — POST /webhooks/endpoints with X-Api-Key + X-Tenant; the registered URL is CodFlow's /webhooks/zr_express.
  10. All IDs (parcel, customer, address, claim, etc.) are UUIDs — any other format is an error or a legacy/alias field.

Workflow A — Connect ZR Express

  1. Create the delivery company with code: "zr_express", apiToken = ZR API key, apiUserGuid = ZR tenant Id.
  2. Verify: token check → create a test parcel (POST /parcels, POST /customers/individual first) → GET /parcels/{id} returns the tracking number → POST /parcels/labels/individual → tracking pull (GET /parcels/{id}/state-history).
  3. Register the webhook (registerZrWebhook → POST /webhooks/endpoints) and configure webhook_status_mapping for any non-default state names.

Workflow B — Audit / fix the integration

  1. Read the relevant references/{domain}.md + schemas/{domain}.json.
  2. Diff adapter.ts / types.ts endpoint-by-endpoint against the reference.
  3. Keep every header name, path, query param, and body field exactly as the reference spells them (the generated files are verbatim from swagger).

Security

Never commit ZR API keys or tenant IDs. They live in wrangler secrets / .dev.vars only (repo convention).

© bighadj22, 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

SKILL.md and 25 other files (references) in .agents/skills/zr-express of bighadj22/codflow.

  • SKILL.md
  • CONFORMANCE.md
  • README.md
  • endpoints-index.md
  • generate.py
  • references/catalog.md
  • references/claims.md
  • references/customers.md
  • references/delivery-pricing.md
  • references/hubs.md
  • references/orders.md
  • references/supplier.md
  • references/treasury.md
  • references/users.md
  • references/webhooks.md
  • schemas/catalog.json
  • schemas/claims.json
  • schemas/customers.json
  • schemas/delivery-pricing.json
  • … and 7 more

Open the folder on GitHubat commit ed79aa9

Compare with similar skills

Zr Express 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.

Zr Express compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Zr Express this skillbighadj22/codflow354—~1.6kAutomated safety check: PassApache-2.0
X Twitter Scrapersickn33/agentic-awesome-skills47k1 repos~2.1kAutomated safety check: PassMIT
X Twitter Scrapergithub/awesome-copilot40k—~2.2kAutomated safety check: PassMIT
X Twitter Scraperdavila7/claude-code-templates33k—~1.8kAutomated safety check: PassMIT
X Twitter Scraperdavepoon/buildwithclaude3.6k—~2.2kAutomated safety check: PassMIT
Smbcrm Advanced ToolsLeoYeAI/openclaw-master-skills2.2k—~4.9kAutomated safety check: PassMIT

Similar skills

  • X Twitter Scraper

    sickn33/agentic-awesome-skills

    Use Xquik for X data workflows: tweet search, user lookup, follower export, media downloads, monitors, webhooks, REST API, MCP, SDK setup, and approval-gated account actions.

    47k GitHub starsUsed in 1 repo~2.1k tokens
    Backend & APIsAuto-check passed

  • X Twitter Scraper

    github/awesome-copilot

    Official

    Build GitHub Copilot workflows with Xquik X API SDKs, REST endpoints, hosted Apify Actor runs, MCP tools, TweetClaw OpenClaw plugin installs, signed webhooks, tweet search, user lookup, follower…

    40k GitHub stars~2.2k tokensUpdated yesterday
    Backend & APIsAuto-check passed

  • X Twitter Scraper

    davila7/claude-code-templates

    X API & Twitter scraper skill for AI coding agents. An agent skill from davila7/claude-code-templates.

    33k GitHub stars~1.8k tokensUpdated today
    Backend & APIsAuto-check passed

  • X Twitter Scraper

    davepoon/buildwithclaude

    X (Twitter) data extraction and monitoring via Xquik: tweet search, user lookup, follower extraction, giveaway draws, trending topics, account monitoring with webhooks, reply/retweet/quote…

    3.6k GitHub stars~2.2k tokensUpdated yesterday
    Backend & APIsAuto-check passed

  • Smbcrm Advanced Tools

    LeoYeAI/openclaw-master-skills

    A skill your agent uses when helping SMBcrm customers with Private Integration Tokens, REST API v2, workflows, custom webhooks, MCP, or Agent Studio API.

    2.2k GitHub stars~4.9k tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed

  • Make

    ericrisco/rsc-harness

    A skill your agent uses when operating Make.com (formerly Integromat) programmatically — driving its REST API v2 or the Make MCP server from code or an agent to create, read, update, activate, run…

    180 GitHub stars~3.1k tokensUpdated today
    Backend & APIsAuto-check: notes

More from bighadj22/codflow

All 11 skills in this repo

  • Yalidine Delivery Integration

    bighadj22/codflow

    Wires an app to the Yalidine (Guepex) Algerian courier API: parcels, zone lookups, delivery fees and verified delivery-status webhooks.

    354 GitHub stars~2.5k tokensUpdated 4 days ago
    Auto-check passed

  • Meta Pixel and Conversions API Reference

    bighadj22/codflow

    Bundles Meta's official Pixel and Conversions API documentation so tracking changes, event deduplication and conversion events are checked against the real spec.

    354 GitHub stars~1.8k tokensUpdated 4 days ago
    Auto-check passed

  • CodFlow Change Workflow

    bighadj22/codflow

    A step-by-step workflow for changing the CodFlow repository: read the AGENTS.md contract, respect package boundaries, verify before claiming done and keep PRs small.

    354 GitHub stars~1.1k tokensUpdated 4 days ago
    Auto-check passed

  • COD CRM Customer Management

    bighadj22/codflow

    Guides an agent through eight customer tools in a cash-on-delivery CRM for Algerian e-commerce: search, profiles, phone lookup, order history, groups, tags and deletion.

    354 GitHub stars~3.2k tokensUpdated 4 days ago
    Auto-check passed

  • EcoTrack Courier Integration

    bighadj22/codflow

    Guides connecting and maintaining the EcoTrack courier adapter in CodFlow, one API shared by 82 Algerian couriers, using the official API reference and a rollout plan.

    354 GitHub stars~2.3k tokensUpdated 4 days ago
    Auto-check passed

  • defineRoute Route Builder

    bighadj22/codflow

    Creates new API endpoints, and converts older ones, with the defineRoute() pattern used in cod-server, including auth strategies, scopes and OpenAPI output.

    354 GitHub stars~924 tokensUpdated 4 days ago
    Auto-check passed

Works with

Categories

Questions about Zr Express

What does Zr Express do?

ZR Express delivery platform integration for CodFlow — all 129 public API endpoints (catalog, claims, customers, orders/parcels, delivery pricing, hubs, supplier, treasury, users, webhooks)…. Zr Express is an agent skill from bighadj22/codflow. ZR Express delivery platform integration for CodFlow — all 129 public API endpoints (catalog, claims, customers, orders/parcels, delivery pricing, hubs, supplier, treasury, users, webhooks), organized per domain.

When should I use Zr Express?

Zr Express fits situations like: connecting ZR Express as a delivery company; fixing the zrexpress adapter in cod-server; verifying behavior against the official API; pulling tracking/state.

How do I install Zr Express in Claude Code?

Run `npx skills add bighadj22/codflow --skill zr-express -a claude-code`. Or copy the skill folder (.agents/skills/zr-express in bighadj22/codflow) into .claude/skills/zr-express in your project. Claude Code loads it when a task matches its description.

How do I install Zr Express in Codex?

Run `npx skills add bighadj22/codflow --skill zr-express -a codex`. Or copy the skill folder (.agents/skills/zr-express in bighadj22/codflow) into .agents/skills/zr-express in your project. Codex loads it when a task matches its description.

Can I use Zr Express 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 bighadj22/codflow --skill zr-express -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/zr-express, .gemini/skills/zr-express, .github/skills/zr-express and .opencode/skills/zr-express in your project.

What does Zr Express need to run?

Going by SKILL.md and its folder, Zr Express needs Python for the scripts in its folder and the command-line tools its instructions call (wrangler). Our summary lists: Python 3.

Does Zr Express access the network?

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

Is Zr Express 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 Zr Express use?

Zr Express 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 Zr Express use?

About 1.6k tokens (SKILL.md is roughly 6.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 32k tokens, read only when the agent opens those files.

What are the alternatives to Zr Express?

Skills that share tags, products or a category with Zr Express: X Twitter Scraper (sickn33/agentic-awesome-skills, 47k stars), X Twitter Scraper (github/awesome-copilot, 40k stars), X Twitter Scraper (davila7/claude-code-templates, 33k stars) and X Twitter Scraper (davepoon/buildwithclaude, 3.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Zr Express?

bighadj22 (a GitHub user) maintains it in bighadj22/codflow, which has 354 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 6, 2026.

Source: bighadj22/codflow on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.