К основному содержанию
скилл CX Codex

pier-cloud — скилл для Claude Code: API Pier Cloud и установка

Скилл для работы с API Pier Cloud (Lighthouse): JWT-авторизация, контексты, воркспейсы и данные FinOps через готовые Python-скрипты.

Apache-2.0 ★ 141 обновлён 2026-10-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add fabricioctelles/skills --skill pier-cloud -a claude-code
Открыть на GitHub

Что делает pier-cloud

Скилл даёт агенту карту API Pier Cloud (Lighthouse) для учёта облачных затрат. Внутри JWT-авторизация через POST /auth, перечисление контекстов, воркспейсов и групп воркспейсов, чтение вью FinOps вместе с фильтрами. Запросы идут на https://api.piercloud.io, токен живёт час, и в долгих сессиях его надо обновлять.

В комплекте готовые скрипты на Python: авторизация, список воркспейсов с пагинацией, детали воркспейса или вью, данные вью. Есть клиент pier_cloud_client.py с повторами и перевыпуском токена, справочник по эндпоинтам в references/REFERENCE.md и разбор ошибок в references/TROUBLESHOOTING.md.

Перед первым запуском нужен .env в каталоге скилла с PIERCLOUD_CLIENT_ID, PIERCLOUD_CLIENT_SECRET и PIERCLOUD_TENANCY_ID, плюс pip install requests python-dotenv. Без этого файла скилл останавливается и просит достать креды в Pier Cloud. Ещё одна мелочь: группы воркспейсов живут на /workspaces-groups, с множественным числом в середине пути.

Какие задачи решает

  • получить JWT-токен и обновить его до истечения часа
  • выгрузить все воркспейсы с автоматической пагинацией
  • посмотреть данные вью FinOps с фильтрами
  • найти группу воркспейсов по id
  • разобрать ответ 401 или 404 при запросе к API

Примеры запросов агенту

  • Авторизуйся в Pier Cloud и покажи список контекстов
  • Выгрузи все воркспейсы скриптом из скилла, с пагинацией
  • Получи данные вью для воркспейса с фильтрами по периоду

Как установить pier-cloud

1Через Skills CLI (Vercel)

npx skills add fabricioctelles/skills --skill pier-cloud -a claude-code

2Вручную: положить файлы

~/.claude/skills/pier-cloud/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/pier-cloud/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о pier-cloud

Как установить pier-cloud в Claude Code?

Выполните npx skills add fabricioctelles/skills --skill pier-cloud -a claude-code. Скилл появится по пути ~/.claude/skills/pier-cloud/SKILL.md.

Что делает pier-cloud?

Учит агента вызывать API Pier Cloud: получать токен, перечислять контексты, воркспейсы и их группы, забирать данные вью FinOps. Для типовых вызовов есть готовые скрипты.

Что нужно, чтобы скилл заработал?

Файл .env в каталоге скилла с PIERCLOUD_CLIENT_ID, PIERCLOUD_CLIENT_SECRET и PIERCLOUD_TENANCY_ID, а также пакеты requests и python-dotenv. Без .env скилл не продолжит работу.

Исходный текст

SKILL.md · Apache-2.0
---
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
  version: "1.2"
  date: 2026-09-21
  repository: https://github.com/fabricioctelles/skills
  license: Apache 2.0
  keywords: ["pier", "piercloud", "lighthouse", "api", "finops", "cloud", "costs"]
  category: library-and-api-reference
---

# Pier Cloud API

## Prerequisites

### Credentials

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

```env
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: `PIERCLOUD_TENANCY_ID` is equivalent to the former `PIERCLOUD_BUSINESS_ID`. Scripts accept both as fallback.

### Python Dependencies

```bash
pip install requests python-dotenv
```

## Basic Configuration

The API uses JWT authentication. Required flow:

1. Authenticate via `POST /auth` with `client_id` and `client_secret` 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`

> Workspace groups live at `/lighthouse/tenancies/{tenancy_id}/workspaces-groups` (note the plural *workspaces*).

Verify the connection by running:

```bash
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 |
| `pier-cloud-list-workspace-groups.py` | List workspace groups (`/workspaces-groups`) |
| `pier-cloud-get-workspace-group.py` | Get workspace group by id |
| `pier_cloud_client.py` | Robust client with CLI and reusable library |

## 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
- **Workflow 12** — List Workspace Groups (`/workspaces-groups`)
- **Workflow 13** — Get Workspace Group Details

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

- **API Docs**: https://docs.piercloud.com/api-docs-pier-cloud
- **Public routes (EN)**: https://docs.piercloud.com/api-docs-pier-cloud/api-pier-cloud/public-routes-en-us
- **Pier Cloud Platform**: https://piercloud.com/en/

## Quality Checklist

- [ ] `.env` file present with `PIERCLOUD_CLIENT_ID`, `PIERCLOUD_CLIENT_SECRET`, and `PIERCLOUD_TENANCY_ID`
- [ ] Python dependencies installed (`requests`, `python-dotenv`)
- [ ] Authentication successful (JWT token obtained without errors)
- [ ] Correct endpoint being used (`/lighthouse/tenancies/{tenancy_id}/...`; groups → `workspaces-groups`)
- [ ] Token being renewed before expiration in long sessions
- [ ] Workspace/view IDs confirmed via listing before using directly
- [ ] Errors handled per `references/TROUBLESHOOTING.md`

© ft.ia.br · Apache-2.0 · fabricioctelles/skills

Похожие скиллы

Все скиллы по теме «Облака: AWS, Azure, GCP» →
Cloud FinOps Skill & MCP OptimNow MCP-сервер Cloud FinOps Skill & MCP передаёт агенту базу знаний FinOps по оптимизации расходов в AWS, Azure, GCP и OCI. Пригодится при аудите облачных затрат и расчёте стоимости инференса ИИ. CX Codex +1 ★ 75звёзд репо cost-optimization Microsoft Скилл cost-optimization анализирует расходы в Azure, находит забытые диски или неиспользуемые IP и рассчитывает выгоду от Reservations. Помогает сократить счёт за облако. CX Codex +1 ★ 3 232звёзд репо CloudXray AI FinOps Directory cloudxrayai MCP-сервер CloudXray AI FinOps Directory ищет и сравнивает поставщиков FinOps и управления облачными расходами по каталогу CloudXray AI. Помогает составить список кандидатов и подобрать альтернативы. CX Codex +1 ★ 1звёзд репо huawei-cloud-billing-scout huaweicloud Скилл huawei-cloud-billing-scout для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Находит остатки на счёте, статьи расходов и расхождения в биллинге Huawei Cloud. CX Codex +1 18 500установок google-cloud-waf-cost-optimization официальный google Скилл google-cloud-waf-cost-optimization для Claude Code, Gemini CLI и Codex, который оценивает рабочие нагрузки Google Cloud по столпу Cost Optimization фреймворка Well-Architected. CX Codex +1 14 266установок cloud-expense-management qodex-ai Скилл cloud-expense-management анализирует расходы на AWS, рассчитывает смету до деплоя и отслеживает метрики в CloudWatch. Пригодится при контроле бюджета и поиске аномалий в счетах. CX Codex +1 134установок

Из того же набора46

Весь набор →
agent-ready-ard Скилл agent-ready-ard для Claude Code помогает опубликовать /.well-known/ai-catalog.json, чтобы агенты находили MCP-серверы, A2A-агентов, скиллы и API-инструменты. Задача — настроить обнаружение ресурсов проекта. CX Codex +1 ★ 141звёзд репо agent-ready-scan-site Скилл agent-ready-scan-site сканирует сайт и проверяет, готов ли он для работы с AI-агентами. Анализирует 23 стандарта по пяти категориям: видимость, доступность контента, управление ботами, API и коммерция. CX Codex +1 ★ 141звёзд репо ultimate-design-system-master Скилл ultimate-design-system-master для Claude Code пошагово создаёт дизайн-системы, токены, компоненты и документацию через 10 генераторов. Проводит от брифа до кода экранов. CX Codex +1 ★ 141звёзд репо substack-expert Скилл substack-expert помогает готовить Substack-публикации: выстраивает структуру, SEO-метаданные, вовлечение и путь от бесплатной подписки к платной. CX Codex +1 ★ 141звёзд репо geo-optimization Скилл geo-optimization оптимизирует контент сайтов под ответы нейросетей и цитирование в ChatGPT, Perplexity, Claude и Google AI Overview. CX Codex +1 ★ 141звёзд репо human-ai Скилл human-ai редактирует английский текст: убирает шаблонные обороты и сохраняет факты, смысл и голос автора. Подходит для правки черновиков и заметок. CX Codex +1 ★ 141звёзд репо design-md-validator Скилл design-md-validator проверяет DESIGN.md на соответствие спецификации Google через CLI-линтер @google/design.md. Находит битые ссылки на токены и считает контраст по WCAG. CX Codex +1 ★ 141звёзд репо humanizar Скилл humanizar редактирует и пишет тексты на бразильском португальском без штампов нейросетей, строго сохраняя факты автора. CX Codex +1 ★ 141звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой