What this skill does

The tinypostcard skill teaches agents how to:

• Verify account prerequisites.
• Use API keys correctly.
• Find templates and render HTML.
• Send postcards safely through REST endpoints.
• Explain token usage and billing fallbacks.

Human prerequisites

Before an agent can execute postcard operations, the human must:

1. Sign up for tinypostcard.
2. Purchase tokens on Billing.
3. Generate an API key on Integrations.

Install

From the project root:

mkdir -p "$CODEX_HOME/skills"
cp -R .agents/skills/tinypostcard "$CODEX_HOME/skills/tinypostcard"

API call pattern used by the skill

curl -H "Authorization: Bearer $TINYPOSTCARD_API_KEY" \
  "https://tinypostcard.com/api/v1/templates?scope=shared&limit=10"

Recommended sequence for agents

1. GET /api/v1/me (auth sanity check)
2. GET /api/v1/balance (verify token availability)
3. GET /api/v1/templates (find source template)
4. GET /api/v1/templates/{id}/html (get printable HTML)
5. POST /api/v1/postcards/send (send batch)

HTML guidance

• Preferred dimensions are 6in x 4in.
• If uncertain, agents should fetch HTML from an existing template endpoint instead of generating from scratch.
• Keep each HTML field under the documented size limits.

References

• API Overview
• HTML Structure
• Postcards endpoint