SkillsAdd

fabricioctelles/skills

pier-cloud

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, and FinOps data views.

First seen May 2, 2026

Installation

$ npx skills add fabricioctelles/skills --skill pier-cloud
View on skills.sh ↗ GitHub repository ↗

Summary

  • 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, 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.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

agent-browser Same topic
vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

810.4K installs
azure-diagnostics Same topic
microsoft/azure-skills

Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe …

568.9K installs
azure-validate Same topic
microsoft/azure-skills

Pre-deployment validation for Azure readiness. Run deep checks on configuration, infrastructure…

567.7K installs
azure-aigateway Same topic
microsoft/azure-skills

Configure Azure API Management as an AI Gateway for AI models, MCP tools, and agents. WHEN: sem…

566.3K installs
azure-compute Same topic
microsoft/azure-skills

Azure VM/VMSS router. WHEN: create / provision / deploy / spin-up VM, recommend VM size, compar…

510K installs
supabase-postgres-best-practices Same topic
supabase/agent-skills

Postgres best practices maintained by Supabase, for Postgres running anywhere. Load this skill …

391.6K installs

Also in this package

Other skills from fabricioctelles/skills · top by installs.

npx skills add fabricioctelles/skills
okf-open-knowledge-format 281 humanizar 98 design-md-validator 90 ultimate-design-system-master 79 geo-optimization 62 revenue-centric-design 62 coolify-operator 61 resume-ats-beater 61 substack-expert 59 startup-idea 56

Browse all from fabricioctelles/skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 74
License LICENSE
Default branch main
Open issues 1
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version1.1
LicenseApache 2.0
More metadata
author
ft.ia.br
version
1.1
date
2026-03-05
repository
https://github.com/fabricioctelles/skills
license
Apache 2.0
keywords
["pier","piercloud","lighthouse","api","finops","cloud","costs"]
category
library-and-api-reference

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 4,057 B
  • docs SUMMARY.md 348 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 52 installs

SKILL.md

Pier Cloud API

Prerequisites

Credentials

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

PIERCLOUD_CLIENT_ID=your_client_id
PIERCLOUD_CLIENT_SECRET=your_client_secret
PIERCLOUD_TENANCY_ID=your_tenancy_id

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

Note: PIERCLOUDTENANCYID is equivalent to the former PIERCLOUDBUSINESSID. Scripts accept both as fallback.

Python Dependencies

pip install requests python-dotenv

Basic Configuration

The API uses JWT authentication. Required flow:

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

Base URL: https://api.piercloud.io

Verify the connection by running:

python scripts/pier-cloud-auth.py

Available Scripts

Ready-to-use scripts in scripts/. See scripts/README.md for detailed instructions.

Script Description
pier-cloud-auth.py Authenticate and obtain JWT token
pier-cloud-list-contexts.py List available contexts
pier-cloud-list-workspaces.py List workspaces with pagination
pier-cloud-get-workspace.py Get specific workspace details
pier-cloud-get-all-workspaces.py Get all workspaces (automatic pagination)
pier-cloud-list-views.py List views for a workspace
pier-cloud-get-view.py Get specific view information
pier-cloud-get-view-data.py Get view data with filters
piercloudclient.py Robust client with CLI and reusable library

Note: Workspace-groups scripts (pier-cloud-list-workspace-groups.py, pier-cloud-get-workspace-group.py) do not work — the corresponding endpoints do not exist in the current API.

Workflows

Follow the detailed workflows with request and response examples in references/REFERENCE.md:

  • Workflow 1 — Authentication and Token Retrieval
  • Workflow 2 — List Contexts
  • Workflow 3 — List Workspaces
  • Workflow 4 — Get Workspace Details
  • Workflow 5 — Get All Workspaces (Automatic Pagination)
  • Workflow 6 — Robust Client with Retry and Token Renewal
  • Workflow 9 — List Workspace Views
  • Workflow 10 — Get View Information
  • Workflow 11 — Get View Data with Filters

For endpoint reference, parameters, response structures, and cURL examples, see references/REFERENCE.md.

For error diagnosis (401, 403, 404, timeout, rate limiting), see references/TROUBLESHOOTING.md.

Additional Resources

Quality Checklist

  • .env file present with PIERCLOUDCLIENTID, PIERCLOUDCLIENTSECRET, and PIERCLOUDTENANCYID
  • Python dependencies installed (requests, python-dotenv)
  • Authentication successful (JWT token obtained without errors)
  • Correct endpoint being used (default /lighthouse/tenancies/{tenancy_id}/...)
  • Token being renewed before expiration in long sessions
  • Workspace/view IDs confirmed via listing before using directly
  • Errors handled per references/TROUBLESHOOTING.md