Agent skill

Pinata

by z80dev in z80dev/lemon

Pin files and JSON to IPFS via Pinata (JWT auth + helper scripts).

MITAuto-check passedBackend & APIs

Install Pinata

skills CLI
$ npx skills add z80dev/lemon --skill pinata -a claude-code

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

GitHub CLI
$ gh skill install z80dev/lemon pinata --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/z80dev/lemon.git skills-src && mkdir -p .claude/skills && cp -r skills-src/apps/lemon_skills/priv/builtin_skills/pinata .claude/skills/pinata && 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
pinata
GitHub stars
131
Token cost
~418 tokens
SKILL.md length
133 words
Files
7 (incl. scripts)
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

Pin files and JSON to IPFS via Pinata (JWT auth + helper scripts).

  • Tasks that involve Authentication
  • SKILL.md covers Setup, Quickstart and Notes
  • Runs Shell scripts from its folder; reaches api.pinata.cloud and uploads.pinata.cloud; needs PINATA_API_KEY and PINATA_API_SECRET

What it does

Pinata is an agent skill from z80dev/lemon. Pin files and JSON to IPFS via Pinata (JWT auth + helper scripts).

Its SKILL.md is about 420 tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts (for example `scripts/_common.sh`, `scripts/auth-test.sh` and `scripts/pin-by-hash.sh`).

It sits in Backend & APIs, covering Authentication. The repository describes itself as: BEAM-native platform for LLM agents: OTP-supervised per-run processes, pluggable engines and channels, contract-tested extension points, and a deterministic multi-agent sim arena. The licence is MIT.

When your agent uses it

  • Tasks that involve Authentication

Example prompts

  • “/pinata”

Requirements

  • A Bash shell
  • A credential in PINATA_API_KEY
  • A credential in PINATA_API_SECRET

What it can do on your machine

Read from SKILL.md and the folder at commit 899e215. 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 6 files in scripts/ (Shell), which the agent can run.

    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.pinata.cloud
    • uploads.pinata.cloud

    Also links to:

    • docs.pinata.cloud

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

  • Credentials

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

    • PINATA_API_KEY
    • PINATA_API_SECRET

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

Context cost

Pinata loads about 418 tokens when it runs. Until then it costs about 18 tokens; SKILL.md has 133 words of instructions outside code blocks.

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

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 z80dev/lemon at commit 899e215, republished under its MIT licence (© z80dev). 133 words, ~418 tokens.

Download SKILL.mdSave it as .claude/skills/pinata/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
pinata
description
Pin files and JSON to IPFS via Pinata (JWT auth + helper scripts).
homepage
https://docs.pinata.cloud/

Pinata

Use Pinata to pin content to IPFS.

This skill ships with small scripts (in scripts/) that wrap the Pinata API with reasonable defaults. Prefer PINATA_JWT auth.

Setup

Auth (recommended):

  • Set PINATA_JWT to a Pinata JWT (Bearer token).

Optional (legacy-only, not supported by all endpoints):

  • Set PINATA_API_KEY and PINATA_API_SECRET (some older endpoints accept these).

Optional endpoint overrides:

  • PINATA_API_URL (default: https://api.pinata.cloud)
  • PINATA_UPLOAD_URL (default: https://uploads.pinata.cloud)

Quickstart

Run these from the Pinata skill directory (seeded to ~/.lemon/agent/skill/pinata by default):

Test auth:

bash
./scripts/auth-test.sh

Upload a file (Pinata v3 uploads API):

bash
./scripts/upload-file.sh ./path/to/file.png --network private --name file.png

Pin a JSON document (wraps your JSON as pinataContent):

bash
./scripts/pin-json.sh ./metadata.json --name "metadata.json"

Pin an existing CID (by hash):

bash
./scripts/pin-by-hash.sh bafy... --name "my-cid"

Unpin:

bash
./scripts/unpin.sh bafy...

Notes

  • These scripts print raw JSON responses (so you can pipe into jq if you want).
  • For very large uploads, resumable uploads, or folder uploads, consider Pinata’s official tooling and docs: https://docs.pinata.cloud/

© z80dev, 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 6 other files (scripts) in apps/lemon_skills/priv/builtin_skills/pinata of z80dev/lemon.

  • SKILL.md
  • scripts/_common.sh
  • scripts/auth-test.sh
  • scripts/pin-by-hash.sh
  • scripts/pin-json.sh
  • scripts/unpin.sh
  • scripts/upload-file.sh

Open the folder on GitHubat commit 899e215

Compare with similar skills

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

Pinata compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pinata this skillz80dev/lemon131—~418Automated safety check: PassMIT
Fortify Developmentcoollabsio/coolify63k4 repos~1.9kAutomated safety check: PassMIT
Supabase Development and Debuggingsupabase/agent-skills2.7k3 repos~3.6kAutomated safety check: PassMIT
Better Auth Best Practiceslatitude-dev/latitude-llm4.7k7 repos~1.6kAutomated safety check: PassMIT
Supabasecurvenote/curvenote1695 repos~2.2kAutomated safety check: PassCustom licence
Gitnexus Exploringaws-samples/sample-kolya-br-proxy10611 repos~749Automated safety check: PassMIT-0

Similar skills

  • 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
  • Official

    General Supabase skill for database, auth, Edge Functions, Realtime and storage work, plus client libraries, migrations, security audits, debugging and reading logs.

    2.7k GitHub starsUsed in 3 repos~3.6k tokens
    Backend & APIsAuto-check passed
  • Better Auth Best Practices

    latitude-dev/latitude-llm

    Configure Better Auth server and client, set up database adapters, manage sessions, add plugins, and handle environment variables.

    4.7k GitHub starsUsed in 7 repos~1.6k tokens
    Backend & APIsAuto-check passed
  • Supabase

    curvenote/curvenote

    A skill your agent uses when doing ANY task involving Supabase.

    169 GitHub starsUsed in 5 repos~2.2k tokens
    Backend & APIsAuto-check passed
  • Gitnexus Exploring

    aws-samples/sample-kolya-br-proxy

    Official

    A skill your agent uses when the user asks how code works, wants to understand architecture, trace execution flows, or explore unfamiliar parts of the codebase.

    106 GitHub starsUsed in 11 repos~749 tokens
    Backend & APIsAuto-check passed
  • Gemini Live API Dev

    google-gemini/gemini-skills

    Official

    A skill your agent uses when building real-time, bidirectional streaming applications with the Gemini Live API, or migrating legacy Live models (2.0/2.5/3.1) to Gemini 3.8 Live.

    4.3k GitHub stars~4.6k tokensUpdated yesterday
    Backend & APIsAuto-check passed

More from z80dev/lemon

  • Debug and stress-test lemon gateway behavior by acting as both sides of Telegram conversations: run lemon-gateway with debug logs, then use Telethon with user credentials to send/reply messages in a…

    131 GitHub stars~744 tokensUpdated 21 days ago
    Auto-check: notes
  • Verify Lemon

    z80dev/lemon

    Verify lemon features against a running (or disposable) instance using the cheapest sufficient tier: DIRECT (attach/RPC + control-plane WS + bus observation, no Telegram), FAKE TELEGRAM (hermetic…

    131 GitHub stars~4k tokensUpdated 21 days ago
    Auto-check: notes
  • Discord Client

    z80dev/lemon

    Interact with Discord via a bot: read channels, send messages, list guilds/channels, upload files, manage threads.

    131 GitHub stars~771 tokensUpdated 21 days ago
    Auto-check: notes
  • Runtime Remsh

    z80dev/lemon

    Connect to a running Lemon or lemon-gateway BEAM node, run recompile() for hot code reload, and execute Elixir code in that live runtime via IEx remsh or rpc-eval.

    131 GitHub stars~819 tokensUpdated 21 days ago
    Auto-check passed
  • Session Logs

    z80dev/lemon

    Search and analyze your own Lemon session logs (older/parent conversations) using jq.

    131 GitHub stars~949 tokensUpdated 21 days ago
    Auto-check passed

Categories

Questions about Pinata

What does Pinata do?

Pin files and JSON to IPFS via Pinata (JWT auth + helper scripts). Pinata is an agent skill from z80dev/lemon. Pin files and JSON to IPFS via Pinata (JWT auth + helper scripts).

When should I use Pinata?

Pinata fits situations like: tasks that involve Authentication.

How do I install Pinata in Claude Code?

Run `npx skills add z80dev/lemon --skill pinata -a claude-code`. Or copy the skill folder (apps/lemon_skills/priv/builtin_skills/pinata in z80dev/lemon) into .claude/skills/pinata in your project. Claude Code loads it when a task matches its description.

How do I install Pinata in Codex?

Run `npx skills add z80dev/lemon --skill pinata -a codex`. Or copy the skill folder (apps/lemon_skills/priv/builtin_skills/pinata in z80dev/lemon) into .agents/skills/pinata in your project. Codex loads it when a task matches its description.

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

What does Pinata need to run?

Going by SKILL.md and its folder, Pinata needs a shell for the scripts in its folder and credentials named PINATA_API_KEY and PINATA_API_SECRET. Our summary lists: A Bash shell; A credential in PINATA_API_KEY; A credential in PINATA_API_SECRET.

Does Pinata access the network?

SKILL.md names 3 domains. In commands or code: api.pinata.cloud and uploads.pinata.cloud; the agent is likely to contact these when it follows the instructions. As links in the text: docs.pinata.cloud. This is read from the text; nothing was executed.

Is Pinata 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 Pinata use?

Pinata is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Pinata use?

About 418 tokens (SKILL.md is roughly 1.7k 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 Pinata?

Skills that share tags, products or a category with Pinata: Fortify Development (coollabsio/coolify, 63k stars), Supabase Development and Debugging (supabase/agent-skills, 2.7k stars), Better Auth Best Practices (latitude-dev/latitude-llm, 4.7k stars) and Supabase (curvenote/curvenote, 169 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pinata?

z80dev (a GitHub user) maintains it in z80dev/lemon, which has 131 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on September 16, 2026.

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