Agent skill

Postage

by aiskillstore in aiskillstore/marketplace

Send PDFs as physical US mail with AgentPostage and check prices, letter status, balance, tracking or return receipts.

MITAuto-check passedDocuments & Office

Install Postage

skills CLI
$ npx skills add aiskillstore/marketplace --skill postage -a claude-code

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

GitHub CLI
$ gh skill install aiskillstore/marketplace postage --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/aiskillstore/marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/ctxrs/postage .claude/skills/postage && 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
postage
GitHub stars
430
Token cost
~2.2k tokens
SKILL.md length
1,054 words
Files
4 (incl. scripts)
Skills in repo
1,108
Repo updated
First seen
Licence
MIT

At a glance

Send PDFs as physical US mail with AgentPostage and check prices, letter status, balance, tracking or return receipts.

  • Mailing bank disputes
  • SKILL.md covers Connect, Mailing inputs and optional…, Send once and Report and recover
  • Runs JavaScript scripts from its folder; calls node; reaches agentpostage.com; needs AGENTPOSTAGE_API_KEY and UNIQUE_LETTER_KEY
  • Gym cancellations

What it does

Postage is an agent skill from aiskillstore/marketplace. Send PDFs as physical US mail with AgentPostage and check prices, letter status, balance, tracking or return receipts. Use for mailing bank disputes, gym cancellations, credit bureau requests, notices and completed forms.

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts (for example `skill-report.json`).

It sits in Documents & Office. The repository describes itself as: Security-audited skills for Claude, Codex & Claude Code. One-click install, quality verified. The licence is MIT.

When your agent uses it

  • Mailing bank disputes
  • Gym cancellations
  • Credit bureau requests
  • Notices and completed forms

Example prompts

  • “/postage”

Requirements

  • Node.js
  • A credential in AGENTPOSTAGE_API_KEY
  • A credential in UNIQUE_LETTER_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit ad8daf7. 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 1 file in scripts/ (JavaScript), which the agent can run.

    Shell commands in SKILL.md call:

    • node

    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:

    • agentpostage.com

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

  • Credentials

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

    • AGENTPOSTAGE_API_KEY
    • UNIQUE_LETTER_KEY

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

Context cost

Postage loads about 2.2k tokens when it runs. Until then it costs about 57 tokens; SKILL.md has 1,054 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from aiskillstore/marketplace at commit ad8daf7, republished under its MIT licence (© aiskillstore). 1,054 words, ~2,153 tokens.

Download SKILL.mdSave it as .claude/skills/postage/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
postage
description
Send PDFs as physical US mail with AgentPostage and check prices, letter status, balance, tracking or return receipts. Use for mailing bank disputes, gym cancellations, credit bureau requests, notices and completed forms.

Postage

The postage skill sends physical mail through AgentPostage.

Mail an existing PDF using a US return address and US recipient address. Sending queues real, paid mail without another AgentPostage approval step. Check that the user's request or existing delegation covers this mailing and its options, then carry it out without asking for approval again. Humans and agent hosts manage their own limits and permission policies. Ask only when authority or required inputs are missing or unclear. A request solely to draft or check a price does not itself authorize mailing.

Use the user's actual document and addresses. Do not impersonate someone, invent a signature, supporting fact or legal deadline, or add sensitive documents beyond the authorized mailing.

Connect

Prefer AgentPostage MCP tools when connected. Otherwise use the bundled scripts/agentpostage.mjs with Node.js 22+ or the HTTP API. Resolve script paths relative to this skill's directory, not the current working directory. The CLI has no package dependencies.

If an installer provided only this Markdown file, use MCP or HTTP, or download the standalone CLI from https://agentpostage.com/agentpostage.mjs into your working directory and review it before running it. Substitute that file's actual path for the bundled script paths below.

The CLI sends authenticated requests to https://agentpostage.com. Leave AGENTPOSTAGE_BASE_URL unset during normal use. Do not redirect the key or documents to another origin without the owner's explicit authorization.

The human owner creates a verified account, accepts the policies and creates a key at https://agentpostage.com/connect/. Funding happens at https://agentpostage.com/billing/. The agent needs AGENTPOSTAGE_API_KEY in its tool environment, supplied through the runtime's secret store. Never ask for the key in chat, print it, or obtain owner cookies or card details. If absent, ask the human to configure it.

Keys can spend the account balance, with no per-key allowance. They cannot manage keys or directly charge a card. Sending can trigger automatic recharge if the owner enabled it. When funding is needed, return the billing link and wait for the confirmed balance.

For current prices, endpoint fields, print options and limits, read https://agentpostage.com/llms.txt or https://agentpostage.com/docs/. MCP is at https://agentpostage.com/mcp, using Streamable HTTP and Bearer API-key authentication, not OAuth.

Mailing inputs and optional pricing

Obtain the actual PDF and both addresses from authorized context. Ask for missing inputs before sending. Addresses use name, address_line1, optional address_line2, city, two-letter state, postal_code and country: "US". Fields must be single-line printable ASCII. The PDF itself supports Unicode.

Use first_class unless another service is requested. certified adds tracking. certified_return_receipt adds tracking and an electronic return receipt. first_class_flat selects unfolded mailing. first_class_hse adds a Homeowner Statement Enclosed endorsement. None guarantees legal adequacy or delivery dates.

Defaults are black-and-white, single-sided white paper and no reply envelope. Use only authorized options. Reply envelopes are unstamped. Specialty stocks need suitable PDF layout. Check stock prints supplied artwork without issuing a payment.

When a price check is requested or useful under the user's spending controls, read the actual PDF page count and call price_letter with page_count and the options intended for the send. It does not send, store the PDF or reserve money, and does not introduce an approval step. With the CLI, substitute the absolute skill directory below:

sh
node "<skill-directory>/scripts/agentpostage.mjs" balance
node "<skill-directory>/scripts/agentpostage.mjs" price --pages 3 --service first_class

A price lookup does not reserve a future rate. Sending freezes the current price when queued. The API does not enforce a per-key allowance or a request-specific maximum price. Follow the user's and host's actual controls without inventing API guarantees.

Source PDFs must be at most 10 MiB. First-Class/HSE permit 500 document pages, either Certified service 150, and explicit flats 75 single-sided or 150 duplex. The included coversheet does not count as a customer page. Encrypted, corrupt and empty PDFs are rejected. For unsupported_print_annotation, export or print to a new PDF and confirm rejection before submitting corrected bytes. Do not silently omit content.

Show full SKILL.md (429 more words)Show less

Send once

Choose and preserve a unique idempotency key before submitting. Keys are 8–128 ASCII letters, digits, dots, colons, underscores or hyphens. Keep it with the intended mailing inputs.

MCP send_letter takes idempotency_key, pdf_base64 of actual PDF bytes, sender, recipient and optional service, color, duplex, paper, return_envelope. Never invent base64 or put an external PDF URL in its place. For a local PDF, the CLI reads and encodes the file directly.

Save the user's addresses as sender.json and recipient.json, then send within the existing delegation:

sh
node "<skill-directory>/scripts/agentpostage.mjs" send \
  --pdf letter.pdf \
  --sender sender.json \
  --recipient recipient.json \
  --service first_class \
  --idempotency-key UNIQUE_LETTER_KEY

Replace the example key with the preserved key. If you checked a price, use those same print options. Optional flags include --color color, --duplex true, --paper and --return-envelope. Run --help for choices.

Without Node.js, POST https://agentpostage.com/v1/letters accepts multipart pdf, sender and recipient, or JSON pdf_base64 and address objects. Supply Bearer authentication and Idempotency-Key. Multipart duplex is a string, JSON duplex a boolean.

Report and recover

Save the returned letter ID. Report the actual status and cost.total_cents. 202 and queued mean saved for sending, not mailed. A legacy null cost does not mean free.

  • After a timeout or 5xx, read a known letter ID or list letters first. If retrying, reuse the SAME key, PDF bytes, addresses, service and print options. A fresh key can duplicate mail. A 409 may indicate changed input or a conflicting state. Inspect it rather than generating a new key.
  • For submission_unknown, inspect the existing letter and do not submit a replacement.
  • For awaiting_funds, return the owner's billing link. A browser payment return is not proof of funding.
  • accepted is not proof of mailing or delivery. First-Class ends at confirmed mailed. Certified can reach delivered. Describe only available evidence.
  • cancel_letter with {id} can cancel before authorization starts. Only a successful response confirms cancellation. Do not claim that a cancellation attempt stopped mail.
  • Retrieve an available receipt_url with Bearer authentication if you have an authenticated HTTP download tool. Otherwise give the owner its path under https://agentpostage.com to open in a signed-in browser. ChatGPT's configured Actions report receipt availability but do not download PDFs. A receipt can arrive after delivery. Never infer it from the chosen service alone.

MCP follow-up tools are get_letter with {id}, list_letters and list_transactions with optional limit/cursor, and get_balance and get_billing_link with {}. The CLI equivalents are get ID, list, transactions, balance, billing and cancel ID. List limits are 1–50 and next_cursor: null ends pagination.

Keep needed PDFs and receipts before retention ends, 30 days after confirmed First-Class mailing, Certified delivery, cancellation or rejection. Pending mail is retained until resolved. Protect saved documents and addresses as private user data.

© aiskillstore, MIT. 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 3 other files (scripts) in skills/ctxrs/postage of aiskillstore/marketplace.

  • SKILL.md
  • LICENSE
  • scripts/agentpostage.mjs
  • skill-report.json

Open the folder on GitHubat commit ad8daf7

Compare with similar skills

Postage 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.

Postage compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Postage this skillaiskillstore/marketplace430—~2.2kAutomated safety check: PassMIT
Markdown Article FormatterJimLiu/baoyu-skills26k7 repos~3.5kAutomated safety check: PassMIT
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
Obsidian MarkdownAtmosphere/atmosphere3.8k20 repos~1.3kAutomated safety check: PassApache-2.0
DOCXrvdbreemen/OTGW-firmware20733 repos~4.3kAutomated safety check: PassProprietary
Gzh Designisjiamu/gzh-design-skill3.9k1 repos~2.2kAutomated safety check: PassAGPL-3.0

Similar skills

  • Markdown Article Formatter

    JimLiu/baoyu-skills

    Reformats plain text or Markdown articles with frontmatter, a title, a summary, headings, bold, lists and code blocks, and saves a separate formatted copy.

    26k GitHub starsUsed in 7 repos~3.5k tokens
    Documents & OfficeAuto-check passed
  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • Obsidian Markdown

    Atmosphere/atmosphere

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    3.8k GitHub starsUsed in 20 repos~1.3k tokens
    Documents & OfficeAuto-check passed
  • DOCX

    rvdbreemen/OTGW-firmware

    A skill your agent uses whenever the user wants to create, read, edit, or manipulate Word documents (.docx files).

    207 GitHub starsUsed in 33 repos~4.3k tokens
    Documents & OfficeAuto-check passed
  • Gzh Design

    isjiamu/gzh-design-skill

    微信公众号文章排版引擎,将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取,自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入(非 Markdown…

    3.9k GitHub starsUsed in 1 repo~2.2k tokens
    Documents & OfficeAuto-check passed
  • Reads, creates and edits Word .docx files with python-docx, and drops to raw OOXML for tracked changes, comments and byte-exact edits.

    41k GitHub stars~2.5k tokensUpdated today
    Documents & OfficeAuto-check passed

More from aiskillstore/marketplace

All 1,108 skills in this repo
  • Code Stats

    aiskillstore/marketplace

    Analyze codebase with tokei (fast line counts by language) and difft (semantic AST-aware diffs).

    430 GitHub starsUsed in 2 repos~697 tokens
    Auto-check: notes
  • File Search

    aiskillstore/marketplace

    Modern file and content search using fd, ripgrep (rg), and fzf.

    430 GitHub starsUsed in 2 repos~598 tokens
    Auto-check: notes
  • Data Processing

    aiskillstore/marketplace

    Process JSON with jq and YAML/TOML with yq. An agent skill from aiskillstore/marketplace.

    430 GitHub starsUsed in 1 repo~720 tokens
    Auto-check: notes
  • Doc Scanner

    aiskillstore/marketplace

    Scans for project documentation files (AGENTS.md, CLAUDE.md, GEMINI.md, COPILOT.md, CURSOR.md, WARP.md, and 15+ other formats) and synthesizes guidance.

    430 GitHub starsUsed in 1 repo~644 tokens
    Auto-check: notes
  • Find Replace

    aiskillstore/marketplace

    Modern find-and-replace using sd (simpler than sed) and batch replacement patterns.

    430 GitHub starsUsed in 1 repo~527 tokens
    Auto-check: notes
  • Investigating Codebases

    aiskillstore/marketplace

    Automatically activated when user asks how something works, wants to understand unfamiliar code, needs to explore a new codebase, or asks questions like "where is X implemented?", "how does Y…

    430 GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check: notes

Questions about Postage

What does Postage do?

Send PDFs as physical US mail with AgentPostage and check prices, letter status, balance, tracking or return receipts. Postage is an agent skill from aiskillstore/marketplace. Send PDFs as physical US mail with AgentPostage and check prices, letter status, balance, tracking or return receipts.

When should I use Postage?

Postage fits situations like: mailing bank disputes; gym cancellations; credit bureau requests; notices and completed forms.

How do I install Postage in Claude Code?

Run `npx skills add aiskillstore/marketplace --skill postage -a claude-code`. Or copy the skill folder (skills/ctxrs/postage in aiskillstore/marketplace) into .claude/skills/postage in your project. Claude Code loads it when a task matches its description.

How do I install Postage in Codex?

Run `npx skills add aiskillstore/marketplace --skill postage -a codex`. Or copy the skill folder (skills/ctxrs/postage in aiskillstore/marketplace) into .agents/skills/postage in your project. Codex loads it when a task matches its description.

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

What does Postage need to run?

Going by SKILL.md and its folder, Postage needs JavaScript for the scripts in its folder, the command-line tools its instructions call (node) and credentials named AGENTPOSTAGE_API_KEY and UNIQUE_LETTER_KEY. Our summary lists: Node.js; A credential in AGENTPOSTAGE_API_KEY; A credential in UNIQUE_LETTER_KEY.

Does Postage access the network?

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

Is Postage 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Postage use?

Postage is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Postage use?

About 2.2k tokens (SKILL.md is roughly 8.6k 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 Postage?

Skills that share tags, products or a category with Postage: Markdown Article Formatter (JimLiu/baoyu-skills, 26k stars), Markitdown (ImCa0/just-laws, 781 stars), Obsidian Markdown (Atmosphere/atmosphere, 3.8k stars) and DOCX (rvdbreemen/OTGW-firmware, 207 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Postage?

aiskillstore (a GitHub organization) maintains it in aiskillstore/marketplace, which has 430 GitHub stars. The repository holds 1,108 skills in this directory. The repository was last updated on October 7, 2026.

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