Pier Cloud

What it does

When your agent uses it

• Needs to consume the Pier Cloud (Lighthouse) API for cloud cost management — including JWT authentication
• Listing contexts
• Workspace groups
• FinOps data views

Example prompts

• “/pier-cloud”

Requirements

• Python 3
• Node.js
• A credential in PIERCLOUD_CLIENT_SECRET

Workflow steps

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

1. 1Authenticate via POST /auth with client_id and client_secret to obtain a JWT token
2. 2Include the token in all requests: Authorization: Bearer {token}
3. 3Renew the token upon expiration (default validity: 1 hour)

What it can do on your machine

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

  Shell commands in SKILL.md call:

  • pip
  • python

  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.piercloud.io

  Also links to:

  • docs.piercloud.com
  • piercloud.com

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

• Credentials

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

  • PIERCLOUD_CLIENT_SECRET

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

Context cost

Pier Cloud loads about 1.1k tokens when it runs, and up to ~6.9k if it reads all its reference files. Until then it costs about 89 tokens; SKILL.md has 356 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~89

When it runs · the whole SKILL.md, loaded when a task matches

~1.1k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~6.9k

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

• NoteMentions a .env fileSKILL.md:20

  Locate the `.env` file in the skill directory with the following variables:

• NoteMentions a .env fileSKILL.md:28

  If the `.env` file does not exist, inform the user that credentials must be obtained from the Pier Cloud platform before

• NoteMentions a .env fileSKILL.md:102

  - [ ] `.env` file present with `PIERCLOUD_CLIENT_ID`, `PIERCLOUD_CLIENT_SECRET`, and `PIERCLOUD_TENANCY_ID`

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 fabricioctelles/skills at commit f1de632, republished under its Apache-2.0 licence (© fabricioctelles). 356 words, ~1,096 tokens.

name

pier-cloud

description

This skill should be used when the user needs to consume the Pier Cloud (Lighthouse) API for cloud cost management — including JWT authentication, listing contexts, workspaces, workspace groups, and FinOps data views. Trigger whenever there is a need to integrate, automate, or debug calls to the Pier Cloud platform via Python, Node.js, or cURL.

metadata.author

ft.ia.br

metadata.version

1.2

metadata.date

2026-09-21

metadata.repository

https://github.com/fabricioctelles/skills

metadata.license

Apache 2.0

metadata.keywords

pier, piercloud, lighthouse, api, finops, cloud, costs

metadata.category

library-and-api-reference

PIERCLOUD_CLIENT_ID=your_client_id
PIERCLOUD_CLIENT_SECRET=your_client_secret
PIERCLOUD_TENANCY_ID=your_tenancy_id

pip install requests python-dotenv

python scripts/pier-cloud-auth.py

© fabricioctelles, 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 15 other files (scripts, references) in skills/pier-cloud of fabricioctelles/skills.

• SKILL.md
• .env.example
• references/REFERENCE.md
• references/TROUBLESHOOTING.md
• scripts/README.md
• scripts/pier-cloud-auth.py
• scripts/pier-cloud-get-all-workspaces.py
• scripts/pier-cloud-get-view-data.py
• scripts/pier-cloud-get-view.py
• scripts/pier-cloud-get-workspace-group.py
• scripts/pier-cloud-get-workspace.py
• scripts/pier-cloud-list-contexts.py
• scripts/pier-cloud-list-views.py
• scripts/pier-cloud-list-workspace-groups.py
• scripts/pier-cloud-list-workspaces.py
• scripts/pier_cloud_client.py

Open the folder on GitHubat commit f1de632